Plugin Installation

Da die Plugin Schnittstelle von Klaus Schmidinger "standardisiert" wurde, ist auch die Installation in den Grundzügen immer gleich. Auf Besonderheiten wird auf den jeweiligen Plugin-Seiten eingegangen. Letzte Instanz ist aber immer das README-file des Plugins.

Kopieren

Zunächst wird der Archiv des Plugins ins PLUGINS/src Verzeichnis des VDR kopiert

cp vdr-name-x.y.z.tar.bz2 /home/user/vdr/VDR/PLUGINS/src

danach in den Pfad wechsel in welchen entpackt wurde

cd /home/user/vdr/VDR/PLUGINS/src

Auspacken

Abhängig davon, ob das Archiv mit BZIP2 (*.bz2) oder mit GZIP (*.tgz, *.tar.gz) gepackt wurde lautet der Befehl zu entpacken

tar -jxvf vdr-name-x.y.z.tar.bz2

oder

tar -zxvf vdr-name-x.y.z.tgz

Link setzen

Nun noch einen symbolischen Link auf das gerade entpackte Verzeichnis anlegen. Die Versionsnummer wird dabei nicht angegeben.

ln -s name-x.y.z name

README lesen

Optional ist es nun angesagt die README-Datei des Plugins zu lesen. Der Aufruf kann schon direkt über den Link erfolgen.

less name/README

Kompilieren

Die Plugins liegen nach dem Auspacken als Source auf der Festplatte. Für die Verwendung im VDR müssen die Quelldaten jedoch Kompiliert werden (überführen in einen Maschinell lesbaren Birärcode siehe http://de.wikipedia.org/wiki/Compiler).

Zum Compiler-Aufruf in das zwei Ebenen höher liegende Verzeichnis wechseln:

cd /home/user/vdr/VDR

und den Compiler über den make-File des VDR aufrufen.

make plugins

libs Updaten

und wenn's keine Fehler beim Compiler-Lauf gab werden die libs aktualisiert:

./upd

Das Script upd kopiert die uebersetzten Libraries an die Stelle von welcher sie durch den VDR ausgefuehrt werden können.

Plugin anmelden

Dann musst dem vdr noch mitgeteit werden, dass er das Plugin laden soll. Dazu wird die Datei /_config/vdr/plugins/plugin_setup.conf um eine Zeile erweitert.

... schnipp ... 
 0:name:Beschreibung: 
... schnapp ...

Plugin aktivieren

VDR neu starten un über das Menü Menu->Einstellungen->Plugins->PluginSetup das neue Plugin aktivieren.

Hinweise

folgend Informationen sollten berücksichtigt werden.

Pfade

Die Beschreibung hier geht davon aus, dass sich die Plugin Autoren an das vorgegebene Namensschema halten. Leider ist dies nicht immer der Fall.

Damit VDR das Plugin kompiliert darf das Verzeichnis der Plugins, oder der Link dorthin nur den Name enthalten, kein "vdr-...", "plugin-..." oder gar die Versionsnummer dabei (Achtung: 'vdrcd' ist richtig, 'vdr-cd' nicht).

Man kann sich einfach an den mit VDR mitgelieferten Plugins orientieren.