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

Version: 2.0.7
Stand:   09.01.2011
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.
Das Plugin ab der Version 2.0.4 setzt bei allen beteiligten Boxen ein Neutrino-Image mit dem yWeb-IF ab der Version 2.1.2 und dem Web-Server ab Version 3.0.5 voraus.

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 muss in die shellexec.conf der Eintrag eingefgt werden, der im Archiv bei '/var/tuxbox/config/in shellexec.conf einfgen' steht. Diese nderung muss mit einem Unix-kompatiblen Editor z.B. Crimson Editor oder Ultraedit gemacht werden. Bei der bertragung der Dateien auf die DBox ist darauf zu achten, dass dies im Binr-Transfermode geschieht.

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 auftaucht. 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. Weiterhin wird hier festgelegt ob die Liste fr die Bouquet bzw. Senderauswahl der manuellen Timer-Programmierung von der Master- oder Remote-Box bezogen wird. Somit ist es auch mglich einen Timer fr Sender zu setzen, die auf der Masterbox nicht verfgbar sind.
Schriftgre fr Plugin-Men/EPG-Info...: Hier kann die Schriftgre fr die Men-Struktur in drei Abstufungen eingestestellt werden. Ebenfalls kann auch die Schriftgre fr das EPG-Info Fenster zur Vermeidung von berschneidungen des Textes durch die Fenstergre (OSD-Bildbereich) verndert werden. (Default-Wert 29)
Warnmeldung bei Timerprfung...: Hier wird die Zeit in Minuten eingestellt, bis zu der das Plugin bei dem Menpunkt 'Remote-Box Timer einlesen & berprfen' eine Warnung fr einen geringen Abstand der aufeinander folgenden Timer anzeigt soll.
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 Config-Dateien remote_timer.conf und remote_box.conf gelscht.
-----------------------------------
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. Ist die Maximalzahl von 9 Boxen erreicht wird bei dem hinzufgen einer neuen Remote-Box die jeweilig letzte Box aus der Liste entfernt.
Remote-Box(en) bearbeiten...: Hier knnen die mit 'Neue Remote-Box hinzufgen...' hinterlegten Remote-Boxen gelscht, in ihrer Position verschoben oder die dazugehrigen Einstellewerte verndert werden.
-----------------------------------
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. Nachfolgend werden die EPG-Daten des Senders eingelesen. 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 mssen noch nach Neustart des Plugins mit 'Aktueller Sender - EPG-Daten einlesen' die Daten 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. Diese Senderauswahl wird je nach Voreinstellung von der Master- oder Remote-Box bezogen. Hierdurch wird es z.B. mglich mit der D-Box2 auch Timer fr HDTV-Sender auf der Coolstream zu setzen. 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 verschiedenen Timerarten bzw. Wiederholungen abgefragt. Eine Prfung auf realistische Daten wird nicht durchgefhrt. Danach wird eine bersicht zur Kontrolle angezeigt, diese muss noch mit 'REC-Timer' besttigt werden. Bei der manuellen 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. Bei Vorhandensein von weiteren Remote-Boxen, die ber den Menpunkt 'Remote-Box hinzufgen...' angelegt werden knnen, wird noch die Schaltflche 'Ziel-Box...' sichtbar. Hiermit kann der Timer auch direkt an die in dem Auswahlfenster aufgefhrten Remote-Boxen bergeben werden.
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...:
---------------------------------
Mit 'Remote-Timer einlesen' 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. Bei der Fehlermeldung das die Remote-Box nicht antwortet sollte berprft werden ob bei der Einstellung fr die IP/Web-Adresse kein Fehler vorliegt. Eine weiter Fehlerquelle ist auch ein fehlerhafte Einstellung der Zugangsdaten auf das Webinterface. 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. Dieses EPG-Ausgabefenster ist ebenfalls auf maximal 4 Seiten begrenzt. Bei Vorhandensein von weiteren Remote-Boxen, wird noch die Schaltflche 'Kopie...' sichtbar. Hiermit kann der gewhlte Aufnahme-Timer zur Organisation der Aufnahmen auf eine andere Remote-Box, die Master-Box oder von dieser auf eine Remote-Box kopiert werden. Bei erfolgreicher Kopie kann im nachfolgenden Info-Fenster der Original-Timer noch gelscht werden.
Mit 'Remote-Timer einlesen &  berprfen' kann zustzlich noch eine berprfung der gesetzten Timer durchgefhrt werden. Hierbei wird geprft ob sich benachbarte Timer berschneiden oder sehr kurz aufeinander folgen. Eine berschneidung wird durch "<< xx Min." und ein geringer Abstand durch "xx Min. >>" in Minuten angezeigt. Bei gesetzten Timern mit Wiederholungen wird nur deren nchste Ausfhrung bercksichtigt. Ist der erste Timer der Liste zum Zeitpunkt des Einlesens schon aktiv oder ist die Ausfhrung fr die nchste 60 Minuten vorgesehen wird dies durch "seit xx Min." oder "in xx Min." in Minuten angezeigt.

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 auch mglich die Aufnahme zu starten, dabei muss die Stopp-Zeit in Minuten manuell gewhlt werden.


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 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 muss 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 'Timer 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 aus Standby eingeschaltet.
Remote-Box in Standby ausschalten: Damit wird die ausgewhlte Remote-Box in Standby ausgeschalten.
Remote-Box ausschalten: Damit wird die ausgewhlte Remote-Box heruntergefahren bzw. 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 Auswahl - Bedienfunktionen...:
-----------------------------------------
Bei Vorhandensein von mehreren Remote-Boxen und der Mendatei '/var/tuxbox/config/remote_boxen.flx' aus dem Plugin-Archiv, wird noch der Menpunkt 'Remote-Box Auswahl - Bedienfunktionen...' angezeigt. Hiermit ist es mglich ber eine zwischengeschaltete Boxen-Auswahl direkt auf die Bedienfunktionen der einzelnen Remote-Boxen zuzugreifen.


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 nochmals 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 zustzlich ntig.

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

remote_timer.cfg  /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 (Men-Taste) > Service > Plugins neu laden ausfhren.


Start der Aufnahme ber die blaue Taste
=======================================
Diese Funktion ist eine direkte Mglichkeit die Sofortaufnahme der Remote-Box(en) zu starten und auch wieder zu stoppen.

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

boxen_rec.cfg  /var/tuxbox/plugins/ 644
boxen_rec.so  /var/tuxbox/plugins/ 755
boxen_rec  /var/tuxbox/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 (Men-Taste) > Service > Plugins neu laden ausfhren.


Viel Spa mit diesem Plugin.
rich
