MovieGuider 0.3.10.6

WICHTIG:
Net-Framework 1.1 wird fr die Funktion bentigt
Alle Dateien aus dem Archiv werden bentigt
Alte (vor Version 0.3) INI-Dateien funktionieren nicht mehr 

Kurze Einfhrung:


Server/Datei:	
~~~~~~~~~~~~~~~~~~~~~~~
Einstellungen fr den Downloadpfad der Guides

MovieGuide:
~~~~~~~~~~~~~~~~~~~~~~~			
Einstellung der Dateinamen online wie lokal(unter dem die bereinigte Datei gespeichert wird)

JtG:
~~~~~~~~~~~~~~~~~~~~~~~							
JtG:Unter-Tab JtG
---------------------------------------
Pfad zu Jack the Grabber, und auswhlen, ob der MovieGuider die Daten der 
mguide_d_s direkt in die Datenbank(intern.mdb) schreiben soll.
Daten nur nach 'Jetzt' eintragen: es werden nur Daten in die DB geschrieben,
deren Startzeitpunkt nach der aktuellen Uhrzeit liegen
Expert! aktiviert den Expert!-Tab zur Bearbeitung der PID-Tabelle von JtG

Diagnose starten: siehe unten (Hilfe:)

JtG:Unter-Tab udrec
---------------------------------------
udrec-Versionsprfung beinhaltet Funktionen zum prfen der aktuellen udrec Version.
Wenn der Pfad zu JtG richtig angegeben wurde und sich eine udrec.exe dort befindet,
wird die Version angezeigt. "Wenn online, udrec auf neue Version prfen" ruft den
Versionswert der aktuell verfgbaren udrec.exe ab. Optional kann man sich ber eine
Info-Box ber neuere Versionen informieren lassen. Die Abfrage wird entweder ber
"Ausgewhltes Profil starten" im [Profile]-Tab vor der Download-Anfrage des Movieguides
ausgelst oder im [JtG]-Tab mit "Jetzt prfen". "Jetzt prfen" fhrt die Abfrage unabhngig
von der gewhlten Einstellung "Wenn online, udrec...." durch.

JtG:Unter-Tab Expert!
---------------------------------------
Dieser Tab mu extra aktiviert werden. 
Hier kann die Tabelle "Pids" in der intern.mdb von JtG bearbeitet werden. Damit ist die
Funktion "Pids aus DB" etwas flexibler und die Pids knnen an die aktuellen Sender
angepasst werden.
Funktion:
DB einlesen: ntig, um nderungen vornehmen zu knnen
auf DBox prfen: prft auf der eingestellten IP(unter DBox) den ausgewhlten Sender und
trgt die ermittelten Werte in die Formularfelder ein
Kanal aus Liste: stellt eine Liste aller Sender auf der DBox zur Verfgung, durch anklicken
des gewnschten Senders werden die Werte in der DBox in die Formularfelder bernommen
hinzufgen: fgt der Tabelle einen neuen Datensatz zu
DB aktualisieren: berschreibt in der Tabelle die ausgewhlte KanalID
entfernen: entfernt die ausgewhlte KanalID aus der Tabelle
export: exportiert die gesamte Tabelle (Format csv:kanalid;name;vpid;apid1;apid2;apid3)
import: importiert eien Tabelle nach obigen Format
Der aktuelle Datensatz ist immer der in den Formularfeldern oben angezeigte.
										
Dateibearbeitung:
~~~~~~~~~~~~~~~~~~~~~~~	
Anders als in den Vorgngern wird in der Text-datei nicht mehr gelscht, jedoch kann man
Sender, welche nicht importiert werden sollen, angeben. Mehrere Sender ber ";" getrennt 
eingeben.
Beispiel:PREMIERE HD FILM;HEIMATKANAL;13TH STREET
Es knnen Text-Dateien oder Archive(Zip) als Eingabe-Datei verwendet werden.
Die Ausgabedatei kann hier unabhngig vom JtG-Verzeichnis angegeben werden
										
Optionen:
~~~~~~~~~~~~~~~~~~~~~~~
Hier kann man angeben, ob eine Kopie der aktuellen bereinigten Datei in einem Archiv- 
verzeichnis gespeichert werden soll. Bei mguide_d_s Dateien kann man die Option whlen,
das Start- und Endedatum im Dateinamen erweitert werden, ansonsten wird das Download-
datum eingefgt. Einmal vorhandene Dateien nicht neu angelegt oder berschrieben

Wird "Datei (zip)packen" gewhlt, so wird anstelle der Textdatei eine gepackte Version dieser gespeichert

