Plugin Installation

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Gelöscht, sie Diskussion)
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==
+
== Vorbereitung ==
Zunächst wird der Archiv des Plugins ins ''PLUGINS/src'' Verzeichnis des [[VDR]] kopiert
+
Nachdem man sich das Plugin-Archiv aus dem Internet heruntergeladen hat wechselt man in das ''PLUGINS/src'' Verzeichnis von [[VDR]] und entpackt das Archiv
  
  '''cp vdr-name-x.y.z.tar.bz2 /home/user/vdr/VDR/PLUGINS/src'''
+
  cd /home/user/vdr/VDR/PLUGINS/src
 +
tar -jxvf /path/to/vdr-name-x.y.z.tar.bz2
  
danach in den Pfad wechsel in welchen entpackt wurde
+
bei einem BZIP2-Archiv (*.bz2) oder
  
  '''cd /home/user/vdr/VDR/PLUGINS/src'''
+
  tar -zxvf /path/to/vdr-name-x.y.z.tgz
  
==Auspacken==
+
bei einem GZIP-Archiv (*.tgz, *.tar.gz).
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'''
+
Nun noch einen symbolischen Link auf das gerade entpackte Verzeichnis anlegen. Die Versionsnummer wird dabei nicht angegeben
  
  oder
+
  ln -s name-x.y.z name
  
'''tar -zxvf vdr-name-x.y.z.tgz'''
+
{| width=75%
 +
| style="background-color:#ffeaa5; border:solid 1px #ffeaa5; font-weight:bold; text-align:center;"|
 +
Hinweis
 +
|-
 +
| style="background-color:#ffffee; border:solid 1px #ffeaa5; padding:1em; font-size:75%;"|
 +
Die Beschreibung hier geht davon aus, dass sich die Plugin Autoren an das vorgegebene Namensschema halten. Leider ist dies nicht immer der Fall.
  
==Link setzen==
+
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).
Nun noch einen symbolischen Link auf das gerade entpackte Verzeichnis anlegen. Die Versionsnummer wird dabei nicht angegeben.  
+
  
'''ln -s name-x.y.z name'''
+
Man kann sich einfach an den mit VDR mitgelieferten Plugins orientieren.
 +
|}
  
==README lesen==  
+
== Kompilieren ==
Optional ist es nun angesagt die README-Datei des Plugins zu lesen. Der Aufruf kann schon direkt über den Link erfolgen.  
+
Die Plugins liegen nach dem Auspacken als [[Quelltext]] auf der Festplatte. Für die Verwendung im VDR müssen die Quelldaten jedoch kompiliert werden (überführen in einen maschinell lesbaren Binärcode siehe http://de.wikipedia.org/wiki/Compiler).
  
'''less name/README'''
+
Zum Compiler-Aufruf in das zwei Ebenen höher liegende VDR-Verzeichnis wechseln und den Kompiliervorgang über das make-Programm des VDR aufrufen
  
==Kompilieren==
+
cd ../..
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).   
+
  make plugins
  
Zum Compiler-Aufruf in das zwei Ebenen höher liegende Verzeichnis wechseln:
+
== Installation ==
'''cd /home/user/vdr/VDR'''
+
Nachdem der Compiler-Lauf fehlerfrei durchgelaufen ist, müssen die entstandenen [[Library|Bibliotheken]] ins Zielverzeichnis kopiert werden
  
und den Compiler über den make-File des VDR aufrufen.  
+
  cp PLUGINS/lib/* /usr/lib/vdr
  
'''make plugins'''
+
Dieses Verzeichnis kann natürlich je nach System variieren.
==libs Updaten==
+
Später beim Aufruf von VDR wird diesem das Verzeichnis mittels '--lib=<DIR>' bekannt gemacht.
 
+
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.
+

Version vom 15. Juli 2004, 00:10 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.

Vorbereitung

Nachdem man sich das Plugin-Archiv aus dem Internet heruntergeladen hat wechselt man in das PLUGINS/src Verzeichnis von VDR und entpackt das Archiv

cd /home/user/vdr/VDR/PLUGINS/src
tar -jxvf /path/to/vdr-name-x.y.z.tar.bz2

bei einem BZIP2-Archiv (*.bz2) oder

tar -zxvf /path/to/vdr-name-x.y.z.tgz

bei einem GZIP-Archiv (*.tgz, *.tar.gz).

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

ln -s name-x.y.z name

Hinweis

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.

Kompilieren

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

Zum Compiler-Aufruf in das zwei Ebenen höher liegende VDR-Verzeichnis wechseln und den Kompiliervorgang über das make-Programm des VDR aufrufen

cd ../..
make plugins

Installation

Nachdem der Compiler-Lauf fehlerfrei durchgelaufen ist, müssen die entstandenen Bibliotheken ins Zielverzeichnis kopiert werden

cp PLUGINS/lib/* /usr/lib/vdr

Dieses Verzeichnis kann natürlich je nach System variieren. Später beim Aufruf von VDR wird diesem das Verzeichnis mittels '--lib=<DIR>' bekannt gemacht.