Plugin installation

De VDR Wiki FR
Aller à la navigationAller à la recherche

Les instructions pour l'installation de tous les plugins sont toujours les mêmes. Pour les spécificités, regardez la description de ce plugin. Mais la meilleure information est toujours celle du fichier README du plugin.

Installation

Warning
Attention

La variable $SOURCEDIR est le répertoire où toutes les archives sources doivent être décompressées. Habituellement les répertoires utilisés sont /usr/local/src, /usr/src et le répertoire home de l'utilisateur.

La variable $PLUGIN_NAME est le nom du plugin qui doit être installé.



Apres avoir téléchargé les sources du plugin d'Internet, déplacez-les vers le répertoire PLUGINS/src du dossier VDR

cd $SOURCEDIR/vdr/PLUGINS/src

et décompressez l'archive.

Si c'est une archive BZIP2 (*.tar.bz2), utilisez

tar -jxvf /path/to/vdr-$PLUGIN_NAME-<VERSION>.tar.bz2

Si c'est une archive GZIP (*.tgz, *.tar.gz), utilisez

tar -zxvf /path/to/vdr-$PLUGIN_NAME-<VERSION>.{tgz,tar.gz}

Pour finir, créez un lien symbolique avec le nom du plugin sans son numéro de version.

ln -s $PLUGIN_NAME-<VERSION> $PLUGIN_NAME
Warning
Attention

Ces instructions supposent que l'auteur du plugin respecte les règles de nommage des plugins VDR. Malheureusement, ce n'est pas toujours le cas.

VDR ne compile que les plugins avec des répertoires sans numéro de version et préfixes tels que vdr- ou plugin-. (Attention: vdrcd est correct, mais pas vdr-cd).



Changez pour le répertoire racine de VDR et compilez les plugins

cd ../..
make plugins

Après que tout ce soit compilé sans erreur, copiez les plugins vers leur répertoire cible

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

Pour les développeurs

Un extrait du ../VDR/PLUGINS.html

Building the distribution package

If you want to make your plugin available to other VDR users, you'll need to make a package that can be easily distributed. The Makefile that has been created by the call to newplugin provides the target dist, which does this for you.

Simply change into your source directory and execute make dist:

cd VDR/PLUGINS/src/hello
make dist

After this you should find a file named like

vdr-hello-0.0.1.tgz

in your source directory, where hello will be replaced with your actual plugin's name, and 0.0.1 will be your plugin's current version number.