Version vom 23. August 2010, 12:11 Uhr

Der Vodcatcher Helper (VCH) ist ein Programm, das ursprünglich als Helferlein für das vodcatcher-Plugin geschrieben wurde. VCH durchforstet Webseiten (überwiegend Mediatheken) nach Videos und stellt die Ergebnisse dem VDR oder auch dem xbmc zur Verfügung. Dadurch hat man im VDR/xbmc Zugriff auf Seiten wie die ZDFmediathek oder die ARD Mediathek. Die Verbindung zum VDR wird über das osdserver-Plugin hergestellt. xbmc kann über UPnP auf VCH zugreifen. Möglicherweise klappt das auch mit weiteren UPnP-Playern.

Mithelfen

Wer mich bei der Entwicklung von VCH unterstützen möchte, kann sich hier an der Doku auslassen. Z.B. zur Installation, Konfiguration oder was auch immer. Außerdem sind alle aufgerufen unter Vodcatcher Helper/Feeds vodcasts hinzuzufügen. Diese werden dann als Vorschläge für den RSS-Feed-Parser angezeigt.

Voraussetzungen

• 2 Mbit-Leitung oder besser
• Java 1.6 (aka Java 6, http://www.java.com)
• moderner Browser wie Firefox, Opera, Chrome, Safari. Internet Explorer ist ungeeignet.
• VDR oder xbmc
  bei VDR zusätzlich
  • osdserver-Plugin
  • mplayer-Plugin oder xineliboutput-Plugin
    bei mplayer zusätzlich
    • mplayer.sh oder mplay.sh mit Unterstützung für Wiedergabelisten
  • curl
  • at

Funktionsweise

VCH ist ein externes Programm, das völlig unabhängig vom VDR laufen kann. Über das (lokale) Netzwerk können VDR und VCH allerdings kommunizieren. Das Öffnen von VCH erfolgt folgendermaßen:

• Im VDR wird ein Befehl in der commands.conf definiert.
• Der Benutzer ruft diesen Befehl über das "Befehle"-Menu auf. Der Befehl ruft curl auf.
• Curl wiederum erzeugt eine HTTP-Anfrage an VCH, die VCH sagt, dass jetzt das Menu geöffnet werden soll.
• VCH verbindet sich mit dem osdserver und erzeugt das Menu.
• VDR zeigt das Menu an
• (Danach läuft die Kommunikation zwischen osdserver und VCH)

Installation

• Aktuelle Version von VCH herunterladen von http://vch.berlios.de/repo/snapshots/de/berlios/vch/vch für Entwickler-Snapshots oder http://vch.berlios.de/repo/releases/de/berlios/vch/vch für stabile Versionen
• VCH entpacken. Z.B. nach /opt/vch
• Die vch.sh ausführbar machen: chmod 755 vch.sh
• VCH starten:
  • manuell /opt/vch/vch.sh
  • oder beim Systemstart. Ich z.B. einen Eintrag bash /opt/vch/vch.sh >/dev/null 2>&1 & in der /etc/conf.d/local.start (Gentoo)
• VDR konfigurieren:
  • Folgende Zeile in die commands.conf einfügen: VCH: echo "curl http://localhost:8080/osdserver >/tmp/vchosd.log 2>&1" | at now
  • VDR neustarten
• VCH konfigurieren: Mit einem Browser das Webinterface von VCH öffnen: Z.B. http://vdr:8080/

Wenn alles geklappt hat, sollte sich nach dem Aufruf des Befehls im Befehle-Menu ein osd-Menu öffnen.

Konfiguration

Fragen und Antworten

Ich bekomme im osdserver-Menu die Meldung "No supported video format found on page".

Im upnp-Menu sind manche Videoeinträge leer.

VCH liest Seiten erst dann ein, wenn man sie auswählt. Daher ist grundsätzlich nicht bekannt, welche Videoformate eine Seite enthält. Es kann natürlich vorkommen, dass eine Seite nur Formate / Protokolle enthält, die weder von VCH noch von den Mediaplayern unterstützt werden. In dem Fall kommt im osdserver die Fehlermeldung. Im upnp-Menu bleibt der Videoeintrag leer.

Wie beendet man VCH ordnungsgemäß?

Grundsätzlich muss man VCH nicht ordentlich beenden, sondern kann ihn killen oder beim Herunterfahren "killen lassen". Der einzige Grund, VCH ordnungsgemäß zu beenden, ist 100%ig sicherzustellen, dass alle Einstellungen gespeichert werden. Das geschieht in der Regel aber schon beim Abspeichern im Webinterface, so dass man sich darum keine Gedanken machen muss. Um VCH manuell zu beenden kann man Folgendes machen:

telnet localhost 6666 <enter>
shutdown <enter>

oder automatisiert in einem Script

#!/bin/bash
telnet localhost 6666 <<EOF
shutdown
EOF

Bekannte Probleme

• Manchmal erscheint das Log nicht auf der Konsole. Ein Neustarten von VCH löst das Problem in der Regel.