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

Written by:                  Jörg Wendel (Horchi)
Project's homepage:          http://www.jwendel.de
Latest version available at: http://www.jwendel.de
See the file COPYING for license information.

PIN Plugin:
-----------
Das Plugin schützt ausgewählte Aufnahmen, Kanäle, Sendungen und Shell-Skripte vor Kindern.
Der 4-stellige numerische PIN (der Default ist 1984) kann im Plugin-Setup Menü eingestellt werden.
Das freischalten mittels des PIN Codes erfolgt über den Menüpunkt 'Kinderschutz' im Hauptmenü.
Der Code wird nach jedem Neustart zurückgesetzt. Die Sperre kann jederzeit mit dem entsprechenden 
Menüpunktes oder auch automatisch nach einer einstellbaren Zeit wieder aktiviert werden.

Es werden Aufnahmen in deren Ordner sich die Datei 'protection.fsk' befindet geschützt. 
Hierzu 'Aufnahmen->Befehle' - 'FSK Schutz hinzufügen' oder 'FSK Schutz entfernen' wählen. 
Kanal- und Sendungs-Sperren werden über das Plugin-Menü verwaltet.

Zum Schutz von Shell-Skripten dient das Tool fskcheck, dieses stellt ein Shell-Interface zum 
PIN Plugin dar. Hierüber kann aus Skripten bzw. von der Kommandozeile abgefragt werden ob der 
Kinderschutz gerade aktiviert ist. Auch OSD Meldungen können mittels fskcheck angezeigt werden. 
Ein Beispiel Skript hierzu ist im Ordner scripts enthalten.

Es werden VDR Versionen ab 1.3.47 incl. 1.4.0 unterstützt. Es sollte, ggf. mit kleinen Anpassungen, 
auch mit etwas älteren Versionen funktionieren.

Installation:
-------------

 Plugin in .../VDR/PLUGINS/src/ 
 auspacken und den Link anlegen.

 PIN-Patch auf den VDR anwenden. Das Patch ist für die VDR Version 1.3.44 enthalten (vdr-1.3.44-plain.diff). 
 Für andere VDR Versionen gibt es möglicherweise Rejects, diese dann bitte von Hand auflösen oder
 mir melden, dann stelle ich (wenn's die Zeit hergibt) ein Patch für die gewünschte Version bereit.

 > Achtung bei Verwendung des Bigpatch in Version vdr-1.3.44-bigpatch-test2.tar.bz2:
 > In diesem Bigpatch ist bereits eine ältere Version enthalten. Daher, um
 > auf den aktuellen Stand des PIN-Patches zu kommen, nach dem Bigpatch das Patch 
 > vdr-1.3.44-with-bigpatch-test2.diff anwenden.
 > Ab Bigpatch Version vdr-1.3.45 wir kein weiterer Patch benötigt.

   cd /usr/src/VDR
   cat PLUGINS/src/pin/patches/vdr<version>.diff | patch
   make clean
   make [REMOTE=LIRC ...]
  
 und (linvdr) nach /usr/bin/... kopieren. Bei anderen Distributionen entsprechend.

 Plugins neu übersetzen

   make plugins

 und (linvdr) nach /usr/lib/vdr/plugins/.. kopieren. Bei anderen Distributionen in das entsprechende Verzeichnis.

 Nun noch das Skript fskprotect.sh und das tool fskcheck in den Suchpfad (PATH) z.B.: '/usr/local/bin' oder '/usr/bin' 
 kopieren und in die Konfigurationsdatei reccmd.conf eintragen. 

    Beispiel:

    cp -p /usr/src/VDR/PLUGINS/src/pin/scripts/*.sh /usr/bin
    cp -p /usr/src/VDR/PLUGINS/src/pin/fskcheck /usr/bin
    echo 'FSK Schutz hinzufügen: /usr/bin/fskprotect.sh protect'   >> /etc/vdr/reccmds.conf
    echo 'FSK Schutz entfernen:  /usr/bin/fskprotect.sh unprotect' >> /etc/vdr/reccmds.conf
