Plugin Installation
Monroe (Diskussion | Beiträge) K (link) |
Watz (Diskussion | Beiträge) |
||
| Zeile 1: | Zeile 1: | ||
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 [[Plugins|Plugin]]-Seiten eingegangen. Letzte Instanz ist aber immer das README-file des Plugins. | 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 [[Plugins|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 | 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 | + | '''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 | 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 | + | '''tar -jxvf vdr-name-x.y.z.tar.bz2''' |
| − | oder | + | oder |
| − | tar -zxvf vdr-name-x.y.z.tgz | + | '''tar -zxvf vdr-name-x.y.z.tgz''' |
| − | Nun noch einen symbolischen Link auf das gerade entpackte Verzeichnis anlegen | + | ==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 | + | '''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. | ||
| + | ===Distributionen=== | ||
| + | Endsprechend der verwendeten LinuX-Distribution gibt es auch andere Installationsmöglichkeiten. | ||
| + | Bei einer Standard-[[Gentoo]]-Distribution können z.B. die Plugins über das [[emerge]]-Kommando nahezu automatisch hinzugefügt werden. | ||
Version vom 12. Juli 2004, 11:25 Uhr
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.
Inhaltsverzeichnis |
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.
Distributionen
Endsprechend der verwendeten LinuX-Distribution gibt es auch andere Installationsmöglichkeiten. Bei einer Standard-Gentoo-Distribution können z.B. die Plugins über das emerge-Kommando nahezu automatisch hinzugefügt werden.
