Remote-Timer-Plugin
===================

Version: 1.3
Stand: 12.03.2006
Autor: rich

Funktion:
---------
Das Plugin wurde entwickelt, um mit einer Masterbox den Aufnahmetimer von bis zu 9 Remote-Boxen zu steuern. Dies ist sehr ntzlich, wenn man die Remote-Boxen in einem anderen Raum stehen hat. Somit braucht man bei den Aufnahmen, die man auf den anderen Boxen programmieren will, nicht mehr dort hinzulaufen. Das Plugin ist somit eine groe Erleichterung, wenn man Aufnahmen ber Streamingserver, Videorekorder oder Direktaufnahmen mit mehreren Boxen machen will. So kann man eine Sendung auf einer Remote-Box aufnehmen, whrend man sich gleichzeitig eine andere Sendung auf der Masterbox ansehen kann. Weiterhin ist es auch sehr praktisch, wenn man eine zweite Box als Aufnahmebox im gleichen Raum stehen hat, und bei ihr fr die Aufnahmeprogrammierung die Fernbedienung gesperrt bleiben kann.

Einschrnkungen:
----------------
Das Remote-Timer-Plugin funktioniert nur mit Sendern die auf der entsprechenden Remote-Box an Hand ihrer Senderliste auch empfangbar sind. Unter Enigma luft dieses Plugin nicht. 

Voraussetzung:
---------------
Es werden mindestens zwei ber Netzwerk verbundene Dboxen bentigt. Auf diesen Boxen muss ein mglichst aktuelles Neutrino-Image mit den Befehlen cut, sed, cat und grep in der busybox  installiert sein. Auerdem sollte auf der entsprechenden Remote-Box der gewnschte Sender an Hand ihrer Senderlisten empfangbar sein. Um mit ihr kommunizieren zu knnen, muss die Remote-Box in Betriebszustand oder mindestens in Standby stehen. Das Remote-Timer-Plugin muss nur auf der Masterbox installiert werden und bentigt neben dem Shellexec-Plugin (Flexmen) noch das Messagebox-Plugin und das Input-Plugin.

Installation:
-------------
Wie schon beschrieben, mssen auf der Masterbox das Flexmen, die Messagebox und das Input-Plugin installiert werden. Lest Euch dazu die entsprechenden readme.txt durch. Das Plugin muss nur auf der Masterbox installiert werden. Auf den Remote-Boxen sind keine nderungen ntig.

Bentige Dateien, Speicherorte und Rechtevergabe:

shellexec.so /var/tuxbox/plugins/ 755
shellexec.cfg /var/tuxbox/plugins/ 644
shellexec /var/plugins/ 755
shellexec.conf /var/tuxbox/config/ 644

msgbox /var/bin/ 755
input /var/bin/ 755

remote_timer.sh /var/plugins/ 755

Auerdem mssen in die shellexec.conf die Eintrge eingefgt werden, die im Archiv '/var/tuxbox/config/in shellexec.conf' einfgen stehen. Diese nderungen mssen mit einem Unix-kompatiblen Editor z.B. Crimson Editor oder Ultraedit gemacht werden.
Fr den Start des Plugins ber shellexec.conf wird die folgende Einstellung empfohlen.

FONT=/share/fonts/micron_bold.ttf
WIDTH=500
HIGHT=500
FONTSIZE=17
LINESPP=18
PAGING=1
KILLEPG=0

Ab dem FlexMen Version 2.06 ist das mglich den EPG-Sectionsd durch setzen von 'KILLEPG=1' im Hintergrund zu beenden, dieser ist aber fr das Einlesen der EPG-Daten notwendig. In diesem Fall sollte das Remote-Timer-Plugin direkt ber die 'Blaue Taste' gestartet werden. Siehe Anleitung 'Start von Remote-Timer-Plugin ber die blaue Taste' am Ende dieser readme.txt


Bedienungsanleitung:
====================

Wird das Plugin ber 'Remote-Timer-Plugin' gestartet, so taucht ein neues Menfenster mit folgenden Menpunkten auf.

----------------------------------
Sendung fr Aufnahme auswhlen...
Remote-Box Timerbersicht...
----------------------------------
Aufnahme der laufenden Sendung
Aufnahme der folgenden Sendung
----------------------------------
Remote-Box Bedienfunktionen...
----------------------------------
Remote-Box 192.168.0.24
Remote-Box 192.168.0.25
Remote-Box 192.168.0.26
----------------------------------
Plugin Einstellungen...
----------------------------------