"Textfragmente Monatsweise..." ist eine Hilfsfunktion um den Movieguide wieder in das
alte Format zu bringen, damit das Archiv vervollstndigt werden kann. Die Textfragmente
werden im "Pfad zu Fragmenten" gespeichert, welcher extra angegeben werden kann. Die 
Dateien werden im folgenden Format gespeichert:
mguide_split_[Datum]_[Nummer]_(vom[Startdatum des ersten Eintrags] bis [Startdatum des letzten Eintrages#Startzeit]).txt 
Beispiel:
	mguide_split_31072006_0_(vom 27-07-2006 bis 01-08-2006#05-45).txt
	mguide_split_31072006_1_(vom 01-08-2006 bis 01-09-2006#05-30).txt
	mguide_split_31072006_2_(vom 01-09-2006 bis 16-09-2006#05-55).txt
Der Monatsguide geht dabei vom 1. des Monats 06.00 Uhr bis 1. des Folgemonats 05.59 Uhr

Downloadgre prfen gibt an, ob die Dateigre auf dem Server mit der der zuletzt
geholten Datei verglichen wird. Sind beide gleich erfolgt eine Rckfrage. Im Autostart-
Modus wird der Download in diesem Fall nicht wiederholt.

Globale Optionen: Diese Optionen gelten fr alle Profile, Temporre Dateien lschen
bedeutet, das die angelegten Dateien gelscht werden:bei temporr laden -> mguide.tmp
im Temp-Verzeichnis und die .unzipped Dateien, falls ein Archiv entpackt wurde. Log
auch im 'Handmodus' schreibt die Logdatei immer beim Beenden des Programms.

Komprimiere intern.mdb:
Wenn viele Aktionen an der Datenbank vorgenommen werden, kann sich diese aufblhen.
MovieGuider komprimiert die Datenbank bei jedem Downlosd, hier kann dies manuell gestartet
werden.

ProjectX:
~~~~~~~~~~~~~~~~~~~~~~~

ProjectX:Unter-Tab ProjectX
---------------------------------------
Um ProjectX zu starten, mu der Haken bei "ProjectX starten" gesetzt sein
Um ein anderes Programm zu starten, mu der Haken bei "anderes Programm starten"
gesetzt sein, beides zusammen geht NICHT

Hier kann der Pfad zu ProjectX.jar angegeben werden, um MovieGuider als "bersetzer"
zwischen JtG und ProjectX zu schalten. Die mitgelieferte MovieGuider.jar ist dazu ntig.

Wichtig: ab Version 0.3.10.6 ist eine neue Version der MovieGuider.jar im Paket
Es funktioniert nur noch diese neue *.jar (Trennzeichen fr Pfade von ; auf |)

Wird MovieGuider nach der Aufnahme gestartet, wird wenn eine genpsi.exe im Movieguider-
Verzeichnis vorhanden ist, ein aufgenommener *.TS Stream fr die Verwendung mit
dem VLC gepatcht, so das diese mit dem VLC abspielbar sind. Das geschieht unabhngig
von allen ber das GUI eingestellten Parametern.
Eine genpsi.exe kann hier heruntergeladen werden:
http://www.movieguider.de/wp-content/plugins/wp-downloadMonitor/download.php?id=8
genpsi wurde gepatcht, damit es mit VLC funktioniert, nher beschrieben in diesem Beitrag:
http://www.jackthegrabber.de/viewtopic.php?p=100339#100339

Um diese Funktion zu nutzen ist folgendes ntig:
- Pfad zu ProjectX.jar im MovieGuider-GUI anlegen
- MovieGuider.jar -> zustzlich in das Verzeichnis von MovieGuider.exe
- Pfad zu ProjectX in JtG auf die MovieGuider.jar legen
Wichtig! Folgendes gilt NUR wenn DAR16:9 NICHT augewertet werden soll:
- X.ini im JtG-Verzeichnis gegen eine aktuelle tauschen

Unter X.ini kann man einen Pfad zu einer alternativen X.ini angeben, welche anstelle
der im JtG-Verzeichnis liegenden bergeben wird. Damit ist auch der Weg frei, um die
originale X.ini im JtG-Verzeichnis zu belassen und aus dieser den Wert fr DAR16:9 
auszulesen und auszuwerten. Das funktioniert nur mit einer X.ini im alten Format. Wenn
"Weitere X.ini wenn DAR16:9 ...." aktiviert ist, wird dieser Wert ausgelesen und falls
DAR16:9 in JtG aktiviert ist, wird die andere, auch hier anzugebende X.ini bergeben. 
Es ist brigens nicht von Bedeutung, wie die X.ini heit. 
Als praktisch empfinde ich z.B. "X-normal.ini" und "X-DAR169.ini", damit knnten beide
im selben Verzeichnis liegen. 

Wenn die Option "Ausgaben von ProjectX in JtG zeigen (zeitverzgert)" aktiviert
ist, dann bleibt der MovieGuider solange geffnet, bis ProjectX beendet wurde und
stellt die Ausgaben in der JtG Konsole dar.

ProjectX:Unter-Tab EPG.txt zu xml
---------------------------------------
Hier kann man einstellen, ob die von JtG generierte EPG.txt in eine fr
den Moviebrowser von Neutrino lesbare xml gewandelt wird. Dies geschieht automatisch
nach der Aufnahme, wenn der Haken  bei "xml aus EPG-Daten" gesetzt ist und in JtG
nach aufnahme ProjectX starten aktiviert ist(siehe oben). Diese Funktion liest die
EPG.txt und sofern vorhanden die LOG.txt aus, um bentigte Angaben fr die xml zu
erhalten. ber den Button "EPG-Daten konvertieren" ist eine nachtrgliche Umwandlung
von EPG.txt Daten mglich. Ausgewhlt sollte die TS oder sonstige Videodatei werden,
da diese den Dateinamen fr die xml liefert. Wird eine Text-Datei(.txt) ausgewhlt
nimmt MovieGuider diese als Datenquelle UND namengebende Quelle an.
Bei "_01 usw. aus Dateinamen entfernen" werden aus dem Dateinamen der .xml diese 
Kombinationen entfernt(z.B. die unglaublichen-1_00.ts -> die unglaublichen-1.xml)
Wird die Option "Titel aus Namen der Videodatei" gesetzt, wird der Titel in der
xml-Datei aus dem Dateinamen der Sendung erstellt. Der Name ergibt sich bis zum
letzten "-" im Namen. Dies hat den Vorteil, das nicht alle Titel in Grobuchstaben
geschrieben sind. Nachteil: alle Sonderzeichen sind aus dem Titel entfernt.
  Video: In einem Land vor unserer Zeit Das Geheimnis der kleinen Saurier-1_00.ts
  EPG.txt: IN EINEM LAND VOR UNSERER ZEIT: DAS GEHEIMNIS DER KLEINEN SAURIER
  aus Video-Namen: In einem Land vor unserer Zeit Das Geheimnis der kleinen Saurier
Vorsicht mit dieser Option beim wandeln von Text-Dateien: wird z.B. eine EPG.txt
direkt zum wandeln aufgerufen und die Option ist gesetzt, steht in der xml der
Titel EPG. Das ist sicher nicht erwnscht.

FilmDB aktualisieren:
Wird hier der Haken gesetzt, so wird in der intern.mdb nach der Aufnahme ein Eintrag
in der Tabelle "Filme" erstellt. Dies geschieht automatisch. Die Tabelle wird, wenn
nicht vorhanden, angelegt. Informationen werden so gut als mglich aus der LOG und
EPG.txt gelesen und die Eintrge entsprechend gesetzt. Zur Bearbeitung und/oder 
Betrachtung der Eintrge gibt es FilmDB, welches allerdings extra heruntergeladen 
werden mu.

ProjectX:Unter-Tab Weitere
---------------------------------------
Hier kann man angeben, ob beim Start des MovieGuider nach der Aufnahme durch
JtG ein http-Befehl an die DBox gesendet werden soll. Dazu mu der Haken bei 
"Anfrage an Box senden" gesetzt sein. Als Befehl setzt man die normalen nhttpd-
Funktionen ohne Angabe von Protokoll und IP. IP mu unter DBox eingetragen sein.
Mit dem Link: Testen kann der Befehl direkt gesendet werden(zum testen ;))
Beispiel: /control/rc?unlock - entsperrt die Fernbedienung der DBox
Beim Aufruf durch JtG wartet der MovieGuider 5 Sekunden, bevor das Kommando
gesendet wird.

ProjectX:Unter-Tab anderes Programm
---------------------------------------
Hier kann angegeben werden, welches Programm nach dem Aufruf der der MovieGuider.jar
gestartet werden soll, wenn "anderes Programm nach Aufnahme starten" aktiviert ist.
Pfad zum alternativen Programm: das zu startende Programm
untere Zeile: die Argumente fr das Programm, %1 bis %4 stellen die durch die Aufnahme
erstellten Dateien dar.

DBox:
~~~~~~~~~~~~~~~~~~~~~~~

DBox:Unter-Tab myservices.xml
---------------------------------------
Hier kann man eine myservices.xml erstellen, welche die Unterkanle verschiedener
Sender enthlt. siehe: http://wiki.tuxbox.org/Neutrino:Senderlisten#myservices.xml
ES FUNKTIONIERT NOCH NICHT ZUVERLSSIG WENN MEHRERE SATELLITEN IN DER SERVICES.XML SIND!
Zuerst mu die IP-Adresse der Box eingegeben werden. Dann wird ber den nhttp der
Zugriff auf die Webfunktionen der Box mglich. Vorgehensweise zum erstellen der .xml:
Sender holen -> Sender auswhlen -> Unterkanle abfragen -> ggf. weitere Sender 
abfragen -> gewnschte Sender auswhlen -> XML erstellen
Die Sender werden unter dem Namen des Senders + der entsprechenden Service-ID 
gespeichert(z.B.: "Direkt Feed 00d1"). Das kann unter "Optionen" angepasst werden. 
Die erstellte myservices.xml liegt dann im MovieGuider Verzeichnis. Diese
lt sich dann einfach mit dem yWeb bertragen oder einfach via FTP nach 
"/var/tuxbox/config/zapit" kopieren. Die Datei liegt im UNIX-Format vor.
ber den Button "Auto" kann eine automatische Suche der Unterkanle gestartet werden.
Diese Suche schaltet alle Kanle an der DBox durch und fragt die Unterkanle ab.
Dieser Vorgang dauert leider eine geraume Zeit, bis zu 2 sec. pro Sender.
Dabei schaltet die DBox alle Kanle durch.
Anschlieend wird wie oben beschrieben ein myservices.xml erstellt.
Whrend der Ausfhrung von "Auto" sind alle nhttp-Aufrufe aus dem MovieGuider
und Tabwechsel gesperrt und das Programm reagiert etwas trger. In der Status-
Leiste wird der Fortschritt angezeigt, noch zu durchsuchende Sender und die
Anzahl aller Sender. Am Schlu erhlt man eine Zusammenfassung ber die Anzahl der
gefundenen Unterkanle, der durchsuchten Sender sowie eine Angabe ber die bentigte
Zeit der Suche. Der Button "Auto" ndert whrend der Ausfhrung die Bschriftung
in "Stop". Damit kann die Erstellung der xml abgebrochen werden.
Ausgabe:
Datei erstellt: 
C:\MovieGuider\myservices.xml
Die Datei wurde nach Abfrage von 234 Sendern in 392 Sekunden erstellt!
Es wurden 19 Unterkanle gefunden!
Diese Funktionen erheben keinen Anspruch auf Vollstndigkeit, sie ist eher 
als Hilfe fr alle Benutzer gedacht, welche eine schnelle und einfache Lsung
bevorzugen. 

Der Wizard:
---------------------------------------
Der MyServices-Wizard fhrt durch die Erstellung der myservices.xml in 6 Schritten.
Es sollte alles ber den Wizard erklrt werden, deshalb hier keine weitere Erluterung.

DBox:Unter-Tab DBox-IP
---------------------------------------
Hier kann man die IP-Adresse der DBox eingeben, oder, wenn der Pfad zu JtG richtig
gesetzt ist, die Adresse aus JtG bernehmen

Diagnose starten: siehe unten (Hilfe:)

DBox:Unter-Tab Extras
---------------------------------------
Alles andere in diesem Tab ist zur Zeit noch "Design-Studie" ;)

Hilfe:
~~~~~~~~~~~~~~~~~~~~~~~
Dort wird diese Datei angezeigt, sofern sie im selben Pfad wie die MovieGuider.exe liegt

Diagnose starten/JtG-Info starten:
Startet JtG-Info in einer erweiterten Version. Es werden zustzlich Daten aus der 
intern.mdb gelesen und es wird versucht, diese auszuwerten.


Startoptionen:
~~~~~~~~~~~~~~~~~~~~~~~
auto	-	versetzt den MovieGuider in den Automodus
/px;y	-	gibt die Profile an, welche im Automodus verarbeitet werden sollen

Die Profile werden nacheinander abgearbeitet. Wird kein Profil angegeben, wird das
erste nach "Standard" ausgefhrt. Mehrere Profile mit ";" voneinander trennen. Die
Angabe der Profile funktioniert nur ber Zahlen, wobei diese aufsteigend den vorhandenen Profilen entsprechen.
									
Beispiel: MovieGuider auto /p1;2 - startet in der Grundeinstellung erst "Profil online" und dann "Profil offline"

dbox	- sendet einen http-Befehl an den Web-Server der DBox(IP unter DBox angeben)
Befehl- der zu sendende Befehl
Referenz: http://wiki.tuxbox.org/Neutrino#Der_Web-Server_.28nhttpd.29
Die Befehle mssen so angegeben werden: /control/rc?lock
Das GUI startet bei diesem Parameter nicht. Meine Nutzung dafr: in JtG Timer
vor der Aufnahme, 40 sec., Parameter wie im Beispiel. Sperrt die Aufnahme-Box
bei jeder Aufnahme und entsperrt sie danach(siehe ProjectX)

Beispiel: MovieGuider dbox /control/rc?lock - sperrt die Fernbedienung der DBox
									
Im Automodus wird immer eine Logdatei(MovieGuider.log) angelegt oder weitergefhrt.
									
