"tv_grab_de_tvmcf" ist ein Programm zur Extraktion und Transformation von TV-Programmdaten aus der Datenbank des TV Movie-ClickFinders in das Dateiformat XMLTV. Die Anwendung des Programms erfordert eine installierte und lizenzierte Version des ClickFinders. Dies kann entweder die kostenlose "Basic-Edition" mit den 8 wichtigsten Sendern und einer Programmvorschau von 8 Tagen, oder die kostenpflichtige "Premium-Edition" mit über 170 Kanälen und einer Programmvorschau von 14 Tagen sein.
Die so erzeugten Daten im XMLTV-Format können in einem anschließenden Schritt, oder oftmals auch automatisch, in dieses Format unterstützende Programme wie z.B. DVBLink importiert werden, um dort als EPG-Daten verwendet zu werden. Der etwas sperrige Name des Programms ergab sich einerseits durch die Namenskonvention des XMLTV-Projekts bei Grabbern, welche allesamt mit "tv_grab" und einem eventuellen Landeskürzel beginnen, und anderseits durch die Kodierung des Herausgebers der Daten. Diese ergibt sich aus dem Namen "TV Movie", und dem Namen des datenliefernden Programms "ClickFinder". Ein Namenskürzel wurde gewählt, um unter Umständen rechtliche Probleme wegen Verwendung geschützter Namen zu vermeiden.

Installation

Eine Installation des Programms ist nicht erforderlich. Das Programm wird als ZIP-Archiv ausgeliefert, welches lediglich in das gewünschte Verzeichnis entpackt werden muss. Neben der ausführbaren Datei enthält das Archiv noch wenige weitere Dateien, die der Zuordnung von Kanälen und Kategorien dienen. Sollte sich bereits eine Vorgängerversion des Programms auf Ihrem Rechner befinden, achten Sie darauf, dass Sie sich manuell von Ihnen geänderte Dateien nicht überschreiben. Entpacken Sie in diesem Fall lediglich die .EXE-Datei und ggf. neue Dateien, die in einer älteren Version noch nicht beinhaltet waren.

Ausführung

Das Programm ist ein sog. Konsolenprogramm und besitzt keine grafische Oberfläche. Stattdessen werden die grundsätzlichen Funktionen, welche die Umgebung des Programms oder den Umfang der zu extrahierenden Daten betreffen, über einige wenige Kommandozeilenparameter beim Start des Programms bestimmt. Darüberhinaus gibt es noch eine Konfigurationsdatei namens "tv_grab_de_tvmcf.conf", die vor dem ersten Verarbeitungslauf mittels des Kommandozeilenparameters "--configure" erstellt werden muss, und etliche Einstellungen zur Beeinflussung der Verarbeitung der Daten enthält. Weitere Konfigurationsmöglichkeiten existieren zudem durch die optionalen "Supplement"-Dateien tv_grab_de_tvmcf.channel.map und tv_grab_de_tvmcf.category.map.

Beispiel: Mit folgendem Aufruf wird der Grabber veranlasst, alle verfügbaren Programmdaten ab diesem Zeitpunkt für sämtliche konfigurierten Sender in eine xmltv-Datei namens clickfinder.xmltv zu extrahieren. Als Konfigurationsdatei soll die Datei "tv_grab_de_tvmcf.conf" im Unterverzeichnis ".xmltv" des aktuellen Verzeichnisses verwendet werden. Supplement-Dateien sollen im Unterverzeichnis "supplement" des aktuellen Verzeichnisses gesucht werden.

> tv_grab_de_tvmcf.exe --config-file .\.xmltv\tv_grab_de_tvmcf.conf
--supplement-dir .\supplement --output clickfinder.xmltv

Kommandozeilenparameter

Das Programm kennt verschiedene Funktionsmodi und dazugehörige Einstellmöglichkeiten, welche ihm bei Programmstart über Kommandozeilenparameter mitgeteilt werden können. Grundsätzlich stehen folgende Funktionsmodi zur Verfügung:

