====== Anhang: Plugins ====== [[..:start|Übersicht]] > **Anhang: Plugins** Plugins erweitern Neutrino um Spiele, Werkzeuge, Skripte, Lua- und Python-Programme. Jedes Plugin besteht aus einer **Konfigurationsdatei** ''.cfg'' und der eigentlichen **Plugin-Datei** mit gleichem Namen. ===== Suchpfade ===== Neutrino sucht beim Start (und bei [[..:service:start|Service > Plugins neu laden]]) in dieser Reihenfolge nach ''.cfg''-Dateien: 1. /var/tuxbox/games/ Spiele 2. aus "Plugins verwalten" 3. /mnt/plugins/ 4. /var/tuxbox/plugins/ eigene Plugins (beschreibbar) 5. /share/tuxbox/neutrino/plugins/ mitgelieferte Plugins Gibt es ein Plugin gleichen Namens mehrfach, gilt der zuerst gefundene Eintrag. So kann eine ''.cfg'' in ''/var/tuxbox/plugins/'' die Einstellungen eines mitgelieferten Plugins überschreiben, ohne die Plugin-Datei zu kopieren – z. B. mit ''type=0'', um ein Plugin aus dem schreibgeschützten Image zu deaktivieren. ===== Die .cfg-Datei ===== Einfaches Format ''schlüssel=wert'', eine Zeile pro Eintrag: type=4 integration=0 name=Mediathek name.english=Media library desc=ARD- und ZDF-Mediathek desc.english=Public broadcaster media library key=blue index=10 hinticon=mediathek_hint menu_return=repaint ^ Schlüssel ^ Bedeutung ^ | ''type'' | Plugin-Typ (siehe unten); bestimmt auch die Dateiendung. **Pflicht.** | | ''integration'' | In welches Menü sich das Plugin zusätzlich einhängt (siehe unten). Vorgabe 0. | | ''name'' | Anzeigename. | | ''name.'' | Anzeigename für eine bestimmte Menüsprache, z. B. ''name.english''. Hat Vorrang vor ''name''. | | ''desc'' / ''desc.'' | Beschreibung; erscheint als Hinweis in Plugin-Listen. | | ''key'' | Feste Direkttaste im eingehängten Menü: ''red'', ''green'', ''yellow'', ''blue'' oder ''auto'' (nächste freie Ziffer). | | ''index'' | Sortierposition. | | ''hinticon'' | Bild für das Hinweisfenster (ohne Endung, ''.png'' oder ''.svg''). Ohne Angabe wird ''_hint.png/.svg'' im Plugin-Verzeichnis verwendet, falls vorhanden. | | ''hide'' | 1 = in den Plugin-Listen ausblenden (auch über [[..:settings:extended#plugins_verwalten|Plugins verwalten]] einstellbar). | | ''shellwindow'' | Nur Skripte: 1 = Ausgabe des Skripts in einem Fenster anzeigen und mit Bestätigung schließen. | | ''menu_return'' | Verhalten nach dem Beenden: ''repaint'' (Menü neu zeichnen, Vorgabe), ''none'', ''exit'' (eine Ebene zurück), ''exit_all'' (alle Menüs schließen). | | ''depend'' | Abhängigkeit (Bibliothek o. ä.), die vorhanden sein muss. | | ''needenigma'' | Altlast; 1 = Plugin wird abgelehnt. | ===== Plugin-Typen (type) ===== ^ Wert ^ Typ ^ Plugin-Datei ^ Erscheint in ^ | 0 | deaktiviert | – | – | | 1 | Spiel | ''.so'' | [[..:plugins|Spiele]] | | 2 | Werkzeug | ''.so'' | Hauptmenü „Plugins“, Benutzermenü „Werkzeuge“ | | 3 | Skript | ''.sh'' | Hauptmenü „Plugins“, Benutzermenü „Skripte“ | | 4 | Lua | ''.lua'' | Hauptmenü „[[..:plugins|Plugins]]“, Benutzermenü „Plugins“ | | 5 | Python | ''.py'' | [[..:plugins|Python-Plugins]] | Skripte werden bei fehlender Ausführungsberechtigung automatisch auf ''chmod 755'' gesetzt. ===== Integration (integration) ===== ^ Wert ^ Menü ^ | 0 | keines (nur in den Plugin-Listen / Benutzermenüs) | | 1 | [[..:main_menu|Hauptmenü]] | | 2 | [[..:multimedia|Multimedia]] | | 3 | [[..:settings:start|Einstellungen]] | | 4 | [[..:service:start|Service]] | | 5 | [[..:information|Information]] | | 6 | [[..:service:software_update|Software-Aktualisierung]] | | 7 | [[..:power_off|Ausschalten]] | | 8 | [[..:settings:network|Netzwerk]] | Beispiel: Skript im Servicemenü, Ausgabe im Fenster /var/tuxbox/plugins/hdd_check.cfg /var/tuxbox/plugins/hdd_check.sh +-------------------------------+ +------------------------------+ | type=3 | | #!/bin/sh | | integration=4 | | df -h /media/hdd | | name=Festplatte prüfen | | smartctl -H /dev/sda | | desc=Belegung und SMART-Status| +------------------------------+ | shellwindow=1 | +-------------------------------+ | v Service > ... > (Ziffer) Festplatte prüfen -> Fenster mit Skriptausgabe Wo Plugins im Alltag auftauchen, beschreiben [[..:plugins|Spiele, Plugins, Python-Plugins]] und [[..:live:user_menu_functions#plugins|Benutzermenü-Funktionen > Plugins]].