Installation: ============= Vdrrip is able to handle some different output-formats/codecs: - lavc, XviD and DivX as video-codecs - lame, ogg-vorbis, mp2, ac3 as audio-codecs - avi, ogm, matroska as container-format The requirements of vdrrip depend on the audio-codecs and container- formats, which you want to use. See the following table to know what you have to install. No fear, you need only MPlayer[5] to create an avi-file with divx-video(lavc) and mp2/ac3-audio(copy). If you want mp3-audio for example, you have to install LAME[2a], too. ======================================================================= Contanier-formats/ | avi | ogm **) | matroska **) | Audio-codecs: | | | | ======================================================================= LAME | 2a/5 | 2a/3b/4a/4b/5 | 2a/3c/4a/4b/5 | ----------------------------------------------------------------------- ogg-vorbis **) | not possible | 2b/3b/4a/4b/5 | 2b/3c/4a/4b/5 | ----------------------------------------------------------------------- mpg (stream-copy) | 5 | 3b/4a/4b/5 *) | 3c/4b/5 | ----------------------------------------------------------------------- ac3 (stream-copy) | 5 | 3b/4b/5 | 3c/4b/5 | ----------------------------------------------------------------------- *) It is not possible to mux a mpg2-stream into an ogm-container. So the mpg2-stream is converted to ac3 (with the same bitrate). **) Ogg-Vorbis/ac3/ogm/matroska-support isn't automatically detected by vdrrip. You have to activate them manually in the plugins-setup menu. See 6) how to encode movies from DVD with vdrrip. 1) Video-codecs: ================ Use only lavc for a minimal configuration, XviD and DivX are optional ! 1a) lavc : ----------------------------------------- This open source divx-codec is shipped with MPlayer. It is very fast and has a really good quality. Highly recommend ! 1b) XviD : ------------------------------- XviD is an open source divx-codec. If you want to use it as (additional) video-codec, you have to run the following commands: > cd /usr/local/src > tar xzvf xvidcore-X.X.X.tgz > cd xvidcore-X.X.X/build/generic > ./configure > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) 1c) DivX 4/5: ----------------------------------- DivX is a closed source divx-codec. It is free for personal use. If you want to use it as (additional) video-codec, you have to run the following commands: > cd /usr/local/src > tar xzvf divx4linux-XXXXXXXX.tgz > cd divx4linux-XXXXXXXX > ./install.sh If you use a mplayer version lower then 1.0pre, you need the version 20020418 from . Else you can use the version 5.0.5 from . 2) Audio-codecs: ================ 2a) LAME : --------------------------------------- Lame is an open source mp3 encoder. Using the LAME encoding engine (or other mp3 encoding technology) may require a patent license in some countries . If you want to use it as audio codec, you have to to run the following commands: > cd /usr/local/src > tar xzvf lame-X.X.X.tgz > cd lame-X.X.X > ./configure > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) 2b) ogg Vorbis : --------------------------------------- Ogg Vorbis is an patent free open source audio encoder. If you want to use it audio codec, you have to download the following sources from : - libogg-X.X.X.tar.gz, install it with > cd /usr/local/src > tar xzvf libogg-X.X.X.tar.gz > cd libogg-X.X.X > ./configure > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) - libvorbis-X.X.X.tar.gz, install it with > cd /usr/local/src > tar xzvf libvorbis-X.X.X.tar.gz > cd libvorbis-X.X.X > ./configure > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) 3) Container-formats: ===================== 3a) avi: -------- MPlayer/MEncoder supports the avi-format. You don't have to install something else. 3b) ogm : --------------------------------------------------------------- To use ogm as (additional) container format, you have to install the OGMtools with: > cd /usr/local/src > tar xjvf ogmtools-X.X.tar.bz2 > cd ogmtools-X.X > ./configure > make > make install OGMtools depend on libogg and libvorbis [see 2b)] ! 3c) matroska : ---------------------------------------------------------------------- To use matroska as (additional) container format, you have to install the following libraries/tools (I had to install libexpat on my testsystem !): - libebml: > cd /usr/local/src > tar xjvf libebml-X.X.X.tar.bz2 > cd libebml-X.X.X/make/linux > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) - libmatroska: > cd /usr/local/src > tar xjvf libmatroska-X.X.X.tar.bz2 > cd libmatroska-X.X.X/make/linux > make > make install > ldconfig (/etc/ld.so.conf should include /usr/local/lib) - mkvtoolnix: > cd /usr/local/src > tar xjvf mkvtoolnix-X.X.X.tar.bz2 > cd mkvtoolnix-X.X.X > ./configure > make > make install Mkvtoolnix depend on libogg and libvorbis [see 2b)] ! 4) Tools: ========= 4a) ffmpeg : ------------------------------------------- ffmpeg is an open source tool, to convert between several video and audio formats. You only need it together with ogm/matroska-containers. You can install it with the following commands: > cd /usr/local/src > tar xzvf ffmpeg-X.X.X.tar.gz > cd ffmpeg-X.X.X > ./configure --disable-ffserver --disable-ffplay --disable-debug \ --enable-a52 --enable-mp3lame --enable-vorbis (only use --enable-mp3lame, if LAME [2a] is installed) (only use --enable-vorbis, if ogg Vorbis [2b] is installed) > make > make install 4b) vdrsync : ------------------------------------------- The perl-script vdrsync is used to demux the vdr-recordings. You only need it together with ogm/matroska-containers. There is a copy of it (version 0.1.2.2 without Documentation) in the directory /scripts. To use it, type: > cp vdrrip/scripts/vdrsync.pl /usr/local/bin The version 0.1.2.2dev1 isn't supported at the moment (because of changes in the output format) ! 5) MPlayer : ===================================== All Codecs [see 1/2] have to be installed before the MPlayer installation. All version higher than 0.90 should run. To compile and install mplayer run the following commands: > cd /usr/local/src > tar xjvf MPlayer-X.X.bz2 > cd MPlayer-X.X > ./configure --with-extraincdir=/include \ --enable-largefiles > make > make install (This mplayer/mencoder-version is used to encode vdr-streams (without ac3) and dvd's !!!) If you want to encode/copy ac3-audio from vdr-recordings (not dvd's), you have to install a second, patched (form the directory /patches) version of MPlayer (thx to viking@www.vdrportal.de): > cd /usr/local/src > cp -a MPlayer-X.X MPlayer-X.X_ac3 > cd MPlayer-X.X_ac3 > cat MPlayer_vdrac3.diff | patch libmpdemux/demux_mpg.c > cd libmpdemux > make clean > cd .. > ./configure --with-extraincdir=/include \ --enable-largefiles > make (don't type make install after this !!!) > cp mplayer /usr/local/bin/mplayer_ac3 > cp mencoder /usr/local/bin/mencoder_ac3 6) encoding from DVD: ===================== To encode movies from DVD you have to install the library libdvdnav from : > cd /usr/local/src > tar xzvf libdvdnav-X.X.X.tar.gz > ./configure > make > make install Then uncomment the line VDRRIP_DVD=1 in the file Makefile. The tested version is libdvdnav-0.1.9. This is the same version which is recommend for the dvd-plugin. The default DVD-device is /dev/dvd. If you have a different path, set a symlink or specify the value -d DEV in your vdr start-script. HINTS: If the kernel-module ide-scsi is loaded, your DVD-device is probably /dev/sr0 or /dev/sr1. And don't forget to give read-privileges to the user which starts vdr. 7) vdrrip-plugin: ================= > cd vdr/PLUGINS/src > tar xzvf vdr-vdrrip-X.X.X.tgz > ln -s vdrrip-X.X.X vdrrip > cp vdrrip/scripts/queuehandler /usr/local/bin (or e.g. /usr/bin) > cp vdrrip/scripts/queuehandler.conf /usr/local/bin (or e.g. /usr/bin) > cd ../.. > make plugins Now you have to adjust the settings in the file queuehandler.conf See the README and FAQ how to use the queuehandler. optional: > cp vdrrip/scripts/vdrshutdown.sh /usr/local/bin (or e.g. /usr/bin) > cp vdrrip/scripts/sleephalt.sh /usr/local/bin (or e.g. /usr/bin) To load the plugin add '-Pvdrrip' to your vdr start-script. If mplayer/ mencoder aren't installed to /usr/local/bin, you have to add the following paramter: -p LOC, --MPlayer=LOC use LOC as location of MPlayer (default is /usr/local/bin/mplayer) -e LOC, --MEncoder=LOC use LOC as location of MEncoder (default is /usr/local/bin/mencoder) This parameter could be used to specify you DVD-device: -d DEV, --DVD=DEV use DEV as your DVD-device (default is /dev/dvd) e.g: -P'vdrrip -p /bin/mplayer -e /bin/mencoder' To use the shutdown scripts, add -s .