1. Ausgabe der in der ClickFinder-Datenbank gespeicherten Daten; entweder nach STDOUT oder mittels des zusätzlichen Parameters --output in die angegebene Datei:

   tv_grab_de_tvmcf

   [--config-file FILE]

   [--days N] [--offset N]

   [--output FILE] [--quiet] [--debug]

   [--lang LANGUAGE] [--database-mode MODE]

   [--supplement-dir DIR]

2. Ausgabe einer Liste aller in der Datenbank verfügbaren Kanäle; entweder nach STDOUT oder mittels des zusätzlichen Parameters --output in die angegebene Datei:

   tv_grab_de_tvmcf --list-channels

   [--config-file FILE]

   [--output FILE] [--quiet] [--debug]

   [--lang LANGUAGE] [--database-mode MODE]

   [--supplement-dir DIR]

3. Konfiguration des Grabbers, welche vor Verwendung des Programms mindestens einmal ausgeführt worden sein muss.

   tv_grab_de_tvmcf --configure

   [--config-file FILE]

   [--lang LANGUAGE] [--database-mode MODE]

4. Konfiguration des Grabbers über externen Programmaufruf.

   tv_grab_de_tvmcf --configure-api

   [--config-file FILE] [--stage NAME]

   [--output FILE]

   [--lang LANGUAGE] [--database-mode MODE]

5. Anzeige der unterstützten Eigenschaften des Grabbers.

   tv_grab_de_tvmcf --capabilities

6. Anzeige der Version des Grabbers.

   tv_grab_de_tvmcf --version

7. Beschreibung der Datenquelle.

   tv_grab_de_tvmcf --description

8. Anzeige eines umfangreicheren Hilfetexts.

   tv_grab_de_tvmcf --info

9. Anzeige der verfügbaren Funktionsmodi.

   tv_grab_de_tvmcf --help

Beschreibung sämtlicher Kommandozeilenparameter

Option	Parameter	Beschreibung
--capabilities		Zeigt die vom Grabber unterstützten Fähigkeiten. Mehr Informationen finden Sie unter http://wiki.xmltv.org/index.php/XmltvCapabilities.
--config-file	<Dateiname>	Dient zur Angabe einer alternativen Konfigurationsdatei. Falls nicht angegeben, wird die Datei unter "~/.xmltv/tv_grab_de_tvmcf.conf" gesucht.
--configure		Startet die interaktive Konfiguration des Grabbers, inkl. der zu verarbeitenden Kanäle, um diese anschließend in der Konfigurationsdatei zu speichern.
--configure-api		Stellt die Konfiguration des Grabbers für Programmaufrufe zur Verfügung.
--database-mode	real (Default) demo	Wählt die zu verwendende Datenbank aus. Während mit "real" auf die ClickFinder-Datenbank zugegriffen wird, schaltet man mittels "demo" auf die Grabber-eigene Demonstrationsdatenbank um. Diese enthält modifizierte, um redaktionelle Inhalte beschnittene Daten über insgesamt 4 Sender und 4 Tage, welche sich unabhängig vom aktuellen Datum immer über den Zeitraum von 1 Tag in der Vergangenheit bis 3 Tage in der Zukunft erstrecken. Die Demonstrationsdatenbank dient zum Testen des Grabbers und seinen Einstellungen, falls die ClickFinder-Datenbank nicht zur Verfügung steht. Hinweis: Neben diesem Kommandozeilenparameter existiert auch ein Konfigurationsparameter gleichen Namens, mit deren Hilfe die Datenbank dauerhaft, z.B. zu automatisierten Validierungszwecken, umgestellt werden kann. Sollten sowohl der Konfigurations- als auch der Kommandozeilenparameter angegeben sein, wird Letzterer bevorzugt.
--days	<Anzahl Tage>	Legt die Anzahl der zu verarbeitenden Tage fest. Die Angabe von 0 Tagen führt zur Ausgabe einer Liste der konfigurierten Kanäle ohne Programmdaten. Negative Werte sind nicht erlaubt. Falls nicht angegeben, werden sämtliche, in der ClickFinder-Datenbank gespeicherten, Tage ab dem aktuellen Datum ausgegeben.
--debug		Führt zur Ausgabe weiterer, zusätzlicher Informationen, welche im Falle einer etwaigen Fehleranalyse hilfreich sein können.
--description		Gibt die Region und die Quelle der Daten aus.
--help		Zeigt einen Hilfetext mit den verfügbaren Parametern an.
--info		Zeigt den vollständigen Hilfetext des Grabbers an.
--lang	de (deutsch, Default) en (englisch)	Legt die Ausgabesprache des Programms fest.
--list-channels		Gibt eine vereinfachte, XMLTV-basierte Liste aller Kanäle wieder, für die Daten in der Datenbank zur Verfügung stehen. Im Gegensatz zur eigentlichen Ausgabe des Grabbers, enthält diese weder die Elemente <icon> noch <url>.
--offset	<Anzahl Tage>	Verschiebt das auszugebende Zeitfenster um n Tage. Negative Werte sind ebenfalls zulässig und verschieben den Beginn des Zeitfensters um entsprechend viele Tage in die Vergangenheit.
--output	<Dateiname>	Leitet die Ausgabe in die entsprechende Datei um. Falls nicht angegeben, wird die Standardausgabe (stdout) verwendet.
--preferredmethod		Zeigt die bevorzugte Art der Datenverarbeitung an.
--quiet		Unterdrückt sämtliche Ausgaben, mit Ausnahme von Fehlermeldungen.
--stage	<Name der Stage>	Nur sinnvoll in Verbindung mit --configure-api. Dient zur namentlichen Angabe der zu konfigurierenden Stage.
--supplement-dir	<Verzeichnisname>	Legt das Verzeichnis fest, in dem der Grabber nach optionalen Dateien wie den .map-Dateien sucht. Falls die Umgebungsvariable XMLTV_SUPPLEMENT ebenfalls gesetzt ist, wird die Kommandozeilenoption bevorzugt.
--version		Zeigt die Version des Grabbers an.

