EPGScheduler
Version 1.2
Der EpgScheduler ermöglicht es, Aufnahmen mit der Hauppauge WinTV PVR
(250/350/USB) Karte über das Internet mit dem EPG Dienst
von tvtv.de zu programmieren.
Gegenüber dem von Hauppauge angebotenen hcw_tvtv Scheduler
kann der EpgScheduler auch mit Programmnummern statt nur mit
Kanalnummern umgehen und ermöglicht es, die Aufnahme einige Minuten
vor der angegebenen Uhrzeit zu starten und über das Ende hinaus
aufzunehmen, um die Sendung auch bei leichten Zeitverschiebungen
vollständig aufnehmen zu können.
EPGScheduler wurde in Java geschrieben und ist freie Software unter
der GNU General Public Licence (GPL).
Wichtig!
Wer beim Start von EPGScheduler die Fehlermeldung "Kann den Pfad
von SyncIt in der Registry nicht finden!" bekommt, hat vermutlich
bereits die neue Version von Hauppauge hcw_tvtv installiert, die nicht
mehr SyncIt verwendet. Durch die Installation von SyncIt
sollte der Fehler behoben werden.
Download
epgscheduler1_2.zip
Installationsanleitung
Voraussetzungen
Die original EPG Software von Hauppauge (zu finden unter
http://www.hauppauge.de/sw_wintv-epg.htm) bestand ursprünglich aus
zwei Programmen: tvtvSync zur Übertragung der Daten von der tvtv.de
Webseite auf den Rechner und hcw_tvtv, dem Scheduler der anhand der
übertragenen Daten Einträge für den Windows Task Scheduler erzeugt.
Der EpgScheduler ersetzt nur den hcw_tvtv Scheduler, d.h. das tvtvSync
Programm muß weiterhin installiert sein.
Inzwischen gibt es von Hauppauge eine neue Version des hcw_tvtv
Schedulers, die nicht mehr auf tvtvSync basiert und eine neue tvtv.de
Programmschnittstelle verwendet. EPGScheduler ist mit dieser Version
nicht kompatibel!
Wer tvtvSync noch nicht installiert hat, kann das Programm unter
folgender URL bekommen:
http://www.steffensiebert.de/soft/epgscheduler/tvtvsync-de.exe
Sollte auch der alte hcw_tvtv Scheduler installiert sein, kann er
deinstalliert werden. Es ist aber auch möglich, ihn vorerst
installiert zu lassen, er darf aber nicht gleichzeitig mit dem
EpgScheduler laufen, sollte also vorher beendet werden.
Da der EpgScheduler in Java geschrieben ist, benötigt er eine
installierte Java Runtime Umgebung, vorzugsweise in der Version 1.3.
Falls noch keine Java Runtime Umgebung installiert ist, kann diese
kostenlos unter folgender URL bezogen werden:
http://java.sun.com/j2se/1.3/download.html
Installation
Wenn sowohl tvtvSync als auch die Java Runtime Umgebung installiert
sind, kann der EpgScheduler installiert und gestartet werden. Dazu
wird das Installation-Zipfile in einem leeren Verzeichnis ausgepackt.
Konfiguration
Im Installations-Verzeichnis muß eine Datei namens dbchannel.dat mit
einem Texteditor wie z.B. notepad erzeugt werden. In dieser Datei
werden die Programmnamen wie sie tvtv.de übermittelt den in WinTV
verwendeten Kanalnummern zugeordnet.
Eine solche Datei wird auch vom hcw_tvtv Scheduler benutzt, wer also
für diesen die Datei schon angelegt hat, braucht sie nur in das
EpgScheduler Verzeichnis kopieren.
Format der Konfigurationsdatei
Die Schreibweise der Programme wie sie tvtv.de übermittelt findet man
in der XML Datei channels.xml, die nach der ersten Synchronisation in
einem Unterverzeichnis des SyncIt Programms erstellt wird. Beim
Erstellen der dbchannel.dat Datei ist darauf zu achten, daß man die
Schreibweise inklusive Groß-/Kleinschreibung der Programme exakt aus
der channels.xml Datei übernimmt.
In der einfachsten Variante enthält die dbchannel.dat Datei die
Kanalnummer, gefolgt von einem Komma und dem Programmnamen:
8,ARD
12,ZDF
Dies ist das Format, welches vom hcw_tvtv Scheduler verwendet wird.
Der EpgScheduler versteht dieses Format auch, es kann aber auch ein
erweitertes Format benutzt werden.
Zum einen ist es möglich statt der Kanalnummer auch die Programmnummer
zu verwenden. Dazu wird einfach die Option "-p" vor die Programmnummer
gesetzt:
-p1,ARD
Da die WinTV PVR Karte kein VPS Signal auswertet und viele Sender
nicht auf die Sekunde genau ihre Sendungen beginnen, kann man auch
angeben, wieviele Minuten vor Sendungsbeginn mit der Aufnahme begonnen
werden sollen und wieviele Minuten die Aufnahme über das Programmende
hinaus laufen soll.
Beispiel:
8,ARD,3,5
Damit werden alle Aufnahmen von Sendungen der ARD 3 Minuten vor dem
Beginn gestartet und 5 Minuten nach dem Ende gestoppt. Wenn man mit
diesen Einstellungen die Tagesschau (20.00 Uhr bis 20.15 Uhr)
programmiert, startet die Aufnahme um 19.57 Uhr und endet um 20.20
Uhr.
Wenn keine Werte oder der Wert -1 angegeben ist, wird für den Sender
ein Default verwendet.
Diesen Default-Wert setzt man, indem man eine Zeile für einen Sender
mit dem Namen <default> in die Datei einfügt:
0,<default>,2,4
Alle Sender, für die kein Wert angegeben ist, beginnen somit 2 Minuten
vorher und enden 4 Minuten später.
Wenn keine Zeile mit den Default-Werten angegeben ist, wird für beide
Werte 0 Minuten angenommen.
Normalerweise ist bei der Aufnahme mit WinTV die Audio Ausgabe
aktiviert. Soll die Aufnahmen stumm erfolgen, muß man einen Sender mit
dem Namen <mute> definieren, bei dem man für den Kanal ein 'y'
eintraegt:
y,<mute>
Propertydatei
Weitere EpgScheduler Optionen werden über die Datei
epgscheduler.properties im Programmverzeichnis gesteuert:
Wenn die Property deleteSchedules=true ist, können bereits
programmierte Tasks über tvtv.de wieder gelöscht werden.
Wenn die Property createCleanupTask=true und cleanupTaskCommand
definiert ist, wird 1 Minute nach dem Ende der Aufnahme ein weiterer
Task mit dem in cleanupTaskCommand angegebenen Programm gestartet. Mit
einem geeigneten Skript kann z.B. WinTV beendet und der Rechner in den
Suspend Modus heruntergefahren werden.
Wenn die Property useWakeupFlag=true , dann wird bei den Aufnahmetasks
die Option den Rechner aus dem Suspend Mode aufzuwecken gesetzt.
Mit den Properties recordingApplication und recordingParameters kann
man sowohl die zur Aufnahme verwendeten Parameter ändern als auch ein
anderes Programm als WinTV2000 definieren (z.B. Wintvcap).
Programmstart
In einem Kommandozeilenfenster in das EpgScheduler Verzeichnis
wechseln und die Datei EpgScheduler.bat ausführen. Der Scheduler
sollte jetzt starten und einige Informationsmeldung ausgeben. Wenn
bereits Programmdaten vorliegen, werden die entsprechenden Aufnahmen
im Scheduler programmiert.
Wenn man nun auf der tvtv.de Webseite neue Aufnahmen programmiert und
überträgt, erzeugt der EpgScheduler entspechende Einträge im
Scheduler.
Das Programm kann jederzeit mit der Tastenkombination Control-C
beendet werden.
Bugreport
Wenn das Programm sich selber beendet oder Fehlermeldungen ausgibt,
die man nicht selber abstellen kann, sollte man folgende Informationen
und Dateien als Bugreport per Mail an epgscheduler@steffensiebert.de
schicken:
- Informationen über den Computer, insbesondere das benutzte
Betriebssystem.
- Informationen über die installierte Java Runtime Version. Die
Aufruf von "java -version" gibt die notwendigen Werte aus.
- Die Dateien dbchannel.dat und playlist.xml
- Die Logdatei epgsched.log
- Eine möglichst ausführliche Beschreibung, wie sich der Fehler
äußert und unter welchen Bedingungen er auftritt.
Verwendete Java Bibliotheken
Links
MSDN: Monitoring Changes in a Directory or Directory Tree
|