Übersicht > Anhang: Plugins
Plugins erweitern Neutrino um Spiele, Werkzeuge, Skripte, Lua- und
Python-Programme. Jedes Plugin besteht aus einer Konfigurationsdatei
<name>.cfg und der eigentlichen Plugin-Datei mit gleichem Namen.
Neutrino sucht beim Start (und bei
Service > Plugins neu laden) in dieser Reihenfolge nach
.cfg-Dateien:
1. /var/tuxbox/games/ Spiele 2. <Externes Plugin-Verzeichnis> 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.
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.<sprache> | Anzeigename für eine bestimmte Menüsprache, z. B. name.english. Hat Vorrang vor name. |
desc / desc.<sprache> | 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 <name>_hint.png/.svg im Plugin-Verzeichnis verwendet, falls vorhanden. |
hide | 1 = in den Plugin-Listen ausblenden (auch über 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. |
| Wert | Typ | Plugin-Datei | Erscheint in |
|---|---|---|---|
| 0 | deaktiviert | – | – |
| 1 | Spiel | <name>.so | Spiele |
| 2 | Werkzeug | <name>.so | Hauptmenü „Plugins“, Benutzermenü „Werkzeuge“ |
| 3 | Skript | <name>.sh | Hauptmenü „Plugins“, Benutzermenü „Skripte“ |
| 4 | Lua | <name>.lua | Hauptmenü „Plugins“, Benutzermenü „Plugins“ |
| 5 | Python | <name>.py | Python-Plugins |
Skripte werden bei fehlender Ausführungsberechtigung automatisch auf
chmod 755 gesetzt.
| Wert | Menü |
|---|---|
| 0 | keines (nur in den Plugin-Listen / Benutzermenüs) |
| 1 | Hauptmenü |
| 2 | Multimedia |
| 3 | Einstellungen |
| 4 | Service |
| 5 | Information |
| 6 | Software-Aktualisierung |
| 7 | Ausschalten |
| 8 | 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 Spiele, Plugins, Python-Plugins und Benutzermenü-Funktionen > Plugins.