Konfigurationsparameter

Nachfolgend finden Sie eine Auflistung der Parameter, welche das Programm in der Konfigurationsdatei "tv_grab_de_tvmcf.conf" erwartet. Bis auf wenige, als optional gekennzeichnete, Ausnahmen sind sämtliche dieser Parameter Pflichtangaben und werden bei der Konfigurierung des Grabbers mittels --configure entsprechend abgefragt. Sollte einer dieser Parameter in der Konfigurationsdatei nicht angegeben sein, so wird bei Ausführung ein entsprechender Warnhinweis ausgegeben und sein im Programm festgelegter Standardwert ("Default") stattdessen verwendet.

Beschreibung der Konfigurationsparameter

Option	Parameter	Beschreibung
clickfinder_home	<Verzeichnisname>	Vollqualifizierter Pfad des Ausführungsverzeichnisses von ClickFinder. Sollte ClickFinder unter "Programme" oder "Programme (x86)" installiert worden sein, wird aufgrund seiner Eigenschaft in das eigene Installationsverzeichnis schreiben zu wollen, ab Windows Vista eine Kopie des Programms im Roaming-Verzeichnis des installierenden Benutzers abgelegt ("Virtual Store"), welche dann stattdessen ausgeführt wird. In diesem Fall entspricht das Ausführungsverzeichnis nicht dem Installationsverzeichnis und lautet stattdessen vermutlich "C:\<Benutzername>\AppData\Roaming\TVMovie\ClickFinder". Falls dies unerwünscht ist, kann der "Virtual Store" auch umgangen werden, indem ClickFinder außerhalb der "Programme"-Ordner installiert wird. Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
database_path	<Dateiname und -pfad>	Vollqualifizierter Pfad der Datenbankdatei von ClickFinder. Die Datei heißt üblicherweise "tvdaten.mdb" und befindet sich im Ausführungsverzeichnis von ClickFinder. Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
picture_path	<Verzeichnisname>	Vollqualifizierter Pfad des Verzeichnisses in dem ClickFinder die Bilder zu den Fernsehprogrammen ablegt. Das Verzeichnis trägt üblicherweise den Namen "Hyperlinks" und ist ein Unterverzeichnis des Basisverzeichnisses. Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
icon_path	<Verzeichnisname>	Vollqualifizierter Pfad des Verzeichnisses, welches die .gif-Bilddateien mit den TVMovie-Bewertungssymbolen (z.B. "tvmovie_bew1.gif") beinhaltet. Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
update_program	<Dateiname und -pfad>	Vollqualifizierter Pfad des Programms zur Aktualisierung der ClickFinder-Datenbank. Das Programm heißt üblicherweise "tvuptodate.exe" und befindet sich im Ausführungsverzeichnis von ClickFinder. Achtung! Falls Parameter wie z.B. "/hidden" hinzugefügt werden, muss der Pfad, sofern er Leerzeichen enthält, in Anführungszeichen gesetzt werden.
call_update_program	1 (ja) 0 (nein, Default)	Soll das ClickFinder-Programm zur Aktualisierung der Datenbank vor der Verarbeitung der Daten aufgerufen werden?
replace_pics_by_icons	1 (ja, Default) 0 (nein)	Sollen statt der Bilder Bewertungssymbole verlinkt werden? Achtung! Diese Bewertungssymbole müssen selbst erstellt und als "tvmovie_bew[1-5].png" (PNG, nicht GIF!) im Symbolpfad abgelegt werden. Die Zahl im Dateinamen muss der jeweiligen ClickFinder-Bewertung entsprechen.
use_episode_num_from_title	1 (ja, Default) 0 (nein)	Im Falle einer Serie enthält der Untertitel der Sendung üblicherweise die Episoden- und Staffelnummer der Folge. Soll diese Information zur Identifikation der Folge verwendet werden?
remove_episode_num_from_title	1 (ja, Default) 0 (nein)	Sofern der Untertitel Episoden- und Staffelinformationen einer Serie beinhaltet, sollen diese aus dem Untertitel entfernt werden?
use_episode_num_from_desc	1 (ja, Default) 0 (nein)	Im Falle einer Serie enthält die Beschreibung der Sendung üblicherweise die Episoden- und Staffelnummer der Folge. Soll diese Information zur Identifikation der Folge verwendet werden? Anmerkung: Bei Verwendung der Serieninformation sowohl aus der Beschreibung als auch aus dem Untertitel wird Letzteres bevorzugt.
remove_episode_num_from_desc	1 (ja, Default) 0 (nein)	Sofern die Sendungsbeschreibung Episoden- und Staffelinformationen einer Serie beinhaltet, sollen diese aus der Beschreibung entfernt werden?
desc_format_string	<Zeichenkette>	Enthält die Vorlage für die Sendungsbeschreibung, welche mithilfe von statischen Inhalten, Platzhaltern und bedingten Ausgaben individuell gestaltet werden kann. Lesen Sie hierzu mehr unter "die frei konfigurierbare Sendungsbeschreibung" Tipp: Verwenden Sie die Vorgabe und passen Sie sie später Ihren Vorstellungen nach an. Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
min_displayed_age_rating	<Zahl>	Die FSK-Einstufung einer Sendung kann in der Programmbeschreibung mithilfe des Platzhalters "{age_rating}" angezeigt werden. Um niedrige Einstufungen, wie z.B. FSK0, auszublenden, kann hier der (einschließliche) Schwellwert festgelegt werden ab dem die FSK-Einstufung erscheinen soll.
max_description_length	<Zahl> (0 = maximale Länge, Default)	Manche Programme schneiden den Beschreibungstext ab einer bestimmten Länge ab. Diese Variable setzt die zulässige Gesamtlänge der Beschreibung. Sollte diese nach Einsetzen aller Platzhalter, wie z.B. <live>, überschritten werden, wird die Programmbeschreibung ({description}) entsprechend gekürzt. Dies soll sicherstellen, dass sämtliche Platzhalter so vollständig wie möglich dargestellt werden und lediglich die Beschreibung gekürzt wird. Der Wert 0 entspricht der maximalen Länge und führt niemals zu einer Verkürzung des Programmbeschreibungstexts.
max_star_rating	4 (Default) 5	ClickFinder verwendet eine Bewertungsskala von 1 bis 5, auf der die TVMovie-Sterne grau, rosa und rot die Werte 1-3 einnehmen, der "Tagestipp" die 4 und der goldene Stern die 5. Da es sich bei dem "Tagestipp" tatsächlich um einen roten Stern mit lediglich temporär höherer Einstufung handelt, gibt es die Möglichkeit diesen als regulären roten Stern auszuweisen und somit die Skala auf 4 zu verkürzen.
star_rating_bar_char	<Zeichen oder Zeichenkette>	Der frei konfigurierbaren Programmbeschreibung kann eine Bewertungsleiste (star_rating_bar) hinzugefügt werden, die die TVMovie-Bewertung mittels Zeichen darstellt. Welches Zeichen, oder welche Zeichenkette, soll für die Darstellung eines Sterns verwendet werden? Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
star_rating_bar_filler	<Zeichen oder Zeichenkette>	Der frei konfigurierbaren Programmbeschreibung kann eine Bewertungsleiste (star_rating_bar) hinzugefügt werden, die die TVMovie-Bewertung mittels Zeichen darstellt. Welches Zeichen, oder welche Zeichenkette, soll zur Darstellung von fehlenden Sternen verwendet werden? Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
pretty_print_ingredients_bar	1 (ja, Default) 0 (nein)	Die Angabe der Bestandteile eines Films, z.B. Spaß und Action, stehen in der Datenbank nicht sonderlich schön formatiert. Soll diese Angabe zur besseren Lesbarkeit umformatiert werden?
remove_ingredients_equal_zero	1 (ja, Default) 0 (nein)	Die Liste der Filmzutaten enthält üblicherweise alle Genre. Sollen diejenigen entfernt werden, die mit der Zahl null (entspricht 'nicht enthalten') angegeben sind?
ingredients_bar_char	<Zeichen oder Zeichenkette>	Sofern die Filmzutatenleiste umformatiert werden sollen, welches Zeichen, oder welche Zeichenkette, soll dann für die Darstellung eines Punktes einer beinhalteten Filmzutat verwendet werden? Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
ingredients_bar_filler	<Zeichen oder Zeichenkette>	Sofern die Filmzutatenleiste umformatiert werden sollen, welches Zeichen, oder welche Zeichenkette, soll dann zur Kennzeichnung dienen, dass eine Filmzutat nicht beinhaltet ist? Hinweis: Unicode-Zeichen können in der Form \uhhhhhh angegeben werden.
correct_aspect_ratio	1 (ja, Default) 0 (nein)	Manche Sendungen sind trotz einer HD-Markierung nicht als Sendungen im 16:9-Format gekennzeichnet - was üblicherweise nicht richtig sein dürfte. Soll das Anzeigeformat in diesen Fällen explizit auf 16:9 gesetzt werden?
cast_filter_director	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "director" erscheinen sollen.
cast_filter_writer	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "writer" erscheinen sollen.
cast_filter_writer_role	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "writer" erscheinen sollen, mit der tatsächlichen Rollenangabe in Klammern hinter dem Namen.
cast_filter_adapter	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "adapter" erscheinen sollen.
cast_filter_editor	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "editor" erscheinen sollen.
cast_filter_composer	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "composer" erscheinen sollen.
cast_filter_commentator	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "commentator" erscheinen sollen.
cast_filter_presenter	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "presenter" erscheinen sollen.
cast_filter_guest	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "guest" erscheinen sollen.
cast_filter_producer	<Regulärer Ausdruck>	Die Besetzungsliste beinhaltet neben den Schauspielern weitere Personen, die anderen Kategorien zugeordnet werden können. Dieser Filter ist für 'Rollen', deren Personen stattdessen unter "producer" erscheinen sollen.
cast_filter_ignore	<Regulärer Ausdruck>	Die Besetzungsliste kann Informationen beinhalten, die keinen XMLTV-Kategorien zugeordnet werden können, oder nicht angezeigt werden sollen. Dieser Filter ist für 'Rollen', die ignoriert werden sollen.
export_all_channels	1 (ja, Default) 0 (nein)	Sollen alle verfügbaren Kanäle exportiert werden - oder lediglich eine Auswahl davon? Hinweis: Kanäle, für die keine aktuellen Sendungsdaten vorliegen, werden in keinem der Fälle exportiert.
search_prev_shown_by_description	1 (ja, Default) 0 (nein)	Optional. Wiederholungen von Sendungen sind in der ClickFinder-Datenbank zwar als solche markiert, jedoch sind sie häufig leider nicht mit der früher ausgestrahlten Sendung verknüpft. Um dieses Problem zu beheben und die Wiederholungsinformation dennoch bereitstellen zu können, kann dieser Grabber danach suchen indem er u.a. die Beschreibungstexte der in Frage kommenden Sendungen mit der der Wiederholung vergleicht. Prinzipiell funktioniert diese Suche sehr gut, jedoch könnte es bei immer gleichlautenden Beschreibungen, wie z.B. bei Nachrichten, zu Ungenauigkeiten kommen. Falls gewünscht, kann diese Funktion daher hiermit abgeschaltet werden.
search_prev_shown_min_desc_length	<Zahl> (1 = Default)	Optional. Standardmäßig werden bei der Suche nach früheren Ausstrahlungen von Wiederholungen alle in Frage kommenden, nicht-leeren Sendungsbeschreibungen durchsucht. Da dies unter Umständen zu Ungenauigkeiten führen könnte, kann hier die Mindestlänge der zu durchsuchenden Sendungsbeschreibungen festgelegt werden. Sendungen, deren Beschreibung kürzer als die hier festgelegte Mindestlänge ist, bleiben demzufolge bei der Suche nach Wiederholungen unberücksichtigt.
search_prev_shown_on_other_channels	1 (ja, Default) 0 (nein)	Optional. Eine frühere Ausstrahlung einer Wiederholung wird standardmäßig auf allen Sendern gesucht. Kommen mehrere Sendungen auf unterschiedlichen Sendern als frühere Ausstrahlung in Frage, wird der Sender bevorzugt, auf dem auch die Wiederholung gezeigt wird. Sollte dieses Suchverhalten zu Ungenauigkeiten bei der Erkennung von Wiederholungen führen, kann hiermit die senderübergreifende Suche abgeschaltet werden.
database-mode	real (Default) demo	Optional. Wählt die zu verwendende Datenbank aus. Während mit "real" auf die ClickFinder-Datenbank zugegriffen wird, schaltet man mittels "demo" auf die Grabber-eigene Demonstrationsdatenbank um. Diese enthält modifizierte, um redaktionelle Inhalte beschnittene Daten über insgesamt 4 Sender und 4 Tage, welche sich unabhängig vom aktuellen Datum immer über den Zeitraum von 1 Tag in der Vergangenheit bis 3 Tage in der Zukunft erstrecken. Die Demonstrationsdatenbank dient zum Testen des Grabbers und seinen Einstellungen, falls die ClickFinder-Datenbank nicht zur Verfügung steht. Hinweis: Neben diesem Konfigurationsparameter existiert auch ein Kommandozeilenparameter gleichen Namens und gleicher Funktion. Sollten sowohl der Kommandozeilen- als auch der Konfigurationsparameter angegeben sein, wird Ersterer bevorzugt.

