Epgsearch-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Aktuelle Version)
(Aktuelle Version)
Zeile 263: Zeile 263:
 
==Aktuelle Version==
 
==Aktuelle Version==
 
[http://winni.vdr-developer.org/epgsearch/downloads/vdr-epgsearch-0.9.24.tgz Version 0.9.24]
 
[http://winni.vdr-developer.org/epgsearch/downloads/vdr-epgsearch-0.9.24.tgz Version 0.9.24]
[http://winni.vdr-developer.org/epgsearch/downloads/beta/vdr-epgsearch-0.9.25.beta13.tgz 0.9.25 Beta 13]
+
[http://winni.vdr-developer.org/epgsearch/downloads/beta/vdr-epgsearch-0.9.25.beta14.tgz 0.9.25 Beta 14]
  
 
==Links==
 
==Links==

Version vom 9. Juli 2009, 19:02 Uhr

Inhaltsverzeichnis

Beschreibung

Autor: Christian Wieninger

EPG-Search kann als Ersatz für die Standard-Programmanzeige verwendet werden. Es erweitert diese um viele zusätzliche Funktionen (z.B. Wiederholungen suchen), um ein Befehlsmenü für Programmeinträge sowie eine Suchfunktion zum Durchsuchen des EPG. Die Suche kann auch dafür verwendet werden, um automatisch im Hintergrund Timer anzulegen, wenn etwas Passendes gefunden wurde.

Diese Funktion nennt sich hier Suchtimer, ist ähnlich den Autotimern von Vdradmin, nur deutlich flexibler. Die Optik lässt sich außerdem durch einen Fortschrittsbalken etwas aufpeppen. Zusätzlich gibt es noch bis zu vier benutzerdefinierte Zeiten neben
Jetzt
und
Nächste
. Der Aufbau der einzelnen Menüs kann ebenfalls nach den eigenen Wünschen angepasst werden.

Desweiteren verfügt das Plugin über einen integrierten Konfliktcheck, der einen per OSD informiert wenn Sendungen aufgrund von Überschneidungen (und zu wenig Aufnahmegeräten) nicht vollständig aufgenommen werden können. In einem speziellen Konflikt-Menü können dann die Konflikte komfortabel gelöst werden.

Eine Benachrichtigung per EMail bei Timer-Updates und/oder Timer-Konflikten ist ebenso enthalten wie die Möglichkeit, mit User-Variablen und Scriptaufrufen auf die Suchtimer umfangreichen Einfluss nehmen zu können.


Bilder

Übersicht - Jetzt
Übersicht - Jetzt
Datei:Epgsearch-plugin-updmail.jpg
Beispiel - Benachrichtigungs - Mail

Bedienung

Das Plugin ist zu umfangreich, um alles in diesem Artikel zu beschreiben. Dem Plugin liegt aber eine umfangreiche Dokumentation in Form von Manpages bei, die auch online gelesen werden können:

  1. README.DE
  2. MANUAL


SVDRP Befehle

Parameter Beschreibung
LSTS [ID] Listet alle Suchen auf, oder, falls ID angegeben wurde, die Suche mit der ID [ID].

Die Ausgabe ist im selben Format wie der Inhalt der Datei epgsearch.conf.

NEWS <settings> Fügt eine neue Suche hinzu. Format der <settings> identisch mit epgsearch.conf. Hinweis: ID muss angegeben werden, wird aber intern ignoriert und durch die nächste freie ID ersetzt.
DELS <ID> Löscht die Suche mit der ID <ID>.
EDIS <settings> Modifiziert eine Suche.
UPDS [OSD] Ein Update der Suchtimer wird durchgeführt. Wenn optional OSD angegeben wird, erscheint am Ende des Updates eine OSD-Hinweis.
UPDD Liest die Datei epgsearchdone.data erneut ein. Sinnvoll wenn ein externes Tools diese geändert hat.
SETS <ON|OFF> Aktiviert oder deaktiviert den im Hintergrund laufenden Suchtimer-Thread.
FIND <settings> Sucht im EPG nach Events, die auf <settings> passen. Das Ergebnis wird direkt ausgegeben.

Dies ist nur ein Teil der möglichen SVDR-Befehle. Die komplette Liste ist im MANUAL nachzulesen.


Softwareanforderungen

  • Ab Version 0.9.17 nur vdr >= 1.3.46
  • Bis Version 0.9.16 vdr >= 1.3.7
  • (P)erl-(c)ompatible (r)egular (e)xpression library, PCRE (optional)
  • TRE Bibliothek, für unbegrenzt tolerante Suche (optional)

Installation

Optionen im Makefile

#WITHOUT_EPGSEARCHONLY = 1 Entferne die # wenn das Mini-Plugin epgsearchonly nicht kompiliert werden soll.

epgsearchonly erstellt im Hauptmenü von VDR einen Eintrag "Suche" und dient somit als Abkürzung zum Menü der Suchtimer.

#WITHOUT_CONFLICTCHECKONLY = 1 Entferne die # wenn das Mini-Plugin conflictcheckonly nicht kompiliert werden soll.

conflictcheckonly erstellt im Hauptmenü von VDR einen Eintrag "Timerkonflikte" und dient somit als Abkürzung zum Menü der "Suchtimer/Aktionen/Prüfe Timerkonflikte".

#WITHOUT_QUICKSEARCH = 1 Entferne die # wenn das Mini-Plugin quicksearch nicht kompiliert werden soll.

quicksearch erstellt im Hauptmenü von VDR einen Eintrag "Schnellsuche" und dient zum schnellen Suchen im EPG ohne dazu einen Suchtimer anlegen zu müssen.

#HAVE_PCREPOSIX = 1 Entferne die # wenn Perl kompatible reguläre Ausdrücke (Perl compatible regular expressions, PCRE) verwendet werden sollen.
#HAVE_LIBTRE = 1 Entferne die # wenn libtre (für unbegrenzte tolerante Suche) installiert ist.

PCRE

  • Source
cd $SOURCEDIR
tar xvzf pcre-<VERSION>.tar.bz2
cd pcre-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig
pacman -S pcre
prt-get depinst libpcre
apt-get install libpcre3-dev
yum install pcre pcre-devel
emerge libpcre
yast -i pcre-devel

TRE

apt-get install libtre-dev

Konfiguration

timercmds

Um im normalen Timermenü nach Wiederholungen zu suchen, ist optional VDR zu patchen, näheres siehe README.

cd $SOURCEDIR/VDR
patch -p1 < PLUGINS/src/epgsearch/patches/timercmd-<VERSION>.diff

Danach wie gewohnt übersetzen.

createcats

createcats dient zum automatischen Erstellen der erweiterten EPG-Kategorien. Nähere Beschreibung im MANUAL.

Nach dem Kompilieren createcats in den $PATH linken.

ln -s $SOURCEDIR/VDR/PLUGINS/src/epgsearch/createcats /usr/local/bin

Aufruf kann über die $VDRCONFIG/plugins/epgsearch/epgsearchcmds.conf erfolgen (siehe letzter Eintrag).

Parameter

Parameter (kurz) Parameter (lang) Beschreibung
-f <DATEI> --svdrpsendcmd=<DATEI> Der Pfad zum Script svdrpsend.pl für die externe SVDRP Kommunikation. Standard ist interne Kommunikation.
-c <DIR> --config=<DIR> Pfad zu den Konfigurations-Dateien von epgsearch. Standard ist $VDRCONFIG/plugins/epgsearch/
-l <DATEI> --logfile=<DATEI> Logfile für epgsearch. Standard ist $VDRCONFIG/plugins/epgsearch/epgsearch.log
-v <n> --verbose=<n> Level der Logausgaben:
  • 1 Allgemeine Meldungen
  • 2 Detaillierte Meldungen
  • 3 Sehr detaillierte Meldungen für Debugging
-r --reloadmenuconf Neuladen der epgsearchmenu.conf bei jedem Aufruf des Plugins
-m <CMD> --mailcmd=<CMD> Alternatives Mail-Script für die Timer-Update- und Konflikt-Benachrichtigung per EMail

Sonstiges

Hinweis
Hinweis

Mit der Version 0.9.18 hat sich der Speicherort der Konfigurationsdateien geändert! Bitte die HISTORY lesen.


Probleme


Tipps

Zur allgmeinen Bedienung 
Einige Farbtasten sind doppelt belegt. In diesem Fall
0
drücken um auf die andere Belegung zu wechseln.
Zum Aufruf 
Die verwendete Taste zum Aufrufen des Plugins kann in der keymacros.conf konfiguriert werden. Um das Plugin zum Beispiel mit
Grün
aufzurufen:
# Remote control key macros for VDR
#
# Format:
#
# macrokey  key1 key2 key3...
# macrokey  @plugin key1 key2 key3...
#
# See man vdr(5)

Red       @pilot
Green     @epgsearch
^^^^^^^^^^^^^^^^^^^^^
Blue      Timers
Yellow    @prefermenu


Alternativ über einen "User Key":

User1     @epgsearch

Es ist auch möglich, das Menü des Plugins um eigene Befehle zu erweitern. Dazu ist die epgsearchcmds.conf anzupassen.

Falls diese noch nicht existiert, einfach als $VDRCONFIG/plugins/epgsearch/epgsearchcmds.conf erstellen.

Alles weitere und Beispielscripte befinden sich in den Sourcen des Plugins.

Was tun, wenn Suchtimer keine Timer erzeugen? 
  • Prüfen, ob der Suchtimer überhaupt etwas findet.
  • Im Setup von Epgsearch unter "Suche und Suchtimer" prüfen, ob diese überhaupt aktiv sind.
  • Epgsearch programmiert Timer per SVDRP, also in der Shell erstmal testen, ob das funktioniert, z.B. sollte
    svdrpsend.pl plug epgsearch LSTS
    eine Liste aller Suchtimer auswerfen. Falls nicht, dann sollte geprüft werden, ob im Setup von epgsearch der gleiche Port (Standard ist 2001) für SVDRP hinterlegt ist, den auch VDR benutzt. Und schließlich kann es sein, dass Einträge in der svdrphosts.conf fehlen.
  • Standardmäßig programmiert Epgsearch einen Timer nur einmalig, d.h. wird ein Timer manuell gelöscht, wird er beim nächsten Suchtimer-Update nicht neu programmiert. Will man das nicht, kann man im Epgsearch-Setup unter "Suche und Suchtimer" die Option "Timer nach Löschen neuprogrammieren" aktivieren. Andernfalls: Verliert man also seine Timer aus irgendeinem Grund, muss man die Epgsearch-interne Liste der erledigten Timer entfernen. Am einfachsten im Verzeichnis $VDRCONFIG/plugins/epgsearch/
    rm timersdone.conf
    . Alternativ geht das auch per OSD: Menü "Suche/Aktionen/Zeige erstellte Timer", hier dann entweder alle löschen oder nur die von einzelnen Suchtimern.
  • Evtl. verhindert die Suchtimer-Option "Wiederholung vermeiden" eine Programmierung, weil die Sendung früher schon aufgenommen wurde. Dies kann man im OSD unter "Suche/Aktionen/Zeige erledigte Aufnahmen" kontrollieren. Dort also evtl. Löschen oder die Option deaktivieren.

Wunschliste

Erweiterungen

Web-Frontends

Zum Erstellen und Bearbeiten von Suchtimern:

Versions-Historie

Version Datum Beschreibung Link
BETA

0.9.25 beta 7

xx.xx.2008
  • neue interne Variablen
  • - Update der französischen Übersetzung, Danke an Patrice Staudt
  • - Update der italienischen Übersetzung, Danke an Diego Pierotto
  • - neues SVDRP-Kommando 'MENU [NOW|PRG|SUM]' zum Aufruf eines der OSD-Hauptmenüs oder der Inhaltsangabe der aktuellen Sendung. Falls irgendein epgsearch-Menü geöffnet ist, schließt ein weiteres SVDRP-Kommando dieses wieder.
  • - Die maximale Anzahl von Tagen für eine Timerkonfliktprüfung ist nun von 99 auf 14 geändert.
  • - Patch von Jörg Wendel für neuen graphtft-Patch
  • - Zwei Episoden mit leerem Untertitel innerhalb 'Vermeide Wiederholung' werden jetzt als unterschiedlich gewertet. Damit ergeben sich mehr Aufnahmen, aber es wird verhindert, dass man eine Folge nur wegen eines fehlerhaften EPGs verpasst.
  • u.v.m siehe History
[1]
0.9.24 Aktuelle Version 29.04.2008
  • - Unterstützung von vdr-1.6.x/1.7.x
  • - Die Suche und damit das Suchtimer-Update sind nun etwa 25% schneller
  • - Schnellere EPG-Menus, danke an die Patch-Authoren von http://www.open7x0.org
  • - Unterstützung des VDRSymbols-Font (aktivieren mit 'WarEagle=1' in epgsearchmenu.conf)
  • - der EPG-Befehl 'Suche in Aufnahmen' wertet nun die info.vdr anstelle des Aufnahmepfades aus und macht zusätzlich eine fuzzy-Suche, vorgeschlagen von Mase@vdrportal
  • u.v.m siehe History http://winni.vdr-developer.org/epgsearch/HISTORY.DE
[2]

Aktuelle Version

Version 0.9.24 0.9.25 Beta 14

Links

  1. Homepage des Plugins
  2. Perl-compatible regular expression library
In anderen Sprachen