Muggle-plugin
Aus VDR Wiki
(Unterschied zwischen Versionen)
Wirbel (Diskussion | Beiträge) (→Status) |
|||
| (53 dazwischenliegende Versionen von 28 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
==Beschreibung== | ==Beschreibung== | ||
| − | ''' | + | '''Autoren:''' Andi Kellner, Lars von Wedel, Ralf Klueber, Wolfgang Rohdewald |
| − | Das Plugin bietet eine Datenbankverbindung für den VDR, so dass die Medienauswahl flexibler wird. | + | Das Plugin bietet eine Datenbankverbindung für den VDR, so dass die Medienauswahl flexibler wird. Es stehen verschiedene Datenbanken zur Verfügung. |
| − | [[Bild:muggle-plugin.jpg|thumb|none|'' | + | ===Status=== |
| + | Letztes Update 01/2009 | ||
| + | |||
| + | ==Bilder== | ||
| + | [[Bild:muggle-plugin.jpg|thumb|none|''Einstellungen'']] | ||
| − | |||
==Softwareanforderungen== | ==Softwareanforderungen== | ||
| − | * mySQL | + | Welche Datenbank verwendet wird, muss man beim Kompilieren festlegen. Es gibt Backends für MySql Server, MySql Embedded, Postgresql und sqlite3. Details siehe README.mysql, README.postgresql, README.sqlite. |
| + | * mySQL oder sqlite oder postgresql | ||
* libid3tag | * libid3tag | ||
* libmad | * libmad | ||
* taglib | * taglib | ||
| − | * libvorbis >= libogg | + | * libvorbis >= libogg (optional) |
| − | * flac >= libogg >= nasm | + | * flac >= libogg >= nasm (optional) |
==Installation== | ==Installation== | ||
| − | + | ===Optionen beim Kompilieren === | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | | bgcolor=#efefef | HAVE_VORBISFILE=1 | |
| − | . | + | | verwende libvorbis und libvorbisfile für die Wiedergabe von OGG Vorbis Dateien |
| − | + | |- | |
| − | + | | bgcolor=#efefef | HAVE_FLAC=1 | |
| − | + | | verwende libFLAC++ für die Wiedergabe von FLAC Dateien | |
| + | |- | ||
| + | | bgcolor=#efefef | HAVE_SNDFILE=1 | ||
| + | | verwende libsndfile für die Wiedergabe von .wav Dateien | ||
| + | |- | ||
| + | | bgcolor=#efefef | HAVE_ONLY_SERVER=1 | ||
| + | | Macht nur für MySql Sinn: Keine Unterstützung für MySql Embedded. | ||
| + | |- | ||
| + | | bgcolor=#efefef | HAVE_SQLITE=1 | ||
| + | | Als Datenbank wird SQLite 3 verwendet. | ||
| + | |- | ||
| + | | bgcolor=#efefef | HAVE_MYSQL=1 | ||
| + | | Als Datenbank wird MySql verwendet. | ||
| + | |- | ||
| + | | bgcolor=#efefef | HAVE_PG=1 | ||
| + | | Als Datenbank wird PostGresql verwendet. | ||
| + | |- | ||
| + | | bgcolor=#efefef | MUSICDIR=/mnt/music | ||
| + | | Dies ist die Vorgabe für Option -t - dies gilt also, wenn man -t nicht übergibt. | ||
| + | |} | ||
| − | + | ===Source=== | |
| − | + | Nach der erfolgten Installation von mysql folgen noch ein paar weitere für ''muggle'' wichtige Installationsschritte. | |
| − | . | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | cd /usr/local/lib | |
| − | + | ln -s mysql/libmysqlclient.so* . | |
| − | . | + | groupadd mysql |
| − | + | useradd -g mysql mysql | |
| − | + | cd .. | |
| − | + | chown -R mysql var | |
| + | ldconfig | ||
| + | mysql_install_db --user=mysql & | ||
| − | + | Die Installation des Plugins erfolgt an der allbekannten Stelle '''$SOURCEDIR/VDR/PLUGINS/src''' vor: | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | tar xvzf | + | cd $SOURCEDIR/VDR/PLUGINS/src |
| − | + | tar xvzf vdr-muggle-<VERSION>.tgz | |
| − | + | ln -s muggle-<VERSION> muggle | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Kopieren von mugglei in den '''PATH'''. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | cp $SOURCEDIR/VDR/PLUGINS/src/muggle/mugglei /usr/local/bin | |
| − | + | ===mysql-Datenbank befüllen=== | |
| − | + | Als erstes starten wir den mysql-Server mit. | |
| − | + | ||
| − | + | ||
| − | . | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | mysqld_safe --user=mysql & | |
| − | + | Nun können wir die Datenbank ''füttern''. Dazu starten wir den vdr, gehen in den Setup vom muggle - Plugin und wählen den Befehl "Datenbank synchronisieren". | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Normalerweise ist das aber nicht nötig - wenn muggle die Datenbank nicht findet, fragt er, ob er sie anlegen und automatisch füttern soll. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
Übergabe für VDR. | Übergabe für VDR. | ||
| − | + | vdr -P'muggle -t /mp3' | |
| − | vdr -P'muggle | + | |
| − | + | ||
| − | Für das automatische Starten des Mysql Daemons | + | Für das automatische Starten des Mysql Daemons... |
Unterhalb von '''../support-files''' im Sourceverzeichnis, befinden sich Templates. | Unterhalb von '''../support-files''' im Sourceverzeichnis, befinden sich Templates. | ||
| Zeile 153: | Zeile 89: | ||
Ein Eintrag in der '''/etc/init.d/boot.local''' (falls vorhanden) sollte auch langen. | Ein Eintrag in der '''/etc/init.d/boot.local''' (falls vorhanden) sollte auch langen. | ||
| − | + | # starting mysqld daemon | |
| − | # starting mysqld daemon | + | /usr/local/bin/mysqld_safe --user=mysql & |
| − | /usr/local/bin/mysqld_safe --user=mysql & | + | |
| − | + | ||
| − | + | ==Konfiguration== | |
| − | + | ===Parameter=== | |
| − | + | ====Plugin==== | |
| − | + | {| class="wikitable" | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | == | + | |
| − | === | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | == | + | |
| − | {| | + | |
|- | |- | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
!Parameter (kurz) | !Parameter (kurz) | ||
!Parameter (lang) | !Parameter (lang) | ||
| Zeile 207: | Zeile 115: | ||
| -t TTTT || --toplevel=TTTT || specify toplevel directory for music (default is /mnt/music) | | -t TTTT || --toplevel=TTTT || specify toplevel directory for music (default is /mnt/music) | ||
|- | |- | ||
| − | | - | + | | -d DIRN || --datadir=DIRN || specify directory for embedded sql data (default is $HOME/.muggle) |
| + | |- | ||
| + | | -v || --verbose || specify debug level. The higher the more (default is 1) | ||
|} | |} | ||
| − | ===Mugglei=== | + | ====Mugglei==== |
| − | {| | + | Je nach dem, welche Datenbank verwendet wird, stehen manche Optionen nicht zur Verfügung. |
| − | |- | + | |
| − | !Parameter | + | {| class="wikitable" |
| + | |- | ||
| + | !Parameter | ||
| + | !Lange Form | ||
!Beschreibung | !Beschreibung | ||
|- | |- | ||
| − | |-h <hostname> | + | | -h <hostname> || --name=<hostname> || Rechnername vom Datanbankserver (Vorgabe 'localhost') |
|- | |- | ||
| − | | - | + | | -p <port> || --port=<port> || Port vom Datenbankserver (Vorgabe datanbankspezifisch) |
|- | |- | ||
| − | | - | + | | -s <socket> || --socket=<socket> || Socket zur Datenbank (Vorgabe datenbankspezifisch, bei MySql ist es TCP) |
|- | |- | ||
| − | | - | + | | -n <database> || --name=<database> || Name der Datenbank (Vorgabe 'GiantDisc') |
|- | |- | ||
| − | | - | + | | -u <username> || --user=<username> || Benutzername für Datenbank (Vorgabe: leer) |
|- | |- | ||
| − | | - | + | | -w <password> || --password=<password> || Passwort für Datenbank (Vorgabe: leer) |
|- | |- | ||
| − | | - | + | | -t <topleveldir> || --toplevel=<topleveldir> || Name des Musikverzeichnisses (Vorgabe ist /mnt/music respektive der beim Kompilieren angegebene Wert) |
|- | |- | ||
| − | | -z || | + | | -z || --delete || lösche alle Einträge in der Datenbank, deren Musikdateien fehlen |
| − | | | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|- | |- | ||
| − | | | + | | -c || --create || lösche die ganze Datenbank und generiere sie neu |
| − | | | + | |
| − | | | + | |
|- | |- | ||
| − | | | + | | -v || --verbose || Gesprächigkeit, je höher, desto mehr. Default ist 1. |
| − | | | + | |
| − | + | ||
|- | |- | ||
| − | | | + | | -d <dirname> || --datadir=<dirname> || Hier wird die Datenbank angelegt, wenn eine "embedded" Datenbank verwendet wird (sqlite3 oder je nach Konfiguration MySql) (Vorgabe: "$HOME/.muggle") |
| − | | | + | |} |
| − | | | + | |
| − | + | ==Entwicklerversion== | |
| − | + | git clone git://projects.vdr-developer.org/vdr-plugin-muggle.git | |
| − | + | ||
| − | + | ==Aktuelle Version== | |
| − | + | [http://projects.vdr-developer.org/attachments/download/53/vdr-muggle-0.2.3.tgz 0.2.3] | |
| − | + | ||
| − | + | ==Links== | |
| − | + | # [http://projects.vdr-developer.org/projects/show/plg-muggle Homepage des Plugins] | |
| − | + | ||
| − | + | [[Kategorie:Plugins]] | |
| − | + | {{i18n|muggle-plugin}} | |
| − | + | ||
| − | + | ||
Aktuelle Version vom 18. August 2013, 12:36 Uhr
Inhaltsverzeichnis |
[Bearbeiten] Beschreibung
Autoren: Andi Kellner, Lars von Wedel, Ralf Klueber, Wolfgang Rohdewald
Das Plugin bietet eine Datenbankverbindung für den VDR, so dass die Medienauswahl flexibler wird. Es stehen verschiedene Datenbanken zur Verfügung.
[Bearbeiten] Status
Letztes Update 01/2009
[Bearbeiten] Bilder
[Bearbeiten] Softwareanforderungen
Welche Datenbank verwendet wird, muss man beim Kompilieren festlegen. Es gibt Backends für MySql Server, MySql Embedded, Postgresql und sqlite3. Details siehe README.mysql, README.postgresql, README.sqlite.
- mySQL oder sqlite oder postgresql
- libid3tag
- libmad
- taglib
- libvorbis >= libogg (optional)
- flac >= libogg >= nasm (optional)
[Bearbeiten] Installation
[Bearbeiten] Optionen beim Kompilieren
| HAVE_VORBISFILE=1 | verwende libvorbis und libvorbisfile für die Wiedergabe von OGG Vorbis Dateien |
| HAVE_FLAC=1 | verwende libFLAC++ für die Wiedergabe von FLAC Dateien |
| HAVE_SNDFILE=1 | verwende libsndfile für die Wiedergabe von .wav Dateien |
| HAVE_ONLY_SERVER=1 | Macht nur für MySql Sinn: Keine Unterstützung für MySql Embedded. |
| HAVE_SQLITE=1 | Als Datenbank wird SQLite 3 verwendet. |
| HAVE_MYSQL=1 | Als Datenbank wird MySql verwendet. |
| HAVE_PG=1 | Als Datenbank wird PostGresql verwendet. |
| MUSICDIR=/mnt/music | Dies ist die Vorgabe für Option -t - dies gilt also, wenn man -t nicht übergibt. |
[Bearbeiten] Source
Nach der erfolgten Installation von mysql folgen noch ein paar weitere für muggle wichtige Installationsschritte.
cd /usr/local/lib ln -s mysql/libmysqlclient.so* . groupadd mysql useradd -g mysql mysql cd .. chown -R mysql var ldconfig mysql_install_db --user=mysql &
Die Installation des Plugins erfolgt an der allbekannten Stelle $SOURCEDIR/VDR/PLUGINS/src vor:
cd $SOURCEDIR/VDR/PLUGINS/src tar xvzf vdr-muggle-<VERSION>.tgz ln -s muggle-<VERSION> muggle
Kopieren von mugglei in den PATH.
cp $SOURCEDIR/VDR/PLUGINS/src/muggle/mugglei /usr/local/bin
[Bearbeiten] mysql-Datenbank befüllen
Als erstes starten wir den mysql-Server mit.
mysqld_safe --user=mysql &
Nun können wir die Datenbank füttern. Dazu starten wir den vdr, gehen in den Setup vom muggle - Plugin und wählen den Befehl "Datenbank synchronisieren".
Normalerweise ist das aber nicht nötig - wenn muggle die Datenbank nicht findet, fragt er, ob er sie anlegen und automatisch füttern soll.
Übergabe für VDR.
vdr -P'muggle -t /mp3'
Für das automatische Starten des Mysql Daemons...
Unterhalb von ../support-files im Sourceverzeichnis, befinden sich Templates.
Ein Eintrag in der /etc/init.d/boot.local (falls vorhanden) sollte auch langen.
# starting mysqld daemon /usr/local/bin/mysqld_safe --user=mysql &
[Bearbeiten] Konfiguration
[Bearbeiten] Parameter
[Bearbeiten] Plugin
| Parameter (kurz) | Parameter (lang) | Beschreibung |
|---|---|---|
| -h HHHH | --host=HHHH | specify database host (default is localhost) |
| -s SSSS | --socket=PATH | specify database socket (default is TCP connection) |
| -n NNNN | --name=NNNN | specify database name (overridden by -g) |
| -p PPPP | --port=PPPP | specify port of database server (default is ) |
| -u UUUU | --user=UUUU | specify database user (default is ) |
| -w WWWW | --password=WWWW | specify database password (default is empty) |
| -t TTTT | --toplevel=TTTT | specify toplevel directory for music (default is /mnt/music) |
| -d DIRN | --datadir=DIRN | specify directory for embedded sql data (default is $HOME/.muggle) |
| -v | --verbose | specify debug level. The higher the more (default is 1) |
[Bearbeiten] Mugglei
Je nach dem, welche Datenbank verwendet wird, stehen manche Optionen nicht zur Verfügung.
| Parameter | Lange Form | Beschreibung |
|---|---|---|
| -h <hostname> | --name=<hostname> | Rechnername vom Datanbankserver (Vorgabe 'localhost') |
| -p <port> | --port=<port> | Port vom Datenbankserver (Vorgabe datanbankspezifisch) |
| -s <socket> | --socket=<socket> | Socket zur Datenbank (Vorgabe datenbankspezifisch, bei MySql ist es TCP) |
| -n <database> | --name=<database> | Name der Datenbank (Vorgabe 'GiantDisc') |
| -u <username> | --user=<username> | Benutzername für Datenbank (Vorgabe: leer) |
| -w <password> | --password=<password> | Passwort für Datenbank (Vorgabe: leer) |
| -t <topleveldir> | --toplevel=<topleveldir> | Name des Musikverzeichnisses (Vorgabe ist /mnt/music respektive der beim Kompilieren angegebene Wert) |
| -z | --delete | lösche alle Einträge in der Datenbank, deren Musikdateien fehlen |
| -c | --create | lösche die ganze Datenbank und generiere sie neu |
| -v | --verbose | Gesprächigkeit, je höher, desto mehr. Default ist 1. |
| -d <dirname> | --datadir=<dirname> | Hier wird die Datenbank angelegt, wenn eine "embedded" Datenbank verwendet wird (sqlite3 oder je nach Konfiguration MySql) (Vorgabe: "$HOME/.muggle") |
[Bearbeiten] Entwicklerversion
git clone git://projects.vdr-developer.org/vdr-plugin-muggle.git