Änderung von Sendereigenschaften (channel.map-Datei)

Der Grabber verwendet als Senderkennung ("channel id") nicht den Anzeigenamen, sondern den internen eindeutigen Schlüssel der Sender in der ClickFinder-Datenbank. Da sich dieser allerdings auch bei Umbenennungen von Sendern, wie z.B. von DSF nach Sport1 im Jahr 2010, nicht ändert, entsprechen manche Senderkennungen nicht dem aktuellen Stand. Mithilfe der optionalen Datei "tv_grab_de_tvmcf.channel.map" kann der Name eines Senders jedoch beliebig geändert werden. RFC2838-konforme Namen, wie z.B. "prosieben.de", werden vom XMLTV-Standard zwar empfohlen, sind für die spätere Verwendung der Daten aber kein Muss. Weitere, jeweils durch Semikolon voneinander getrennte, Parameter ermöglichen zudem senderspezifische Anpassungen, wie das Unterdrücken von HD-Markierungen oder das Zusammenführen ("Merge") von zwei oder mehr Sendern zu einem Kanal.

Als sog. "Supplement" (dt. Anhang) wird die Datei standardmäßig im Unterverzeichnis 'tv_grab_de_tvmcf' des XMLTV-"Supplement"-Verzeichnisses erwartet - welches im Falle von Windows üblicherweise "C:\Users\<Benutzername>\AppData\Local\xmltv\supplement" ist. Der Ort, wo "Supplement"-Dateien gesucht werden, kann durch Verwenden des Kommandozeilenparameters --supplement-dir oder durch Setzen der Umgebungsvariable XMLTV_SUPPLEMENT geändert werden.

