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

Written by:                  Christian Wieninger <cwieninger at gmx dot de>
                             Based on scripts written by Mike Constabel

Project's homepage:          none

Latest version available at: none

See the file COPYING for license information.

Description:

If you record anything on channel DeluxeMusic this plugin will collect the
track infos (start, stop, title, artist, year) in the background and allows
you to extract audio or video clips from that recording.

Requirements: 

- vdrsync.pl and lame (if audio conversion to mp3 is used)
- vdrsync.pl and mpg123, vorbis-tools (if audio converstion to ogg is used)
- cutalot plugin (if video conversion to clips is used)

Installation:

Compile the plugin as usual and copy the scripts deluxe2mp3.sh and
deluxe2ogg.sh to the path of your executables, like /usr/local/bin. Edit
the scripts to your needs. 

Usage:

Create a timer for a deluxe recording (IMPORTANT: should start with a full
minute, so no instant recordings!) and let it record some tracks. Specify a
suitable recording path, because this one will also be used as subdirectory
when creating audio tracks. So e.g. edit the path to 'DeluxeMusic'.

While or after recording you can control the tracks that are completely
included (based on collected EPG infos) in the recording with 'Songs'. This
menu can also be used to toggle songs that should be used for further
processing and to jump directly to the song in the recording. Already
converted songs will be automatically disabled when you use "Avoid repeats" in
the setup.

Now press "Mark" in the main menu to set cut marks based on your selected
songs and press 'Ok' to start the replay. 
The start marks should be nearly ok, the stop marks sometimes need some
tuning because of advertising after the tracks. 
ATTENTION: You must not remove any start marks, because the have an internal
comment on it that contains the track infos. So only move start marks. This
applies not to stop marks.

The replay mode has some extra funcitonality compared to VDR's standard:
- When marks were set the replay menu shows the current track instead of the
  recording name.
- If you press 'Info' or '5' you get information about the current track based
  on the collected EPG infos, also if no marks were set.
- '2' can be used to remove the start and stop marks of the current track, if
  you don't like to have this track to be processed.
- '1' and '3' can be used for quick mark moving besides the usual '4' and '6'
  for standard speed moving.

If all your marks are correct you can start the conversion to video or audio
clips. The conversion sets all (active or inactive) tracks to 'converted' to
prevent that any unwanted tracks will be selected again in upcoming
recordings. 
- video conversion: The title of the single clips can be adjusted with 'Format
  for cut marks' in the setup using the builtin variables '%artist%', '%title%'
  and '%year%'.
- audio conversion: with the script deluxe2mp3.sh the tracks will be converted
  to mp3 clips (the same with deluxe2ogg.sh for ogg). Edit the scripts if you
  like to alter the filenames, bitrate, ... 

Blacklist usage:
If you like to ignore special artist or songs put them in the
blacklist.conf. A sample exists in the conf sub directory. Regular expressions
are supported. The blacklist can also be used to exclude songs that already
exist in your collection. There's a script mp3archiv2blacklist.pl that scans
an mp3/ogg collection and outputs it in the format of the blacklist.conf, so call it like:

./archiv2blacklist.pl /mp3/Music >> blacklist.conf


Notes:
- The deluxe channel is hardcoded. My entry in channels.conf looks like this:
  DELUXE
  MUSIC,DELUXE;BetaDigital:12246:V:S19.2E:27500:255:256=deu:0:0:10100:1:1092:0
  You can pass an alternative channel-ID to the plugin with the commandline 
  option --channel or -c, e.g.:

  -P'deluxe -c C-65300-29-29040'

  The channel ID must be given in VDRs channel ID format.
- If you use noad please remember that it creates it's own marks. So better
  wait some minutes after the end of the recording before you start editing
  your marks.
- Deluxe sometimes (e.g. Sat 22:00) delivers no 'per track' EPG. So such
  recordings cannot be handled with this plugin.

Thanks to Mike Constabel for the idea behind this plugin!

Have fun!

Christian Wieninger