[vdr] [ANNOUNCE] vdrrip-0.1.0 plugin

[Herbert Attenberger <herbsl@a-land.de>]

hi ml,

i think it's time to announce vdrrip to this list (@Klaus: please change
the link-description on plugins.html to http://www.a-land.de):

**********************
* short description: *
**********************

vdrrip is a mplayer using movie encoder...

*********************
* long description: *
*********************

This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  herbert attenberger <herbsl at a-land.de>

Project's homepage:          <http://www.a-land.de>

Latest version available at: <http://www.a-land.de>

See the file COPYING for license information.


Description:
============

Vdrrip is a plugin to encode the vdr-recordings into divx format. You can
choose a recording in the menu 'Vdrrip - encode vdr-recording'. Then you
can manually adjust the encoding values, or simply select a template (read
the section 'Templates' in this manual to find out more about them). You
can choose between lavc, xivd and divx4/5 as video codec, and mp3 or
stream-copy as audio codec. The installed codecs automatically are
detected by the plugin. If you input the resulting movie size (and number
of files), the video/audio bitrate is calculated. This is only possible
for cutted movies. If you change the video/audio bitrate, the file size is
calculated. If there is more then one audio-track in the recording, you
can toggle between them in the field Audio-Stream.

You can choose between four scaling mechanism:

- off:
Don't scale, use the original resolution.

- auto:
The scale values are calculated on a algorithm which is based on the
bpp-value. Read the file DOCS/tech/encoding-tips.txt in your
MPlayer-source directory for further informations. The aspect ratio is used,
too.

- dvb:
You can only choose values, which are supported by the DVB-Card without
needing a further scaling while playing. This option (together with
stream-copy as audio codec) is very useful for slow computers (it is 
possible
to play those files on my Celeron 466 Mhz).

- manual:
Select the resolution manually.


In the auto and manual-mode you can automatically detect and crop the black
movie-boarders with the green key. All settings are saved in the file
save.vdrrip in the movie directory. After this you can add the movie 
with the
red key to the encoding queue (file queue.vdrrip in the plugins-directory).
The script queuehandler.sh reads the data from the queue, joins the
vdr-files and encodes the movie. The movie name is detected from the
vdr-directory name. Some parameters can be adjusted in the setup menu.

Templates:
==========

Within a template ('Vdrrip - edit template') you can pre-define the
encoding-settings (either with a fixed FileSize or a fixed bitrate). The
default settings are taken from the template 'default' (for cutted 
movies) or
from the template 'default - fixed bitrate' (for uncutted movies). It is not
possible to set a fixed FileSize for the template 'default - fixed bitrate).
You can add further templates (e.g 1/2-CD, 2/3-CD ...). The
template-selection in movie-menu is only displayed, if there is more the one
template available. If you have chosen an uncutted movie, you only could
toggle between templates with a fixed bitrate. This settings are saved in
the file templates.vdrrip in the directory
vdr-config-dir/PLUGINS.


usage of the quehandler-script:
===============================

queuehandler.sh queuefile tempdir (-preview)

The queuefile is the file queue.vdrrip in your vdr-config-dir/PLUGINS. This
file is only created, if you add a movie to the queue. After the encoding
the file is deleted by the queuehandler-script. Tempdir is the directory,
where encoded movies are saved. If you set the -preview option, there will
be only $previewlength (see in the section #initial definitions) seconds of
the movie encoded. The file /tmp/encode.vdrrip is created while an aktiv
encoding-process. You can use it to keep vdr from an automatic shutdown. I
added my sample scripts vdrshutdown.sh and sleephalt.sh in the directory
scripts. Feel free to use it. Read the file FAQ to see how you can add the
queuehandler to the file commands.conf.

Installation:
=============

1) MPlayer (All codecs [see 2] have to be installed before the MPlayer
installation):

The vdrrip plugin needs an installed mplayer/mencoder
<http://www.mplayerhq.hu> to encode the movies. The tested version are 0.90,
0.91, 1.0pre1 and 1.0pre2. To compile and install mplayer I recommend the
following sequence:

> cd /usr/local/src
> tar xjvf MPlayer-X.X.bz2
> cd MPlayer-X.X
> ./configure --with-extraincdir=<your path to the DVB-drivers>/include
> make
> make install

2) Codecs:

If you want to use xvid <http://www.xvid.org> as video codec, you have to
run the following commands before the mplayer installation:

> 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)

If you want to use divx4/5 <http://www.divx.com> as video codec, you have to
run the following commands before the mplayer installation. If you use
mplayer < 1.0, you need the version 20020418 from
<http://sourceforge.net/project/showfiles.php?group_id=11050>. Else you can
use the version 5.0.5 from <http://www.divx.com>.

> cd /usr/local/src
> tar xzvf divx4linux-20020418.tgz
> cd divx4linux-20020418
> ./install.sh

If you want to use lame <http://lame.sourceforge.net> as audio codec, you
have to run the following commands before the mplayer installation:

> 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)

3) And now lets install the 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.sh /usr/local/bin (or e.g. /usr/bin)
> cd ../..
> make plugins

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 in /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)
e.g: -P'vdrrip -p /bin/mplayer -e /bin/mencoder'

To use the shutdown scripts, add -s <path-to-vdrshutdown.sh>. Please 
read the files FAQ and TODO for further informations.



bye

herbert attenberger



--
Info:
To unsubscribe send a mail to ecartis@linuxtv.org with "unsubscribe vdr" as subject.