Epgsearch-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
K (→‎Bilder)
(→‎Konfiguration)
 
(75 dazwischenliegende Versionen von 25 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
'''Autor:''' Christian Wieninger
 
'''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äßt sich außerdem durch einen Fortschrittsbalken etwas aufpeppen. Zusätzlich gibt es noch bis zu vier benutzerdefinierte Zeiten neben {{Button grün|Jetzt}} und {{Button gelb|Nächste}}. Der Aufbau der einzelnen Menüs kann ebenfalls nach den eigenen Wünschen angepaßt werden.
+
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.
−
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.
+
  
−
==Bilder==
+
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 {{Button grün|Jetzt}} und {{Button gelb|Nächste}}. Der Aufbau der einzelnen Menüs kann ebenfalls nach den eigenen Wünschen angepasst werden.
−
{|
+
−
| [[Bild:epgsearch-plugin-00.jpg|thumb|none|''Übersicht - Jetzt'']]
+
−
| [[Bild:epgsearch-plugin-01.png|thumb|none|''Übersicht - Jetzt'']]
+
−
|}
+
−
<!-- ==Hardwareanforderungen== -->
+
  
−
==Softwareanforderungen==
+
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.
−
* 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)
+
  
−
==Installation==
+
Eine Benachrichtigung per EMail bei Timer-Updates und/oder Timer-Konflikten ist ebenso enthalten wie die Möglichkeit, mit User-Variablen und Skriptaufrufen auf die Suchtimer umfangreichen Einfluss nehmen zu können.
−
===PCRE===
+
−
* Source
+
−
<pre>
+
−
cd $SOURCEDIR
+
−
tar xvzf pcre-<VERSION>.tar.bz2
+
−
cd pcre-<VERSION>
+
−
./configure --prefix=/usr/local
+
−
make
+
−
make install
+
−
ldconfig
+
−
</pre>
+
  
−
* [[Arch-Linux]]
+
===Status===
−
pacman -S pcre
+
Letztes Update 09/2011
  
−
* [[Crux]]
+
==Bilder==
−
prt-get depinst libpcre
+
<gallery>
 +
Bild:epgsearch-plugin-00.jpg|''Übersicht - Jetzt''
 +
Bild:epgsearch-plugin-01.png|''Übersicht - Jetzt''
 +
Bild:epgsearch-plugin-02.jpg|''Beispiel - Benachrichtigungs - Mail''
 +
</gallery>
  
−
* [[Debian]]
+
==Bedienung==
−
apt-get install libpcre3-dev
+
  
−
* [[Gentoo]]
+
Das Plugin ist zu umfangreich, um alles in diesem Artikel zu beschreiben.
−
emerge libpcre
+
Dem Plugin liegt aber eine umfangreiche Dokumentation in Form von {{wikipedia|Manpages}} bei, die auch online gelesen werden können:
 +
# [http://winni.vdr-developer.org/epgsearch/de/epgsearch.1.html README.DE]
 +
# [http://winni.vdr-developer.org/epgsearch/en/epgsearch.4.html MANUAL]
  
−
* [[SuSE]]
 
−
yast -i pcre-devel
 
  
−
==Optionen==
+
===[[SVDRP]] Befehle===
−
=== Makefile ===
+
{| class="wikitable"
−
{| border=1 cellpadding=2 cellspacing=0
+
 
|-
 
|-
−
| bgcolor=#efefef|#HAVE_PCREPOSIX = 1
+
!Parameter
−
| Entferne die # wenn Perl kompatible reguläre Ausdrücke (Perl compatible regular expressions, PCRE) verwendet werden sollen.
+
!Beschreibung
 
|-
 
|-
−
| bgcolor=#efefef|#WITHOUT_EPGSEARCHONLY = 1
+
| LSTS [ID]      || Listet alle Suchen auf, oder, falls ID angegeben wurde, die Suche mit der ID [ID].
−
| Entferne die # wenn das Mini-Plugin epgsearchonly nicht kompiliert werden soll.
+
Die Ausgabe ist im selben Format wie der Inhalt der Datei epgsearch.conf.
 
|-
 
|-
−
| bgcolor=#efefef|#WITHOUT_CONFLICTCHECKONLY = 1
+
| NEWS&nbsp;<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.
−
| Entferne die # wenn das Mini-Plugin conflictcheckonly nicht kompiliert werden soll.
+
|-
 +
| 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 <nowiki><ON|OFF></nowiki>  || 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.
 
|}
 
|}
  
−
<!-- ==Patches== -->
+
Dies ist nur ein Teil der möglichen [[SVDRP]]-Befehle. Die komplette Liste ist im [http://winni.vdr-developer.org/epgsearch/en/epgsearch.4.html#9__svdrp_interface MANUAL] nachzulesen.
 +
 
 +
<!-- ==Hardwareanforderungen== -->
 +
 
 +
==Softwareanforderungen==
 +
* (P)erl-(c)ompatible (r)egular (e)xpression library, PCRE (optional)
 +
* TRE Bibliothek, für unbegrenzt tolerante Suche (optional)
 +
 
 +
==Installation==
 +
===Optionen im Makefile===
 +
{| class="wikitable"
 +
|-
 +
| bgcolor=#efefef | #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.
 +
|-
 +
| bgcolor=#efefef | #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".
 +
|-
 +
| bgcolor=#efefef | #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.
 +
|-
 +
| bgcolor=#efefef | #HAVE_PCREPOSIX = 1
 +
| Entferne die # wenn Perl kompatible reguläre Ausdrücke (Perl compatible regular expressions, PCRE) verwendet werden sollen.
 +
|-
 +
| bgcolor=#efefef | #HAVE_LIBTRE = 1
 +
| Entferne die # wenn libtre (für unbegrenzte tolerante Suche) installiert ist.
 +
|}
  
 
==Konfiguration==
 
==Konfiguration==
Zeile 67: Zeile 89:
  
 
  cd [[Struktur|$SOURCEDIR]]/VDR
 
  cd [[Struktur|$SOURCEDIR]]/VDR
−
  patch -p1 < PLUGINS/src/epgsearch/patches/timercmds-<VERSION>.diff
+
  patch -p1 < PLUGINS/src/epgsearch/patches/timercmd-<VERSION>.diff
  
−
Dannach wie gewohnt übersetzen.
+
Danach wie gewohnt übersetzen.
  
 
===createcats===
 
===createcats===
  
−
createcats dient zum automatischen erstellen der erweiteren EPG-Kategorien. Nähere Beschreibung im MANUAL.
+
createcats dient zum automatischen Erstellen der erweiterten EPG-Kategorien. Nähere Beschreibung im MANUAL.
  
−
Nach dem kompilieren '''createcats''' in den [[Struktur|$PATH]] linken.
+
Nach dem Kompilieren '''createcats''' in den [[Struktur|$PATH]] linken.
  
 
  ln -s [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/epgsearch/createcats /usr/local/bin
 
  ln -s [[Struktur|$SOURCEDIR]]/VDR/PLUGINS/src/epgsearch/createcats /usr/local/bin
Zeile 81: Zeile 103:
 
Aufruf kann über die '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/[[epgsearchcmds.conf]]''' erfolgen (siehe letzter Eintrag).
 
Aufruf kann über die '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/[[epgsearchcmds.conf]]''' erfolgen (siehe letzter Eintrag).
  
−
<!-- ==Einstellungen== -->
+
<!-- ===Einstellungen=== -->
−
 
+
===Parameter===
−
==Parameter==
+
{| class="wikitable"
−
{| border=1 cellpadding=2 cellspacing=0
+
|-
−
|- bgcolor=#efefef
+
 
!Parameter (kurz)
 
!Parameter (kurz)
 
!Parameter (lang)
 
!Parameter (lang)
 
!Beschreibung
 
!Beschreibung
 
|-
 
|-
−
| -f file || --svdrpsendcmd=file || Der Pfad zum Script svdrpsend.pl für die externe [[SVDRP]] Kommunikation. Standard ist interne Kommunikation.
+
| -f ''<DATEI>'' || --svdrpsendcmd=''<DATEI>'' || Der Pfad zum Script svdrpsend.pl für die externe [[SVDRP]] Kommunikation. Standard ist interne Kommunikation.
 
|-
 
|-
−
| -c path || --config=path      || Pfad zu den Konfigurations-Dateien von epgsearch. Standard ist '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/'''
+
| -c ''<DIR>''  || --config=''<DIR>''        || Pfad zu den Konfigurations-Dateien von epgsearch. Standard ist '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/'''
 
|-
 
|-
−
| -l file || --logfile=file     || Logfile für epgsearch. Standard ist '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/epgsearch.log'''
+
| -l ''<DATEI>'' || --logfile=''<DATEI>''     || Logfile für epgsearch. Standard ist '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/epgsearch.log'''
 
|-
 
|-
−
| -v n   || --verbose=n         || Level der Logausgaben:
+
| -v ''<n>''    || --verbose=''<n>''          || Level der Logausgaben:
 
*1 Allgemeine Meldungen
 
*1 Allgemeine Meldungen
 
*2 Detaillierte Meldungen
 
*2 Detaillierte Meldungen
 
*3 Sehr detaillierte Meldungen für Debugging
 
*3 Sehr detaillierte Meldungen für Debugging
 
|-
 
|-
−
| -r     || --reloadmenuconf   || Neuladen der epgsearchmenu.conf bei jedem aufruf des Plugins
+
| -r             || --reloadmenuconf           || Neuladen der epgsearchmenu.conf bei jedem Aufruf des Plugins
−
|}
+
−
 
+
−
<!-- ==Bedienung== -->
+
−
 
+
−
==[[SVDRP]] Befehle==
+
−
{| border=1 cellpadding=5 cellspacing=0
+
−
|- bgcolor=#efefef
+
−
!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&nbsp;<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.
+
| -m <CMD>       || --mailcmd=<CMD>           || Alternatives Mail-Script für die Timer-Update- und Konflikt-Benachrichtigung per EMail
−
|-
+
−
| 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 <nowiki><ON|OFF></nowiki>  || 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.
+
 
|}
 
|}
  
−
<!-- ==Probleme== -->
 
  
−
==Tipps==
+
===Kanal Gruppen===
−
'''Zur allgmeinen Bedienung:'''
+
Wer Kanalgruppen (epgsearchchangrps.conf) definieren möchte findet im angegebenen Link (ff.) und dann im Manual weiteres.
−
Einige Farbtasten sind doppelt belegt. Einfach mal {{Button neutral|0}} drücken, um auf die andere Belegung zu wechseln.
+
vdr-portal.de/forum/index.php?thread/127860-epgsearch-epgsearchchangrps-conf/
  
−
'''Zum Aufruf:'''
+
==Sonstiges==
−
Die verwendete Taste zum Aufrufen des Plugins kann in der [[keymacros.conf]] konfiguriert werden. Um das Plugin zum Beispiel mit {{Button grün|Grün}} aufzurufen:
+
  
 +
{{Box Hinweis|
 +
Mit der Version 0.9.18 hat sich der Speicherort der Konfigurationsdateien geändert! Bitte die HISTORY lesen.
 +
}}
 +
 +
===Tipps===
 +
; Zur allgemeinen Bedienung : Einige Farbtasten sind doppelt belegt. In diesem Fall {{Button neutral|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 {{Button grün|Grün}} aufzurufen:
 
{{Box Datei | [[Struktur|$VDRCONFIG]]/[[keymacros.conf]] |
 
{{Box Datei | [[Struktur|$VDRCONFIG]]/[[keymacros.conf]] |
 
  # Remote control key macros for VDR
 
  # Remote control key macros for VDR
Zeile 156: Zeile 158:
 
  Yellow    @[[prefermenu-plugin|prefermenu]]
 
  Yellow    @[[prefermenu-plugin|prefermenu]]
 
}}
 
}}
−
 
 
Alternativ über einen "User Key":
 
Alternativ über einen "User Key":
  
 
  User1    @epgsearch
 
  User1    @epgsearch
  
−
Es ist auch möglich das Menü des Plugins um eigene Befehle zu erweitern. Dazu ist die [[epgsearchcmds.conf]] anzupassen.
+
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 '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/[[epgsearchcmds.conf]]''' erstellen.
 
Falls diese noch nicht existiert, einfach als '''[[Struktur|$VDRCONFIG]]/plugins/epgsearch/[[epgsearchcmds.conf]]''' erstellen.
  
−
Alles weitere und Beispielscripte befinden sich in den Sourcen des Plugins.
+
Alles weitere und Beispielskripte 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. (ab vdr-1.7.15, bei alten Systemen svdrpsend.pl)  <pre>svdrpsend plug epgsearch LSTS</pre> eine Liste aller Suchtimer auswerfen. Falls nicht, dann sollte geprüft werden, ob im Setup von epgsearch der gleiche Port (Standard ist 2001 bzw. 6419 ab vdr-1.7.15) 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 neu programmieren" aktivieren. Andernfalls: Verliert man also seine Timer aus irgendeinem Grund, muss man die Epgsearch-interne Liste der erledigten Timer entfernen. Am einfachsten im Verzeichnis [[Struktur|$VDRCONFIG]]/plugins/epgsearch/<pre>rm timersdone.conf</pre>. Alternativ geht das auch per OSD: Menü "Suche/Aktionen/Zeige erstellte Timer", hier dann entweder alle löschen oder nur die von einzelnen Suchtimern.
 +
* Eventuell 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 eventuell Löschen oder die Option deaktivieren.
 +
 
 +
==Erweiterungen==
 +
 
 +
* [[VDRSeriesTimer.pl]] Fügt den Serien-Timern die Staffel/Folge-Information hinzu.
 +
 
 +
==Web-Frontends==
 +
 
 +
Zum Erstellen und Bearbeiten von Suchtimern:
 +
* [[Live-plugin|Live]] - das Live Interactive VDR Environment
 +
* [[Vdradmin AM]]
 +
 
 +
==Versions-Historie==
 +
{| width=100% class="wikitable"
 +
|-
 +
! Version
 +
! Datum
 +
! Beschreibung
 +
! Link
 +
|-
 +
| 1.0.1.beta5
 +
| 29.03.2013
 +
|
 +
| [http://winni.vdr-developer.org/epgsearch/downloads/beta/vdr-epgsearch-1.0.1.beta5.tgz 1.0.1.beta5]
 +
|-
 +
| 1.0.0 (Aktuelle Version)
 +
| 11.09.2011
 +
|
 +
| [http://winni.vdr-developer.org/epgsearch/downloads/vdr-epgsearch-1.0.0.tgz 1.0.0]
 +
|}
 +
Ab VDR Version 2.1.2 wird der Patch benötigt: [https://github.com/VDR4Arch/vdr4arch/blob/master/plugins/vdr-epgsearch/epgsearch-vdr2.1.2compat.diff epgsearch-vdr2.1.2compat.diff]
 +
 
 +
Für VDR 2.3.x gibt es hier Bemühungen es anzupassen:
 +
[www.vdr-portal.de/board17-developer/board21-vdr-plugins/127498-epgsearch-für-vdr-2-3-x/ Entwicklungsthread im Portal]
 +
Diese sind hier zu einem Zwischenstand zusammengefasst:
 +
[http://www.vdr-portal.de/board17-developer/board97-vdr-core/p1284612-produktive-problem-und-pluginl%C3%B6sungen-f%C3%BCr-vdr-2-3-2-und-h%C3%B6her/#post1284612 Patchzusammenstellung von mini73 und TomJoads-Patches durch fnu]
 +
Es fehlen dort die Patches ab dem von Kamel5:
 +
[http://www.vdr-portal.de/board17-developer/board21-vdr-plugins/p1260867-epgsearch-f%C3%BCr-vdr-2-3-x/#post1260867 Patch von Kamel5]
  
−
<!-- ==Wunschliste== -->
+
==Bugs und Wünsche==
−
<!-- ==Snapshot== -->
+
* [http://projects.vdr-developer.org/projects/plg-epgsearch Bugtracker]
 +
* [http://www.vdr-developer.org/mailman/listinfo/epgsearch Mailingliste]
 +
==Aktuelle Version==
 +
[http://winni.vdr-developer.org/epgsearch/downloads/vdr-epgsearch-1.0.0.tgz Version 1.0.0]
  
 
==Links==
 
==Links==
−
# [http://www.cwieninger.de.vu Homepage des Plugins]
+
# [https://github.com/flensrocker/vdr-plugin-epgsearch/tree/vdr-2.3.1 git von mini73 inkl. Anpassungen für VDR 2.3.x basierend auf winnis git]
 +
# [http://winni.vdr-developer.org/epgsearch Homepage des Plugins]
 
# [http://www.pcre.org Perl-compatible regular expression library]
 
# [http://www.pcre.org Perl-compatible regular expression library]
 +
# [http://projects.vdr-developer.org/git/?p=vdr-plugin-epgsearch.git GIT-Repository]
 +
# [https://github.com/3PO/vdr-plugin-epgsearch GIT Mirror]
  
 
[[Kategorie:Plugins]]
 
[[Kategorie:Plugins]]
 +
[[Kategorie:EPG_und_Co]]
 +
[[Kategorie:Timer- und Aufnahmeplugins]]
 
{{i18n|epgsearch-plugin}}
 
{{i18n|epgsearch-plugin}}

Aktuelle Version vom 22. Juli 2019, 21:12 Uhr

Inhaltsverzeichnis

[Bearbeiten] 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 Skriptaufrufen auf die Suchtimer umfangreichen Einfluss nehmen zu können.

[Bearbeiten] Status

Letztes Update 09/2011

[Bearbeiten] Bilder

  • Übersicht - Jetzt

  • Übersicht - Jetzt

  • Beispiel - Benachrichtigungs - Mail

[Bearbeiten] 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


[Bearbeiten] 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 SVDRP-Befehle. Die komplette Liste ist im MANUAL nachzulesen.


[Bearbeiten] Softwareanforderungen

  • (P)erl-(c)ompatible (r)egular (e)xpression library, PCRE (optional)
  • TRE Bibliothek, für unbegrenzt tolerante Suche (optional)

[Bearbeiten] Installation

[Bearbeiten] 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.

[Bearbeiten] Konfiguration

[Bearbeiten] 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.

[Bearbeiten] 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).

[Bearbeiten] 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


[Bearbeiten] Kanal Gruppen

Wer Kanalgruppen (epgsearchchangrps.conf) definieren möchte findet im angegebenen Link (ff.) und dann im Manual weiteres. vdr-portal.de/forum/index.php?thread/127860-epgsearch-epgsearchchangrps-conf/

[Bearbeiten] Sonstiges

Hinweis
Hinweis

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


[Bearbeiten] Tipps

Zur allgemeinen 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 Beispielskripte befinden sich in den Sourcen des Plugins.

[Bearbeiten] 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. (ab vdr-1.7.15, bei alten Systemen svdrpsend.pl) 
    svdrpsend 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 bzw. 6419 ab vdr-1.7.15) 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 neu programmieren" 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.
  • Eventuell 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 eventuell Löschen oder die Option deaktivieren.

[Bearbeiten] Erweiterungen

[Bearbeiten] Web-Frontends

Zum Erstellen und Bearbeiten von Suchtimern:

[Bearbeiten] Versions-Historie

Version Datum Beschreibung Link
1.0.1.beta5 29.03.2013 1.0.1.beta5
1.0.0 (Aktuelle Version) 11.09.2011 1.0.0

Ab VDR Version 2.1.2 wird der Patch benötigt: epgsearch-vdr2.1.2compat.diff

Für VDR 2.3.x gibt es hier Bemühungen es anzupassen: [www.vdr-portal.de/board17-developer/board21-vdr-plugins/127498-epgsearch-für-vdr-2-3-x/ Entwicklungsthread im Portal] Diese sind hier zu einem Zwischenstand zusammengefasst: Patchzusammenstellung von mini73 und TomJoads-Patches durch fnu Es fehlen dort die Patches ab dem von Kamel5: Patch von Kamel5

[Bearbeiten] Bugs und Wünsche

[Bearbeiten] Aktuelle Version

Version 1.0.0

[Bearbeiten] Links

  1. git von mini73 inkl. Anpassungen für VDR 2.3.x basierend auf winnis git
  2. Homepage des Plugins
  3. Perl-compatible regular expression library
  4. GIT-Repository
  5. GIT Mirror
Von „http://vdr-wiki.de/wiki/index.php?title=Epgsearch-plugin&oldid=80444“
In anderen Sprachen