Achtung! Bitte beachten Sie, dass die Datei in UTF-8 (mit oder ohne BOM) kodiert sein muss.

Beschreibung der möglichen Parameter je Sender

Option	Parameter	Beschreibung
quality	SD	Falls ein HD-fähiger Sender zu Hause nur in SD-Qualität empfangen wird, kann das HD-Kennzeichen für alle Sendungen dieses Senders hiermit unterdrückt werden.
start	<hh:mm>	Gibt den (einschließlichen) Beginn eines Zeitfensters an. Alle Programme des Senders an einem Tag, die vor diesem Zeitpunkt ausgestrahlt werden, werden unterdrückt. Ist keine Startzeit angegeben, wird 00:00 Uhr angenommen.
end	<hh:mm>	Gibt das (ausschließliche) Ende eines Zeitfensters an. Alle Programme des Senders an einem Tag, die ab diesem Zeitpunkt ausgestrahlt werden, werden unterdrückt. Ist keine Endezeit angegeben, wird 00:00 Uhr angenommen.

Dateiformat:

<Sender-ID>=[<neue Sender-ID>][;start=hh:mm][;end=hh:mm][;quality=sd]

Beispiel: Behalte die ursprüngliche ID "SWR" bei und unterdrücke sämtliche HD-Markierungen bei Sendungen dieses Senders.

