Mp3-plugin

Description

Setup

The MP3 plugin plays sound files of various formats. E.g.

• MP3
• OGG Vorbis
• Wave (PCM)
• ...

Hint

The mp3-plugin plugin and the mplayer-plugin plugin come together in one package

Hardware requirements

• Sound card (optional)

Software requirements

• libid3tag
• libmad
• libsndfile
• libogg
• libvorbis

Installation

To install libid3tag

cd $SOURCEDIR
tar xvzf libid3tag-<VERSION>.tar.gz
cd libid3tag-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig

libmad

cd $SOURCEDIR
tar xvzf libmad-<VERSION>.tar.gz
cd libmad-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig

libsndfile

cd $SOURCEDIR
tar xvzf libsndfile-<VERSION>.tar.gz
cd libsndfile-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig

libogg

cd $SOURCEDIR
tar xvzf libogg-<VERSION>.tar.gz
cd libogg-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig

and libvorbis

cd $SOURCEDIR
tar xvzf libvorbis-<VERSION>.tar.gz
cd libvorbis-<VERSION>
./configure --prefix=/usr/local \
            --with-ogg-libraries=/usr/local/lib
make
make install
ldconfig

See plugin installation.

Options

These option can be set in the Makefile or directly given to the make command. E.g.

make WITH_OSS_OUTPUT=1 all plugins

Key	Description
WITHOUT_MP3=1	Do not compile the MP3 plugin
WITHOUT_MPLAYER=1	Do not compile the MPlayer plugin
WITHOUT_LIBSNDFILE=1	Compile without libsndfile support
WITHOUT_LIBVORBISFILE=1	Compile without libvorbisfile support
WITH_OSS_OUTPUT=1	Compile with OSS sound output support
DBG=1	Include debug symbols

See plugin installation.

Configuration

mkdir -p /var/lib/cddb
cd $SOURCEDIR/VDR/PLUGINS/src
tar xzvf vdr-mp3-<VERSION>.tar.gz
ln -s mp3-<VERSION> 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 $SOURCEDIR/VDR/PLUGINS/src/mp3/scripts/*.sh .
cp mp3sources.conf.example /etc/vdr/plugins/mp3sources.conf
cp mp3sources.conf.example /etc/vdr/plugins/mplayersources.conf
cd $SOURCEDIR
make all plugins

Parameter

Parameter (short)	Parameter (long)	Description
-m CMD	--mount=CMD	use CMD to mount/unmount/eject mp3 sources (default: mount.sh)
-n CMD	--network=CMD	execute CMD before & after network access (default: none)
-C DIR	--cache=DIR	store ID3 cache file in DIR (default: video dir)
-V DIR	--cddb=DIR	search CDDB files in DIR (default: /var/lib/cddb)
-D DIR	--dsp=DIR	device for OSS output (default: none)

Links

[1]	http://www.muempf.de/index.html	Plugin homepage
[2]	http://www.underbit.com/products/mad	Libmad homepage
[3]	http://www.zip.com.au/~erikd/libsndfile	Libsndfile homepage
[4]	http://www.xiph.org/ogg/vorbis	Ogg Vorbis CODEC project homepage