Ist der Menpunkt 'Plugin Einstellungen...' im ersten Fenster nicht zu sehen, wird mit der Pfeil-rechts-Taste oder Pfeil-links-Taste das Fenster gescrollt bis dieser taucht. Die Menpunkte 'Remote-Box 192.168.0.24' usw. sind erst verfgbar, wenn die entsprechenden Remote-Boxen ber den Menpunkt 'Neue Remote-Box hinzufgen...' konfiguriert wurden. Dieser Menpunkt ist ber das Men 'Plugin Einstellungen...' erreichbar.

Beschreibung der Menpunkte:
============================
Zuerst sollte das Plugin ber Menpunkt 'Plugin Einstellungen...' eingestellt werden. Die Einstellungen werden in den Dateien remote_timer.conf und remote_box.conf unter /var/tuxbox/config/ gespeichert.

Plugin Einstellungen...:
----------------------------------
Remote-Box Adresse einstellen...: Hier wird die Remote-Box IP/Web-Adresse und falls ntig ihre Zugangsdaten eingestellt. Bei der Steuerung einer Remote-Box ber das Internet kann ihre Web-Adresse nach dem Muster 'name.dyndns.org:port' eingegeben werden. Das Remote-Timer-Plugin greift auf den Port 80 der Remote-Box zu und kann bei dem Zugriff ber das Internet mittels eines Routers auf einen beliebigen freien Port umgeleitet werden.
Maximale Anzahl EPG-Datenstze...: Hier wird die maximale Anzahl der EPG-Eintrge fr die Vorschauliste eingestellt.
Ansicht der EPG-Vorschau...: Hier wird eingestellt, ob die EPG-Vorschauliste ein- oder zweizeilig sein soll. Bei Option 3 und 5 werden die Sendungen die zum Zeitpunkt des Einlesens schon beendet sind farblich markiert. Option 4 und 6 blendet die beendeten Sendungen aus.
Farbe Senderwahl - Manueller Timer...: Hier kann die Farbe der Senderauswahl fr die "Manuelle Timer-Programmierung..." eingestellt werden.
Schriftgre fr EPG-Info...: Hier kann die Schriftgre fr das EPG-Info Fenster zur Vermeidung von berschneidungen des Textes durch die Fenstergre verndert werden. (Default-Wert 29)
Plugin-Timeout...: Hier wird die Zeit in Sekunden eingestellt, nach denen das Plugin eine Abfrage an die Remote-Box abbricht.
-----------------------------------
Config-Datei anzeigen...: Hier werden die aktuellen Einstellungen der remote_timer.conf angezeigt.
Reset > Remote-Timer-Plugin: Hier werden die Dateien remote_timer.conf und remote_box.conf gelscht.
-----------------------------------
Maximale Anzahl Remote-Boxen...: Hier kann die maximale Anzahl der Remote-Boxen eingestellt werden.
Neue Remote-Box hinzufgen...: Hier kann die IP/Web-Adresse, der Name und falls ntig ihre Zugangsdaten einer weiteren Remote-Box zur Auswahl hinzugefgt werden. Im Name sind keine ",*" und am Zeilenanfang keine "+-" zugelassen.
-----------------------------------
Remote-Box 192.168.0.24 usw. Diese Menpunkte tauchen nur auf wenn die entsprechenden Remote-Boxen hinzugefgt wurden. Mit diesen Eintrgen kann die aktive Remote-Box ausgewhlt werden. Es ist gegebenenfalls nach unten zu scrollen.
-----------------------------------


Sendung fr Aufnahme auswhlen...:
----------------------------------
Bouquet/Sender auswhlen...
Manuelle Timer-Programmierung...
Aktueller Sender/EPG-Daten einlesen
Schlsselwort suchen...

