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

ExtRecMenuNG on GitLab: https://gitlab.com/kamel5/extrecmenung

Current maintainers: see project's homepage

Based on Plugin extrecmenu:
Original homepage:   https://projects.vdr-developer.org/projects/plg-extrecmenu
Original author:     Martin Prochnow (nordlicht@martins-kabuff.de)
Original homepage:   http://martins-kabuff.de/extrecmenu_en.html

See the file COPYING for license information.

I want to thank to following contributors:
- Mike Constabel <mike@constabel.net> for the script dvdarchive.sh
- Rolf Ahrenberg <rahrenbe@cc.hut.fi> for the finnish translation
- Patrice Staudt <staudt@engsystem.net> for the frensh translation
- Vladim�r B�rta <vladimir.barta@k2atmitec.cz> for the czech translation
- Diego <vdr-italian@tiscali.it> for the italian translation
- Andreas Mair <andreas@vdr-developer.org> for the true type font containing the
  icons
- Carsten Siebholz for adding HDD Archive compatibility

-------------------------------------------------------------------------------
Description
-------------------------------------------------------------------------------
The EXTended RECordings MENU plugin provides additional functions to VDR's
recordings menu:

* restoring or purging a previously deleted recording as long as its retention
  time has not yet expired
* renaming recordings and directories
* moving recordings and directories, also between different file systems
* adjustable display of recording's length, date and size
* directories are always shown on top of the list
* reworked layout using icons for showing the status of list entries
  (directory, new recording, moving recording/directory, cutting recording,
  DVD archive entry)
* extended recordings info menu, shows name, path, channel, size, lifetime and
  priority of the recording
* free disk space is shown for the file system of the current directory
* sorting by name or date, adjustable for each directory; type of sorting will
  be stored
* ascending/descending sorting
* extends VDR's '-r' option commands with 'move' and 'rename'
* functionality of the DVDArchive-patch (see below)
* protecting recordings in co-work with the PIN-plugin
* a cutter queue

-------------------------------------------------------------------------------
Installation
-------------------------------------------------------------------------------
Installation of the plugin itself is like any other plugin installation.

Compile time configuration
-------------------------------------------------------------------------------
Some features of the ExtRecMenu must be activated before compiling the plugin.
This configuration has to be added to the Make.config file in the VDR's source
directory if you want to use it.

USE_PINPLUGIN = 1
Add support for protected recordings by using the PIN plugin.

Font including required symbols
-------------------------------------------------------------------------------
In addition you have to copy the true type font in the ttf/ directory to a
location where freetype will find it (usually /usr/share/fonts/truetype) and
select it in the OSD setup menu of VDR so that the icons which this plugin uses
can be displayed.

Notes
-------------------------------------------------------------------------------
You have to place the script 'dvdarchive.sh' from the scripts/ directory within
your $PATH (maybe adjust the permissions) for the DVDArchive-patch functionality.
See the top of 'dvdarchive.sh' for the adjustments you maybe have to take.

If your /video directory is an NFS mount, you have to mount it with the option
'hard' to make renaming and moving of recordings possible.

Check the options at the setup menu of the plugin. They are self-explaining.

There is a patch for VDR in contrib/ for replacing VDR's recordings menu with
this plugin. You have to set the corresponding option at the setup menu of the
plugin!

-------------------------------------------------------------------------------
Handling
-------------------------------------------------------------------------------

Restoring / purging
-------------------------------------------------------------------------------
When deleting a recording, the VDR renames its directory from *.rec to *.del.
The deleted recordings are scanned regularly for whether they have passed their
designated retention time. The retention time defaults to 5 minutes and,
starting with VDR 2.7.8, is configurable in units of days. During that time,
deleted recordings can be restored by renaming their directory from *.del
back to *.rec, or they can be purged by deleting that directory from the
file system.

When opening a recordings menu, or after moving the cursor, pressing 'Red'
(Restore) allows browsing the deleted recordings, if deleted recordings
should exist. After some time the button changes to allow executing recording
commands (Commands). The plugin's setup permits configuring the button's
initial function and the time to switch to the respective other function.

When 'Restore' was pressed, the recordings menu displays deleted recordings
within the current directory and allows navigating to sub-directories in which
further recordings exist. Selecting a deleted recording, 'Green' will restore
it, whereas 'Yellow' will erase it on the disk. Pressing 'Blue', the recording
info can be displayed, which will also show the recording's remaining retention
time. Pressing 'Red' (Recordings) will return you to the active recordings.


Editing
-------------------------------------------------------------------------------
Renaming: Press 'Yellow', then 'Red'. Type in/edit the name. By pressing 'Ok'
renaming will be executed.

Moving: Press 'Yellow', then 'Green'. Now you are at the base directory of the
/video directory hierarchy. 'Ok' opens sub-directories, with 'Yellow' you can
create new directories. Pressing 'Blue', the relocation to the selected directory
will be executed.

Details: Select a recording, press 'Yellow', then 'Blue'. In this menu you can
edit the lifetime and priority of the selected recording. Editing the details
of archive DVD entries is not possible, because this would change the name by
which the recording is found on the disc.

Cutter queue
-------------------------------------------------------------------------------
With the build-in cutter queue you don't have to wait until an editing process
ended before you can start a new one. This only works if you start the editing
process from a replayed recording that was started via the plugin.

Canceling of editing or move processes
-------------------------------------------------------------------------------
Mark the entry, press 'Yellow'.

Sort recordings
-------------------------------------------------------------------------------
All directories are sorted by date by default. To change the sorting, simply
press '0'. Ascending or descending sorting is selectable at plugin's setup
menu.

-------------------------------------------------------------------------------
DVDArchive-patch functionality
-------------------------------------------------------------------------------
Burn the entire directory that contains the recording to a DVD and label it
with an identifier (a number or anything else). At least the *.rec folder has
to be on the DVD, because the recording is identified by this. You can, of
course, burn more than one recording to a DVD.

Now you can delete the video data files (PES: 001.vdr, 002.vdr, ..., marks.vdr,
resume.vdr; TS: 00001.ts, 00002.ts, ..., marks, resume) from your hard disc.
Leave the index.vdr and info.vdr (PES) / index and info (TS) in the directory.
The file index.vdr (PES) / index (TS) is needed if you want the length of the
recording displayed. You can also use 'getlength' from the tools/ directory to
create a length.vdr, containing the length of the recording. If you did this,
you can also delete index.vdr (PES) / index (TS).

Create a new file dvd.vdr that contains the identifier of the DVD. If you now
call the plugin and select such a recording entry, you are asked to insert this
DVD. It will be mounted by the plugin and the replay starts from the DVD. After
replay ends, the DVD is unmounted instantly.

You can also include normal video DVDs to your recordings hierarchy. Create a
folder with the name of the DVD. In this folder, create another one with
following name scheme: DD-MM-YY.hh.mm.pr.li.rec. The letters have following
meanings: DD - day (01-31), MM - month (01-12), YY - year (00-99), hh - hour
(00-23), mm - minutes (00-59), pr - priority (00-99), li - lifetime (00-99).
(Example: 01-01-06.20.15.50.99.rec) You must use this name scheme, so that VDR
identifies the folder as a recording. Now create in this folder a file dvd.vdr.
The first column contains the DVD ID, in the second column write 0000 (or
anything else, its only important that there is a second column). This
identifies the DVD as a video DVD. If you now select such a recording in the
list, you are asked to insert the DVD and after confirming this the DVD-plugin
is started to play the video DVD.
