Difference between revisions of "Mp3-plugin"
From VDR Wiki
(Preparation) |
(initial) |
||
Line 1: | Line 1: | ||
==Description== | ==Description== | ||
− | [[Image: | + | [[Image:Mp3-plugin(setup).jpg|thumb|Setup]] |
+ | The '''MP3 plugin''' plays sound files of various formats. E.g. | ||
+ | * MP3 | ||
+ | * OGG Vorbis | ||
+ | * Wave (PCM) | ||
+ | * ... | ||
+ | |||
+ | {{Box Hint| | ||
+ | The [[MP3|mp3-plugin]] plugin and the [[MPlayer|mplayer-plugin]] plugin come together in one package | ||
+ | }} | ||
==Hardware requirements== | ==Hardware requirements== | ||
+ | * Sound card (optional) | ||
==Software requirements== | ==Software requirements== | ||
+ | * libid3tag | ||
+ | * libmad | ||
+ | * libsndfile | ||
+ | * libogg | ||
+ | * libvorbis | ||
==Installation== | ==Installation== | ||
− | + | To install libid3tag | |
+ | <pre> | ||
+ | cd $SOURCEDIR | ||
+ | tar xvzf libid3tag-<VERSION>.tar.gz | ||
+ | cd libid3tag-<VERSION> | ||
+ | ./configure --prefix=/usr/local | ||
+ | make | ||
+ | make install | ||
+ | ldconfig | ||
+ | </pre> | ||
− | = | + | libmad |
+ | <pre> | ||
+ | cd $SOURCEDIR | ||
+ | tar xvzf libmad-<VERSION>.tar.gz | ||
+ | cd libmad-<VERSION> | ||
+ | ./configure --prefix=/usr/local | ||
+ | make | ||
+ | make install | ||
+ | ldconfig | ||
+ | </pre> | ||
− | = | + | libsndfile |
+ | <pre> | ||
+ | cd $SOURCEDIR | ||
+ | tar xvzf libsndfile-<VERSION>.tar.gz | ||
+ | cd libsndfile-<VERSION> | ||
+ | ./configure --prefix=/usr/local | ||
+ | make | ||
+ | make install | ||
+ | ldconfig | ||
+ | </pre> | ||
− | == | + | libogg |
+ | <pre> | ||
+ | cd $SOURCEDIR | ||
+ | tar xvzf libogg-<VERSION>.tar.gz | ||
+ | cd libogg-<VERSION> | ||
+ | ./configure --prefix=/usr/local | ||
+ | make | ||
+ | make install | ||
+ | ldconfig | ||
+ | </pre> | ||
+ | |||
+ | and libvorbis | ||
+ | <pre> | ||
+ | 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 | ||
+ | </pre> | ||
+ | |||
+ | See [[plugin installation]]. | ||
+ | |||
+ | ===Options=== | ||
+ | These option can be set in the '''Makefile''' or directly given to the ''make'' command. E.g. | ||
+ | <pre> | ||
+ | make WITH_OSS_OUTPUT=1 all plugins | ||
+ | </pre> | ||
− | |||
{| border=1 cellpadding=2 cellspacing=0 | {| border=1 cellpadding=2 cellspacing=0 | ||
|- bgcolor=#efdead | |- bgcolor=#efdead | ||
− | ! | + | !Key |
− | + | ||
!Description | !Description | ||
|- | |- | ||
− | | - | + | !bgcolor=#efefef| WITHOUT_MP3=1 || Do not compile the MP3 plugin |
+ | |- | ||
+ | !bgcolor=#efefef| WITHOUT_MPLAYER=1 || Do not compile the MPlayer plugin | ||
+ | |- | ||
+ | !bgcolor=#efefef| WITHOUT_LIBSNDFILE=1 || Compile without libsndfile support | ||
+ | |- | ||
+ | !bgcolor=#efefef| WITHOUT_LIBVORBISFILE=1 || Compile without libvorbisfile support | ||
+ | |- | ||
+ | !bgcolor=#efefef| WITH_OSS_OUTPUT=1 || Compile with OSS sound output support | ||
|- | |- | ||
− | | | + | !bgcolor=#efefef| DBG=1 || Include debug symbols |
|} | |} | ||
− | == | + | See [[plugin installation]]. |
+ | |||
+ | ==Configuration== | ||
+ | <pre> | ||
+ | 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 | ||
+ | </pre> | ||
+ | |||
+ | ==Parameter== | ||
{| border=1 cellpadding=2 cellspacing=0 | {| border=1 cellpadding=2 cellspacing=0 | ||
|- bgcolor=#efdead | |- bgcolor=#efdead | ||
− | ! | + | !Parameter (short) |
+ | !Parameter (long) | ||
!Description | !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) | ||
|} | |} | ||
==Problems== | ==Problems== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==Links== | ==Links== | ||
{| | {| | ||
| [1] | | [1] | ||
− | | http:// | + | | http://www.muempf.de/index.html |
| Plugin homepage | | 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 | ||
|} | |} | ||
Line 58: | Line 167: | ||
<!-- Link to the german VDR Wiki --> | <!-- Link to the german VDR Wiki --> | ||
− | [[de: | + | [[de:Mp3-plugin]] |
Revision as of 21:03, 14 November 2004
Contents
Description
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) |
Problems
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 |