epgsearchcmds.conf(5)

NAME
epgsearchcmds.conf – EPG-Befehle

BESCHREIBUNG
Diese Datei enthält Befehle, die – ähnlich wie bei den VDR-Dateien commands.conf bzw. reccmds.conf – auf eine in der Programmübersicht ausgewählte Sendung angewandt werden können. Hierarchische Kommando-Menüs, wie sie seit VDR 1.7.12 verfügbar sind, werden jedoch nicht unterstützt.

Intern besitzt EPGSearch acht fest vorgegebene EPG-Befehle. Sofern die Datei epgsearchcmds.conf existiert, werden die darin aufgeführten Befehle ab Position 9 gelistet.

  Lokalisierung
Wenn eine sprachabhängige Befehlsliste gewünscht wird, kann die Datei epgsearchcmds.conf in die entsprechende OSD-Sprache übersetzt und unter dem Dateinamen epgsearchcmds-<LOC>.conf gespeichert werden. Dabei entspricht <LOC> dem Sprachcode aus i18n.c:

    { "eng,dos",
      "deu,ger",
      "slv",
      "ita",
      "dut,nla,nld",
      "por",
      "fra,fre",
      "nor",
      "fin,smi",
      "pol",
      "esl,spa",
      "ell,gre",
      "sve,swe",
      "rom,rum",
      "hun",
      "cat,cln",
      "rus",
      "hrv",
      "est",
      "dan"
      // die vollständige Liste
      // findet sich im Quellcode
    }

Wenn für eine Sprache mehrere Codes verfügbar sind (bspw. 'deu,ger'), kann ein beliebiger davon verwendet werden.

Liegt eine Datei entsprechend der im VDR eingestellten OSD-Sprache vor, wird diese geladen. Existiert eine solche jedoch nicht, wird stattdessen versucht, die Datei epgsearchcmds.conf zu laden.

  Befehlsparameter
Wenn ein Befehl ausgeführt wird, werden folgende Parameter übergeben:

$1  Titel der Sendung.

$2  Startzeitpunkt der Sendung in Epoch-Notation (Sekunden seit dem 01.01.1970, 00:00 UTC), wie auch beim Shutdown-Skript.

$3  Endzeitpunkt der Sendung in Epoch-Notation (Sekunden seit dem 01.01.1970, 00:00 UTC).

$4  Nummer des Kanals mit der Sendung.

$5  Ausführlicher Name des Kanals mit der Sendung.

$6  Untertitel der Sendung oder ein leerer String, falls nicht vorhanden.

Strings werden beim Aufruf des Kommandos in einfache Anführungszeichen (Apostrophe) gesetzt.

FORMAT
Jede Zeile der Datei repräsentiert einen benutzerdefinierten Befehl und umfasst die folgenden Felder:

Menüeintrag
    Begriff, unter dem der Befehl in der Befehlsliste erscheinen soll. Der Begriff darf kein ':' enthalten. Endet der Begriff mit '?', wird vor Ausführung des Befehls eine Bestätigung angefordert.

Kommando
    Programm oder Skript, das bei Aufruf des Befehls ausgeführt werden soll. Die Verwendung vollständiger Pfadnamen wird empfohlen.

Die Felder sind durch ':' getrennt. Ein im Kommandoaufruf enthaltenes ':' muss nicht gesondert behandelt, das heißt, durch eine spezifische Zeichenfolge ersetzt werden.

Zeilen, die mit '#' beginnen, sind Kommentare und werden ignoriert.

BEISPIELE
 Sendung merken?                : /usr/local/bin/rememberevent.sh 0
 Sendung mit Umschalten merken? : /usr/local/bin/rememberevent.sh 1
 EPG aufrufen                   : /usr/local/bin/epg2taste.sh

Die genannten und weitere Skripte finden sich im Verzeichnis scripts von EPGSearch.

AUTOREN (Man-Pages)
Ursprünglich erstellt von Mike Constabel <epgsearch (at) constabel (dot) net>.

Überarbeitet und an die aktuellen Features von EPGSearch adaptiert durch die derzeitigen Maintainer.

PROJEKTSEITE
Das Plugin wird als Projekt auf GitHub geführt:

<https://github.com/vdr-projects/vdr-plugin-epgsearch/>

FEHLER MELDEN
Fehlerberichte sowie Feature-Anfragen können über den Bugtracker des Projekts eingespeist werden:

<https://github.com/vdr-projects/vdr-plugin-epgsearch/issues/>

COPYRIGHT und LIZENZ
Copyright © 2004-2010 Christian Wieninger

Copyright © 2011-2025 TomJoad (VDR-Portal) et al.

Dieses Programm ist freie Software. Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 2 der Lizenz oder (nach Ihrer Option) jeder späteren Version.

Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, dass es Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License.

Sie sollten ein Exemplar der GNU General Public License zusammen mit diesem Programm erhalten haben. Falls nicht, schreiben Sie an die Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. Oder rufen Sie in Ihrem Browser <https://www.gnu.org/licenses/old-licenses/gpl-2.0.html> auf.

Der ursprüngliche Autor kann über cwieninger@gmx.de erreicht werden.

Die aktuellen Maintainer können über die Projektseite auf GitHub (siehe oben) erreicht werden.

Der MD5-Code ist abgeleitet aus dem Message-Digest-Algorithmus MD5 von RSA Data Security, Inc.

SIEHE AUCH
epgsearch(1)