Inhaltsverzeichnis

Anhang: Plugins

Ü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.

Suchpfade

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.

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.<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.

Plugin-Typen (type)

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.

Integration (integration)

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.