Mit 'Bouquet/Sender auswhlen...' werden alle auf der Box gespeicherten Bouquets eingelesen. Dann kann mit den Pfeiltasten aus der Bouquetliste das gewnschte Bouquet ausgewhlt werden. Mit der OK-Taste werden danach alle Sender des Bouquets angezeigt. Danach kann mit der OK-Taste der gewnschte Sender ausgewhlt werden. Nun werden alle EPG-Daten des Senders angezeigt. Sind fr den Sender keine EPG-Daten verfgbar, so wird dies in einer Fehlermeldung angezeigt. Ist der ausgewhlte Sender nicht der Aktuell eingestellte, kann es vorkommen, dass fr diesen noch keine EPG-Daten vorliegen, hierzu sollte auf diesen Sender umgeschaltet werden. Dies wird mit 'Plugin beenden > Umschalten' erleichtert. Nun muss noch mit 'Aktueller Sender/EPG-Daten einlesen' eingelesen werden. Sind EPG-Daten vorhanden kann die gewnschte Sendung ausgesucht werden, mit Druck auf die OK-Taste kann ber ein Auswahlmen der Timer direkt an die ausgewhlte Remote-Box bertragen werden oder zuvor noch ber 'EPG-Info...' die Information zur Sendung abgerufen werden. Dies wird in einer Messagebox angezeigt. Sollte die Remote-Box nicht erreichbar oder der gewhlte Sender in ihrer Senderliste nicht verfgbar sein, wird eine entsprechende Fehlermeldung angezeigt. Mit Home wird wieder ins Hauptmen zurckgesprungen.
Mit 'Manuelle Timer-Programmierung...' kann der Remote-Timer der gewhlten Box manuell gesetzt werden. Dies ist fr Sender ohne EPG-Daten oder individuelle Timer-Zeiten ntig. Zuerst wird der eingestellte Sender fr die Aufnahme angezeigt, von hier kann man noch falls ntig zu einer speziellen Bouquet/Senderwahlen fr den Manuellen Timer springen um den eingestellten Sender zu ndern. Mit 'Weiter...' werden zuerst die Start-Daten abgefragt und mit "OK" geht es zu den Stopp-Daten, es ist notwendig alle Kstchen falls ntig auch mit fhrenden Nullen auszufllen. Danach werden noch die Einstellungen fr die Wiederholungen des Timers abgefragt. Eine Prfung auf realistische Daten wird nicht durchgefhrt. Danach wird eine bersicht zur Kontrolle angezeigt, diese muss noch mit 'Timer setzen' besttigt werden. Bei der Manuelle Timerprogrammierung wird die Start/Stopp-Korrektur von Neutrino nicht bercksichtigt.
Mit 'Aktueller Sender/EPG-Daten einlesen' werden die EPG-Daten des aktuellen laufenden Senders eingelesen. Hier kann ebenfalls die gewnschte Sendung ausgesucht werden, mit der OK-Taste kann ber ein Auswahlmen der Timer direkt an die eingestellte Remote-Box bertragen werden oder zuvor noch ber 'EPG-Info...' die Information zur Sendung abgerufen werden. Dieses Ausgabefenster ist auf maximal 4 Seiten begrenzt.
Mit 'Schlsselwort suchen...' kann bei Vorhandensein von EPG- oder Bouquet/Sender-Daten in der darunter liegenden Liste nach Schlsselwrtern gesucht werden. Bei gefundenen bereinstimmungen werden diese am Anfang dieser Liste zur Auswahl eingefgt. Fr die Suche sind mindesten 3 Zeichen notwendig. Zulssige Zeichen sind a-z A-Z 0-9  .  :  -  + das 'Komma' wird bei der Suche durch ein Leerzeichen ersetzt und * wird als Platzhalter fr ein beliebiges Zeichen verwendet.


Remote-Box Timerbersicht...:
---------------------------------
Beim Aufruf dieses Menpunkts wird 'Remote-Timer einlesen' angezeigt. Wird dieser aufgerufen so wird die Timerliste der ausgewhlten Remote-Box angezeigt. Sind keine Timerdaten auf der Remote-Box programmiert, bzw. ist diese nicht erreichbar, so wird dies ebenfalls angezeigt. Sind Timer auf der Remote-Box vorhanden, so knnen diese ausgewhlt und mit der OK-Taste und folgender Besttigung mit 'Lschen' gelscht werden. Bei Aufnahme-Timern knnen die Daten mit 'ndern...' bearbeitet werden und mit 'EPG-Info...' wird die Information zur Sendung abgerufen. Das EPG-Ausgabefenster ist auf maximal 4 Seiten begrenzt. Bei Vorhandensein von weiteren Remote-Boxen, die ber den Menpunkt 'Remote-Box hinzufgen...' angelegt werden knnen, wird noch die Schaltflche 'Kopie...' sichtbar. Hiermit kann der gewhlte Aufnahme-Timer zur Organisation der Aufnahmen auf eine andere Remote-Box, die Master-Box bzw. von der Master-Box auf eine Remote-Box kopiert werden. Bei erfolgreicher Kopie kann im nachfolgenden Info-Fenster der Original-Timer noch gelscht werden.

Aufnahme der laufenden Sendung:
---------------------------------
Damit wird als "Sofortaufnahme" die auf der Master-Box laufende Sendung mit der eingestellten Remote-Box aufgenommen. Diese wird dabei auf den laufenden Sender der Master-Box umgeschaltet. Dies funktioniert aber nur, wenn der Sender ber EPG-Daten verfgt. Ist dies nicht der Fall, ist es von hieraus mglich auch den Timer manuell zu programmieren.