SWR=;quality=sd

Beispiel: Verwende für die sich mittlerweile einen Kanal teilenden Sender "VIVA" und "Comedy Central" den gleichen Namen und definiere die jeweils gültigen Sendefenster.

VIVA=comedycentral.viva.de;start=06:00;end=17:00

Comedy Central=comedycentral.viva.de;start=17:00;end=06:00

Änderung von Kategorien (category.map-Datei)

In der ClickFinder-Datenbank ist jede Sendung üblicherweise einer oder mehreren Kategorien zugeordnet. Leider ist diese Zuordnung oft sehr uneinheitlich und damit für die Verwendung als EPG-Daten eher unbrauchbar. Abhilfe schafft hier die Möglichkeit des Grabbers, die Kategorienamen zu ändern oder unerwünschte Kategorien gar zu entfernen.

Als sog. "Supplement" (dt. Anhang) wird die Datei standardmäßig im Unterverzeichnis 'tv_grab_de_tvmcf' des XMLTV-"Supplement"-Verzeichnisses erwartet - welches im Falle von Windows üblicherweise "C:\Users\<Benutzername>\AppData\Local\xmltv\supplement" ist. Der Ort, wo "Supplement"-Dateien gesucht werden, kann durch Verwenden des Kommandozeilenparameters --supplement-dir oder durch Setzen der Umgebungsvariable XMLTV_SUPPLEMENT geändert werden.

Achtung! Bitte beachten Sie, dass die Datei in UTF-8 (mit oder ohne BOM) kodiert sein muss.

Dateiformat:

<Kategorie>=<neue Kategorie>

Beispiel:

Krimireihe=Krimiserie # Ersetze 'Krimireihe' durch 'Krimiserie'.

Magazin= # Entferne die Kategorie 'Magazin'.

Automation

Dank Auslegung des Programms als Konsolenprogramm gestaltet sich seine Automation unter Windows denkbar einfach. Hierfür ist lediglich ein entsprechender Eintrag in die Aufgabenplanung notwendig um das Programm beispielsweise täglich zu einer bestimmten Uhrzeit ausführen zu lassen. Die Angabe der Kommandozeilenparameter kann entweder direkt in der Aufgabenplanung erfolgen, oder durch Erstellung einer kleinen Batch-Datei (BAT oder CMD), die den vollständigen Aufruf enthält und von der Aufgabenplanung stattdessen ausgeführt wird.