Difference between revisions of "Mp3-plugin"

From VDR Wiki
Jump to: navigation, search
(Preparation)
 
(initial)
Line 1: Line 1:
 
==Description==
 
==Description==
[[Image:(missing)-plugin.jpg|thumb|Screenshot]]
+
[[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==
See [[plugin 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>
  
===Options===
+
libmad
 +
<pre>
 +
cd $SOURCEDIR
 +
tar xvzf libmad-<VERSION>.tar.gz
 +
cd libmad-<VERSION>
 +
./configure --prefix=/usr/local
 +
make
 +
make install
 +
ldconfig
 +
</pre>
  
===Patches===
+
libsndfile
 +
<pre>
 +
cd $SOURCEDIR
 +
tar xvzf libsndfile-<VERSION>.tar.gz
 +
cd libsndfile-<VERSION>
 +
./configure --prefix=/usr/local
 +
make
 +
make install
 +
ldconfig
 +
</pre>
  
==Configuration==
+
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>
  
==Parameter==
 
 
{| border=1 cellpadding=2 cellspacing=0
 
{| border=1 cellpadding=2 cellspacing=0
 
|- bgcolor=#efdead
 
|- bgcolor=#efdead
!Parameter (short)
+
!Key
!Parameter (long)
+
 
!Description
 
!Description
 
|-
 
|-
| -a ABC || --aaa=ABC || some Parameter
+
!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
 
|-
 
|-
| -b    || --bbb    || another Parameter
+
!bgcolor=#efefef| DBG=1                  || Include debug symbols
 
|}
 
|}
  
==Handling==
+
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
!Key
+
!Parameter (short)
 +
!Parameter (long)
 
!Description
 
!Description
 
|-
 
|-
!bgcolor=#efefef| Right || Fast forward (5 sec.)
+
| -m CMD || --mount=CMD  || use CMD to mount/unmount/eject mp3 sources (default: mount.sh)
 
|-
 
|-
!bgcolor=#efefef| Left  || Fast backward (5 sec.)
+
| -n CMD || --network=CMD || execute CMD before & after network access (default: none)
 
|-
 
|-
!bgcolor=#efefef| Up   || Next song
+
| -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==
 
==CVS==
 
<pre>
 
cvs ... login
 
cvs ... co ...
 
</pre>
 
  
 
==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:(missing)-plugin]]
+
[[de:Mp3-plugin]]

Revision as of 22:03, 14 November 2004

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)

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