Aufnahme der folgenden Sendung: 
---------------------------------
Damit wird die folgende Sendung, des auf der Masterbox eingestellten Senders, mit der eingestellten Remote-Box aufgenommen. Die Remote-Box wird dabei zu Beginn der Sendung auf den entsprechenden Sender umgeschaltet. Dies funktioniert aber nur, wenn der Sender ber EPG-Daten verfgt. Ist dies nicht der Fall, ist es von hieraus mglich auch den Timer manuell zu programmieren.


Remote-Box Bedienfunktionen...:
---------------------------------
Remote-Box Aufnahme starten...: Mit diesem Menpunkt wird auf der Remote-Box eine Aufnahme mittels Timersteuerung fr den laufenden Sender der Master-Box gestartet. Die Dauer der Aufnahme kann in Minuten festgelegt werden.
Aktive Timer-Aufnahme stoppen...: Mit diesem Menpunkt wird geprft ob auf der Remote-Box zurzeit eine Timer-Aufnahme luft. Diese kann durch einfaches 'Lschen' gestoppt werden.
---------------------------------
Sender der Remote-Box abfragen...: Mit diesem Menpunkt kann der zurzeit eingestellte Sender der Remote-Box abgefragt werden. Mit 'Umschalten' wird dieser auf der Master-Box bernommen.
Sender der Master-Box bergeben...: Mit diesem Menpunkt kann der zurzeit eingestellte Sender der Master-Box mit 'Umschalten' an die Remote-Box bergeben werden.
---------------------------------
FB der Remote-Box sperren: Mit diesem Menpunkt wird die Fernbedienung der ausgewhlten Remote-Box gesperrt. Dieser Menpunkt ist recht ntzlich, damit auf der Remote-Box nicht herumgezappt werden kann. Das Sperren der Fernbedienung wird auf dem Display der Remote-Box mit einem entsprechenden Symbol angezeigt, wenn versucht wird, diese zu bettigen.
FB der Remote-Box freigeben: Mit diesem Menpunkt wird die Fernbedienung der ausgewhlten Remote-Box wieder freigegeben.
Remote freigeben & Master sperren: Hier wird die Fernbedienung der Remote-Box freigegeben und die der Master-Box gesperrt. Dies ist ntzlich wenn man zwei gleiche Boxen in einem Raum stehen hat, hierdurch ist es einfacher mglich zwischen diesen in der Bedienung zu wechseln. Eine Abfrage ber das Sperren der Fernbedienung auf der Master-Box sollte nicht besttigt werden, da in diesem Moment die der Remote-Box schon aktiv ist. Um das Umschalten zwischen den Fernbedienungen wieder rckgngig zu mache, kann auf der Remote-Box ebenfalls das Remote-Timer-Plugin installiert werden.
---------------------------------
Remote-Box von Standby einschalten: Damit wird die ausgewhlte Remote-Box in Standby geschalten.
Remote-Box in Standby ausschalten: Damit wird die ausgewhlte Remote-Box wieder eingeschaltet.
Remote-Box ausschalten: Damit wird die ausgewhlte Remote-Box ausgeschaltet. Danach ist die Kommunikation mit dieser Remote-Box ber das Netzwerk nur nach manuellen wieder Einschalten mglich.
Remote-Box neu starten: Mit dieser Funktion kann die ausgewhlte Remote-Box neu gestartet werden. Voraussetzung ist ein Image ab dem 10.12.2005.


Remote-Box 192.168.0.24 usw.:
-----------------------------
Mit diesem Menpunkt wird die entsprechende Remote-Box ausgewhlt. Die aktuell ausgewhlte Remote-Box ist farblich abgesetzt und kann nicht ausgewhlt werden.



Start von Remote-Timer-Plugin ber die blaue Taste
==================================================
Um die Installation von Remote-Timer-Plugin noch etwas zu erleichtern, kann auch ein Menpunkt direkt unter der blauen Taste eingefgt werden. In diesem Fall ist der Eintrag in /var/tuxbox/config/shellexec.conf nicht ntig. 

Installation:
-------------
Bentige Dateien, Speicherorte und Rechtevergabe:

remote_timer.cfg  /var/tuxbox/plugins/ 644
remote_timer.flx  /var/tuxbox/plugins/ 644
remote_timer.so  /var/tuxbox/plugins/ 755
remote_timer  /var/tuxbox/plugins/ 755

remote_timer.sh /var/plugins/ 755

Nach dem kopieren der Dateien in das Verzeichnis /var/tuxbox/plugins/ und der Rechtevergabe, mssen diese noch geladen werden. Hierzu bitte  d-box Taste > Service > Plugins neu laden ausfhren.


Viel Spa mit diesem Plugin.
rich
