epgsearchcmds.conf(5)

📦
version 2.4.6 · 8 versions
, in ubuntu stonking

✨ epgsearchcmds.conf(5) ✨

okay bestie, welcome to epgsearchcmds.conf — the EPG commands file, from EPGSearch Version 2.4.6 💅 (the man page name is right there in the title, iykyk).

🎀 NAME 🎀

epgsearchcmds.conf – EPG commands ✨

💖 DESCRIPTION 💖

So this file is literally full of commands that — just like what commands.conf or reccmds.conf do for VDR — get applied to whichever event you've got selected in one of the EPG menus. Iconic, right? BUT heads up: nested commands, as introduced by VDR 1.7.12, are not supported. Not a vibe, but it's the rules. 💀

EPGSearch ships with eight preset commands. If a file called epgsearchcmds.conf exists, its commands get appended to the list of internal commands and start at position 9. Slay.

🌸 Localization 🌸

Want a language-dependent list of commands? Easy. Just translate your present epgsearchcmds.conf into your preferred OSD language and store it as epgsearchcmds-<LOC>.conf, where <LOC> is the locale's code from 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"
  // see the source file
  // for the complete list
}

If more codes are listed for one language (like 'eng,dos'), just choose one of them, bestie. 🫶

If a file matching the VDR's OSD language is available, that's the one that gets loaded. If no such file exists, the system will attempt to load the epgsearchcmds.conf file instead. 💖

🦋 Command parameters 🦋

When a command is executed, these parameters get handed to it — no cap:

  • $1 — Title of the EPG entry.
  • $2 — Start time of the EPG entry in Epoch encoding (i.e., seconds since 1970-01-01 00:00 UTC), like in the shutdown script.
  • $3 — Stop time of the EPG entry in Epoch encoding (i.e., seconds since 1970-01-01 00:00 UTC).
  • $4 — Channel number of the EPG entry.
  • $5 — Long channel name of the EPG entry.
  • $6 — Subtitle of the EPG entry, or an empty string if not present.

Strings are enclosed in single quotes (apostrophes) when the command is called. ⭐

✨ SYNTAX ✨

Every line in the file is a user-defined command, made of these fields:

  • Menu entry — the term under which the command shall appear in the command list. The term must not contain ':' characters. And if the term ends with a '?' character, confirmation will be requested before the command is executed. 👑
  • Command — the program or script to be executed when the command is invoked. The use of full pathnames is recommended. 💜

The fields are separated by a ':' character. If a ':' character is contained in the command's invocation, it does not need to be treated specially — that is, it does not need to be replaced with a specific substitute. 🙈

Lines beginning with a '#' character represent comments and are ignored. 💅

🌈 EXAMPLES 🌈

 Remember event?               : /usr/local/bin/rememberevent.sh 0
 Remember and switch to event? : /usr/local/bin/rememberevent.sh 1
 Show EPG                      : /usr/local/bin/epg2taste.sh

The above scripts, amongst others, can be found in the directory scripts of the EPGSearch sources. 🎀

🧚 AUTHORS (man pages) 🧚

Originally provided by Mike Constabel <epgsearch (at) constabel (dot) net>.

Revised and adapted to recent plugin features by the current maintainers.

🔥 PROJECT SITE 🔥

The plugin is maintained as GitHub project:

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

💀 REPORTING BUGS 💀

Issues can be reported, and features be suggested, through the project's bug tracker:

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

Copyright (C) 2004-2010 Christian Wieninger

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

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Or, point your browser to <https://www.gnu.org/licenses/old-licenses/gpl-2.0.html>

The original author can be reached via cwieninger@gmx.de.

Current maintainers can be reached via the project's GitHub site (see above).

The MD5 code has been derived from the MD5 Message-Digest Algorithm of RSA Data Security, Inc.

🍓 SEE ALSO 🍓

epgsearch(1)

and that's the whole page, bestie — mwah 💋 this edition was rendered by perl v5.40.1 and dated 2026-04-19. go forth and command your EPG ✨🦋💖

📦 where this page comes from