Mp3-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
 
(103 dazwischenliegende Versionen von 66 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Beschreibung==
 
==Beschreibung==
 +
'''Autor:''' Stefan Huelswitt
 +
 +
Spielt MP3s, OGGs, WAVs etc. ab. Auch [[Internetradio]] kann damit benutzt werden. Es benutzt als Ausgabegerät entweder die DVB-Karte oder eine Soundkarte. Das Bedienkonzept ist playlisten-zentriert.
 +
 +
===Status===
 +
Letztes Update 12/2009
 +
 +
==Bilder==
 +
[[Bild:mp3-plugin.jpg|thumb|none|''Einstellungen'']]
 +
 +
==Bedienung==
 +
===[[SVDRP]] Befehle===
 +
{| class="wikitable"
 +
|- bgcolor=#efefef
 +
!Parameter
 +
!Beschreibung
 +
|-
 +
| PLAY <filename> || Triggers playback of file 'filename'.
 +
|-
 +
| TEST <filename> || Tests if playback of file 'filename' is possible.
 +
|-
 +
| CURR            || Returns filename of song currently being replayed.
 +
|}
 +
 
==Hardwareanforderungen==
 
==Hardwareanforderungen==
DVB Karte.
+
* veraltete SDTV [[Full-featured-DVB-Karte]] mit Firmware >= 261d oder sinnvoller
 +
* Soundkarte
  
 
==Softwareanforderungen==
 
==Softwareanforderungen==
libid3tag, libmad, libsndfile, libogg, libvorbis
+
* zlib
 +
* libid3tag
 +
* libmad
 +
* libsndfile (optional für WAV-Dateien)
 +
* libvorbis, libvorbisfile (optional für OGG-Dateien)
 +
* netpbm (optional für Hintergrundbilder)
 +
* mjpegtools (optional für Hintergrundbilder)
  
==Optionen==
+
==Installation==
Das Plugin selbst hat einige "Schalter" inside:
+
===Optionen===
<pre>
+
{| class="wikitable"
### uncomment one of these lines, if you don't want one of the plugins
+
|-
#WITHOUT_MP3=1           // Übersetzen ohne MP3-Plugin
+
| bgcolor=#efefef | WITHOUT_MP3=1
#WITHOUT_MPLAYER=1       // Übersetzen ohne MPlayer-Plugin
+
| Übersetzen ohne MP3-Plugin
 +
|-
 +
| bgcolor=#efefef | WITHOUT_MPLAYER=1
 +
| Übersetzen ohne MPlayer-Plugin
 +
|-
 +
| bgcolor=#efefef | WITHOUT_LIBSNDFILE=1
 +
| Übersetzen ohne Libsndfile
 +
|-
 +
| bgcolor=#efefef | WITHOUT_LIBVORBISFILE=1
 +
| Übersetzen ohne libvorbisfile
 +
|-
 +
| bgcolor=#efefef | WITH_OSS_OUTPUT=1
 +
| Übersetzen mit "OSS sound Ausgabe". Laut HISTORY kann das DSP device mit angegeben werden: -D [NUM] somit -D 1
 +
|}
  
### uncomment the following line, if you don't have libsndfile installed
+
==Konfiguration==
#WITHOUT_LIBSNDFILE=1    // Übersetzen ohne Libsndfile
+
mkdir -p /var/lib/cddb [[Struktur|$VDRCONFIG]]/plugins/{mp3,mplayer}
 +
cd [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/mp3/examples
 +
# Die network.sh ist an die Bedürfnisse anzupassen.
 +
mv network.sh.example network.sh
 +
mv mount.sh.example mount.sh
 +
chmod 777 *.sh
 +
cp mp3sources.conf.example [[Struktur|$VDRCONFIG]]/plugins/mp3/[[mp3sources.conf]]
 +
cp mp3sources.conf.example [[Struktur|$VDRCONFIG]]/plugins/mplayer/[[mplayersources.conf]]
 +
cd /usr/local/bin
 +
ln -vs [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/mp3/examples/*.sh .
  
### uncomment the following line, if you don't have libvorbisfile installed
+
Übergabe:
#WITHOUT_LIBVORBISFILE=1 // Übersetzen ohne libvorbisfile
+
  
### uncomment the following line, if you want OSS sound output
+
vdr -P'mp3 -m [[Struktur|$PATH]]/mount.sh -B /var/lib/cddb -n [[Struktur|$PATH]]/network.sh -S mp3'
#WITH_OSS_OUTPUT=1      // Übersetzen mit "OSS sound Ausgabe"
+
                        // Laut HISTORY kann das DSP device
+
                        // mit angegeben werden:
+
                        // -D [NUM] somit -D 1
+
  
### uncomment the following line, if you want to include debug symbols
+
Es ist auch möglich Internet-Streams ([[Internetradio]]) zu empfangen, sicher nur für Standleitungen von Interesse.
#DBG=1                  // Übersetzen im Debug Modus
+
 
 +
Nun sollte auch klar werden, für was die network.sh anzupassen ist.
 +
 
 +
Ruft man einen Stream auf, kann mit besagten Script die Internetverbindung hergestellt werden.
 +
 
 +
Einfach ein Verzeichnis erstellen, möglichst unterhalb von den Einträgen der [[mp3sources.conf]].
 +
 
 +
<pre>
 +
mkdir -p /mp3/streams
 
</pre>
 
</pre>
Soviel zu den Optionen, für die "Übergabe" gibt es eigentlich nur 2 Wege.
 
* Das direkte "auskommentieren" im Makefile vor dem übersetzen.
 
* Oder per Kommandozeile, zbs:
 
  make WITH_OSS_OUTPUT=1 all plugins
 
  
Ihr seht schon, einige Plugins sind in der Funktion zwar selbsterklärend, dennoch kann es nicht schaden mal einen Blick in die Makefiles zu werfen.
+
Dazu sind einfache Textfiles zu erstellen.
  
In den meisten finden sich Optionen, oft muß hier und da ein PATH angepasst werden, das sich ein Plugin zum übersetzen bewegen läßt :-))
+
<pre>
 +
cd /mp3/streams
 +
echo http://205.188.234.65:8030 > Beschreibung
 +
</pre>
  
==Installation==
+
Unter folgenden Adressen, findet man für jeden Geschmack etwas.
<pre>tar xvzf libid3tag-0.15.0b.tar.gz
+
* http://www.shoutcast.com
cd libid3tag-0.15.0b
+
* http://www.di.fm
./configure --prefix=/usr/local
+
make
+
make install
+
ldconfig
+
cd -
+
  
tar xvzf libmad-0.15.0b.tar.gz
+
Oder per Script.
cd libmad-0.15.0b
+
* http://vdrportal.de/board/thread.php?threadid=19478
./configure --prefix=/usr/local
+
make
+
make install
+
ldconfig
+
cd -
+
  
tar xvzf libsndfile-1.0.5.tar.gz
+
===Einstellungen===
cd libsndfile-1.0.5
+
;Audio Modus = Streuen
./configure --prefix=/usr/local
+
Der MP3-Dekoder liefert 24bit Daten, die auf 16bit herunterskaliert werden müssen. Der Modus
make
+
&#8222;Runden&#8220; schneidet einfach die 8bit mit der niedrigsten Bedeutung vom 24bit-Wort ab, wo
make install
+
hingegen &#8222;Streuen&#8220; eine Fehlerstrategie implementiert. Der Modus &#8222;Streuen&#8220; ist geringfügig
ldconfig
+
rechenintensiver.
  
tar xvzf libogg-1.1.tar.gz
+
;Nur 48kHz Modus benutzen = nein
cd libogg-1.1
+
Falls &#8222;ja&#8220;, wird das MP3-Plugin gezwungen die Abtastrate der DVB-Karte von 48 kHz zu
./configure --prefix=/usr/local
+
verwenden. Die Abtastraten der Musikstücke werden dann auf 48 kHz umgerechnet.
make
+
make install
+
ldconfig
+
cd -
+
  
tar xvzf libvorbis-1.0.1.tar.gz
+
;Anzeige Modus = 3
cd libvorbis-1.0.1
+
Bestimmt, welche Informationen im Fortschrittsbalken angezeigt werden:
./configure --prefix=/usr/local --with-ogg-libraries=/usr/local/lib
+
1. Zeigt Titel und Künstlernamen
make
+
2. Zeigt zusätzlich Album und Jahr
make install
+
3. Zeigt zusätzlich Abtastrate, Bitrate und Anzahl der Kanäle
ldconfig
+
</pre>
+
==Konfiguration==
+
cd /usr/local/src/VDR/PLUGINS/src
+
tar xzvf vdr-mp3-0.9.3.tar.gz
+
ln -s mp3-0.9.3 mp3
+
cd mp3/examples
+
# Die [[network.sh]] ist an die Bedürfnisse anzupassen.
+
mv network.sh.example [[network.sh]]
+
mv mount.sh.example [[mount.sh]]
+
chmod 777 *.sh
+
cd /usr/local/bin
+
ln -vs /usr/local/src/VDR/PLUGINS/src/mp3/scripts/*.sh .
+
cd /usr/local/src/VDR
+
make all plugins
+
  
Tip: Folgender "Einzeiler" löscht "dead-links" unter /usr/local/bin
+
;Hintergrund Modus = Schwarz
 +
Hintergrund wählt die Hintergrundanzeige während der Wiedergabe. Zur Auswahl steht &#8222;Schwarz&#8220;, das Live-Bild des zuletzt gewählten Fernsehkanals oder es wird ein Bild (.jpg, .gif, ...) angzeigt, das im Verzeichnis der mp3-Datei liegt (siehe Readme)
  
find /usr/local/bin -type l -not -exec test -e '{}' ';' -exec rm '{}' ';'
+
;Default Loop Modus = nein
 +
Bei &#8222;ja&#8220; wird die automatische Wiederholung nach dem Ende einer Abspielliste eingeschaltet.
  
==Probleme==
+
;Default Shuffle Modus = nein
Keine bekannt.
+
Bei &#8222;ja&#8220; wird die Zufallswiedergabe der Abspielliste eingeschaltet.
  
==Links==
+
;ID3 Einlesen = Hintergrund
{|
+
Ermöglicht das Einlesen von ID3-Tags im Hintergrund während der Wiedergabe. In der Abspielliste
| [1]
+
werden Titel und Künstler nur für Lieder angezeigt, die schon gespielt wurden, oder deren ID3-Tags
| http://www.underbit.com/products/mad
+
bereits eingelesen wurden. Auch wenn &#8222;Hintergrund&#8220; gewählt ist, wird die Funktion nur ausgeführt,
 +
wenn die Prozessorleistung für den Hintergrundprozess ausreicht.
 +
 
 +
;Editor Modus = ID3 Namen
 +
Dieser Eintrag bestimmt, ob in der Abspielliste Titel und Künstler, oder die Dateinamen angezeigt
 +
werden. Die Anzeige von Titel und Künstler kann etwas länger dauern, da alle ID3-Tags der
 +
Musikdateien erst eingelesen werden müssen.
 +
Hauptmenü Modus = Verz.Anzeige
 +
Wählt, ob bei Aufruf des MP3-Plugins die Abspielliste gezeigt wird oder ob gleich zur
 +
Verzeichnisanzeige weitergesprungen wird.
 +
 
 +
;Normalisierer Pegel = 25
 +
48 Einstellungen
 +
Setzt den Lautstärkepegel für den Normalisierer. Es sind Werte zwischen 0 und 50 erlaubt. Bei 0
 +
wird der Normalisierer ausgeschaltet. Der Normalisierer wird gebraucht, wenn die Musikstücke
 +
einer Abspielliste mit verschiedenen Lautstärkepegeln aufgenommen wurden.
 +
 
 +
;Begrenzer Pegel = 70
 +
Setzt den Lautstärkepegel für den Lautstärkebegrenzer. Es sind Werte zwischen 25 und 100 erlaubt.
 +
Bei 100 wird der Begrenzer ausgeschaltet.
 +
 
 +
;HTTP Proxy benutzen = nein
 +
Ermöglicht die Benutzung eines HTTP Proxy-Servers beim Abspielen von Shoutcats / Icecast
 +
Streams.
 +
 
 +
;HTTP Proxy Name = localhost
 +
Der Hostname des HTTP Proxy-Servers. Wird nur benutzt, falls HTTP Proxy benutzen
 +
eingeschaltet wurde.
 +
 
 +
;HTTP Proxy Port = 8080
 +
Die Port Nummer des HTTP Proxy Servers. Wird nur benutzt, falls HTTP Proxy benutzen
 +
eingeschaltet wurde.
 +
 
 +
;CDDB für CD-Audio = local/remote
 +
Wenn eine Audio-CD gespielt wird, ermöglicht dieser Eintrag nach Titel und Stücknamen in der
 +
CDDB-Datenbank zur CD zu suchen. Man kann zwischen &#8222;local&#8220; und &#8222;local&remote&#8220; wählen. Für
 +
die lokale Suche muss natürlich die CDDB-Datenbank auf dem VDR-Rechner installiert sein.
 +
 
 +
;CDDB Server = freedb.freedb.org
 +
Hat man einen Internet-Anschluss für seinen VDR-Rechner, so kann über das Netz auf eine CDDBDatenbank
 +
zugegriffen werden. Der Hostname des CDDB Servers muss hier eingetragen werden
 +
und funktioniert nur, wenn local/remote im Eintrag vorher gewählt wurde.
 +
 
 +
;CDDB Port = 888
 +
Die Port Nummer des CDDB Servers.
 +
 
 +
===Parameter===
 +
{| class="wikitable"
 
|-
 
|-
| [2]
+
!Parameter (kurz)
| http://www.zip.com.au/~erikd/libsndfile
+
!Parameter (lang)
 +
!Beschreibung
 
|-
 
|-
| [3]
+
| -m ''<DATEI>'' || --mount=''<DATEI>'' || Skripts zum Mounten/Unmounten/Auswerfen (Standard: ''mount.sh'')
| http://www.xiph.org/ogg/vorbis
+
 
|-
 
|-
| [4]
+
| -n ''<CMD>''  || --network=''<CMD>'' || Führe Befehl vor/nach Netzwerk-Zugriff aus (Standard: kein)
| http://www.muempf.de/index.html
+
|-
| Homepage des Plugins
+
| -C ''<DIR>'' || --cache=''<DIR>''  || Speichere ID3-Cache in diesem Verzeichnis (Standard: Videoverzeichnis)
 +
|-
 +
| -V ''<DIR>'' || --cddb=''<DIR>''    || Suche CDDB-Dateien in disem Verzeichnis (Standard: ''/var/lib/cddb'')
 +
|-
 +
| -D ''<DATEI>'' || --dsp=''<DATEI>''  || Gerätedatei für OSS-Output (Standard: kein)
 +
|-
 +
| -i ''<DATEI>'' || --iconv=''<DATEI>'' || Skript zum konvertieren der Hintergrundbilder (Standard: ''image_convert.sh'')
 +
|-
 +
| -c ''<DIR>'' || --icache=''<DIR>''  || Cache-Verzeichnis für konvertierte Hintergrundbilder (Standard: ''/var/cache/images/mp3'')
 +
|-
 +
| -S ''<SUB>'' || --sources=''<SUB>'' || Suche sources config in SUB Unterverzeichnis (Standard: "")
 
|}
 
|}
  
<div style="color:red">FEHLT: Beschreibung...</div>
+
==Aktuelle Version==
 +
[http://www.muempf.de/down/vdr-mp3-0.10.2.tar.gz 0.10.2]
 +
 
 +
==Links==
 +
# [http://www.muempf.de/index.html Homepage des Plugins]
 +
 
 +
[[Kategorie:Plugins]]
 +
[[Kategorie:Medienspieler-Plugins]]
 +
{{i18n|mp3-plugin}}

Aktuelle Version vom 29. August 2013, 16:49 Uhr

Inhaltsverzeichnis

[Bearbeiten] Beschreibung

Autor: Stefan Huelswitt

Spielt MP3s, OGGs, WAVs etc. ab. Auch Internetradio kann damit benutzt werden. Es benutzt als Ausgabegerät entweder die DVB-Karte oder eine Soundkarte. Das Bedienkonzept ist playlisten-zentriert.

[Bearbeiten] Status

Letztes Update 12/2009

[Bearbeiten] Bilder

Einstellungen

[Bearbeiten] Bedienung

[Bearbeiten] SVDRP Befehle

Parameter Beschreibung
PLAY <filename> Triggers playback of file 'filename'.
TEST <filename> Tests if playback of file 'filename' is possible.
CURR Returns filename of song currently being replayed.

[Bearbeiten] Hardwareanforderungen

[Bearbeiten] Softwareanforderungen

  • zlib
  • libid3tag
  • libmad
  • libsndfile (optional für WAV-Dateien)
  • libvorbis, libvorbisfile (optional für OGG-Dateien)
  • netpbm (optional für Hintergrundbilder)
  • mjpegtools (optional für Hintergrundbilder)

[Bearbeiten] Installation

[Bearbeiten] Optionen

WITHOUT_MP3=1 Übersetzen ohne MP3-Plugin
WITHOUT_MPLAYER=1 Übersetzen ohne MPlayer-Plugin
WITHOUT_LIBSNDFILE=1 Übersetzen ohne Libsndfile
WITHOUT_LIBVORBISFILE=1 Übersetzen ohne libvorbisfile
WITH_OSS_OUTPUT=1 Übersetzen mit "OSS sound Ausgabe". Laut HISTORY kann das DSP device mit angegeben werden: -D [NUM] somit -D 1

[Bearbeiten] Konfiguration

mkdir -p /var/lib/cddb $VDRCONFIG/plugins/{mp3,mplayer}
cd $SOURCEDIR/VDR/PLUGINS/src/mp3/examples
# Die network.sh ist an die Bedürfnisse anzupassen.
mv network.sh.example network.sh
mv mount.sh.example mount.sh
chmod 777 *.sh
cp mp3sources.conf.example $VDRCONFIG/plugins/mp3/mp3sources.conf
cp mp3sources.conf.example $VDRCONFIG/plugins/mplayer/mplayersources.conf
cd /usr/local/bin
ln -vs $SOURCEDIR/VDR/PLUGINS/src/mp3/examples/*.sh .

Übergabe:

vdr -P'mp3 -m $PATH/mount.sh -B /var/lib/cddb -n $PATH/network.sh -S mp3'

Es ist auch möglich Internet-Streams (Internetradio) zu empfangen, sicher nur für Standleitungen von Interesse.

Nun sollte auch klar werden, für was die network.sh anzupassen ist.

Ruft man einen Stream auf, kann mit besagten Script die Internetverbindung hergestellt werden.

Einfach ein Verzeichnis erstellen, möglichst unterhalb von den Einträgen der mp3sources.conf.

mkdir -p /mp3/streams

Dazu sind einfache Textfiles zu erstellen.

cd /mp3/streams
echo http://205.188.234.65:8030 > Beschreibung

Unter folgenden Adressen, findet man für jeden Geschmack etwas.

Oder per Script.

[Bearbeiten] Einstellungen

Audio Modus = Streuen

Der MP3-Dekoder liefert 24bit Daten, die auf 16bit herunterskaliert werden müssen. Der Modus „Runden“ schneidet einfach die 8bit mit der niedrigsten Bedeutung vom 24bit-Wort ab, wo hingegen „Streuen“ eine Fehlerstrategie implementiert. Der Modus „Streuen“ ist geringfügig rechenintensiver.

Nur 48kHz Modus benutzen = nein

Falls „ja“, wird das MP3-Plugin gezwungen die Abtastrate der DVB-Karte von 48 kHz zu verwenden. Die Abtastraten der Musikstücke werden dann auf 48 kHz umgerechnet.

Anzeige Modus = 3

Bestimmt, welche Informationen im Fortschrittsbalken angezeigt werden: 1. Zeigt Titel und Künstlernamen 2. Zeigt zusätzlich Album und Jahr 3. Zeigt zusätzlich Abtastrate, Bitrate und Anzahl der Kanäle

Hintergrund Modus = Schwarz

Hintergrund wählt die Hintergrundanzeige während der Wiedergabe. Zur Auswahl steht „Schwarz“, das Live-Bild des zuletzt gewählten Fernsehkanals oder es wird ein Bild (.jpg, .gif, ...) angzeigt, das im Verzeichnis der mp3-Datei liegt (siehe Readme)

Default Loop Modus = nein

Bei „ja“ wird die automatische Wiederholung nach dem Ende einer Abspielliste eingeschaltet.

Default Shuffle Modus = nein

Bei „ja“ wird die Zufallswiedergabe der Abspielliste eingeschaltet.

ID3 Einlesen = Hintergrund

Ermöglicht das Einlesen von ID3-Tags im Hintergrund während der Wiedergabe. In der Abspielliste werden Titel und Künstler nur für Lieder angezeigt, die schon gespielt wurden, oder deren ID3-Tags bereits eingelesen wurden. Auch wenn „Hintergrund“ gewählt ist, wird die Funktion nur ausgeführt, wenn die Prozessorleistung für den Hintergrundprozess ausreicht.

Editor Modus = ID3 Namen

Dieser Eintrag bestimmt, ob in der Abspielliste Titel und Künstler, oder die Dateinamen angezeigt werden. Die Anzeige von Titel und Künstler kann etwas länger dauern, da alle ID3-Tags der Musikdateien erst eingelesen werden müssen. Hauptmenü Modus = Verz.Anzeige Wählt, ob bei Aufruf des MP3-Plugins die Abspielliste gezeigt wird oder ob gleich zur Verzeichnisanzeige weitergesprungen wird.

Normalisierer Pegel = 25

48 Einstellungen Setzt den Lautstärkepegel für den Normalisierer. Es sind Werte zwischen 0 und 50 erlaubt. Bei 0 wird der Normalisierer ausgeschaltet. Der Normalisierer wird gebraucht, wenn die Musikstücke einer Abspielliste mit verschiedenen Lautstärkepegeln aufgenommen wurden.

Begrenzer Pegel = 70

Setzt den Lautstärkepegel für den Lautstärkebegrenzer. Es sind Werte zwischen 25 und 100 erlaubt. Bei 100 wird der Begrenzer ausgeschaltet.

HTTP Proxy benutzen = nein

Ermöglicht die Benutzung eines HTTP Proxy-Servers beim Abspielen von Shoutcats / Icecast Streams.

HTTP Proxy Name = localhost

Der Hostname des HTTP Proxy-Servers. Wird nur benutzt, falls HTTP Proxy benutzen eingeschaltet wurde.

HTTP Proxy Port = 8080

Die Port Nummer des HTTP Proxy Servers. Wird nur benutzt, falls HTTP Proxy benutzen eingeschaltet wurde.

CDDB für CD-Audio = local/remote

Wenn eine Audio-CD gespielt wird, ermöglicht dieser Eintrag nach Titel und Stücknamen in der CDDB-Datenbank zur CD zu suchen. Man kann zwischen „local“ und „local&remote“ wählen. Für die lokale Suche muss natürlich die CDDB-Datenbank auf dem VDR-Rechner installiert sein.

CDDB Server = freedb.freedb.org

Hat man einen Internet-Anschluss für seinen VDR-Rechner, so kann über das Netz auf eine CDDBDatenbank zugegriffen werden. Der Hostname des CDDB Servers muss hier eingetragen werden und funktioniert nur, wenn local/remote im Eintrag vorher gewählt wurde.

CDDB Port = 888

Die Port Nummer des CDDB Servers.

[Bearbeiten] Parameter

Parameter (kurz) Parameter (lang) Beschreibung
-m <DATEI> --mount=<DATEI> Skripts zum Mounten/Unmounten/Auswerfen (Standard: mount.sh)
-n <CMD> --network=<CMD> Führe Befehl vor/nach Netzwerk-Zugriff aus (Standard: kein)
-C <DIR> --cache=<DIR> Speichere ID3-Cache in diesem Verzeichnis (Standard: Videoverzeichnis)
-V <DIR> --cddb=<DIR> Suche CDDB-Dateien in disem Verzeichnis (Standard: /var/lib/cddb)
-D <DATEI> --dsp=<DATEI> Gerätedatei für OSS-Output (Standard: kein)
-i <DATEI> --iconv=<DATEI> Skript zum konvertieren der Hintergrundbilder (Standard: image_convert.sh)
-c <DIR> --icache=<DIR> Cache-Verzeichnis für konvertierte Hintergrundbilder (Standard: /var/cache/images/mp3)
-S --sources= Suche sources config in SUB Unterverzeichnis (Standard: "")

[Bearbeiten] Aktuelle Version

0.10.2

[Bearbeiten] Links

  1. Homepage des Plugins


In anderen Sprachen