epgsearchdirs.conf(5)

📦
version 2.4.6 · 8 versions
, in ubuntu stonking

🎀 epgsearchdirs.conf(5) 🎀

okay bestie, this is the epgsearchdirs.conf man page — EPGSearch version 2.4.6, and it's literally all about recording directories. it's a short one, but it's a good one. let's get into it 💅

✨ NAME ✨

epgsearchdirs.conf – recording directories, the whole vibe 💖

🌸 DESCRIPTION 🌸

so in EPGSearch, you constantly have to type out entire directory paths — like, constantly, especially when you're editing search timers. and typing long paths by hand is genuinely the worst. 😭 so instead: you put your frequently used paths in this file, and then you can just pick them from the menu. iconic behaviour, no notes.

this file is one of the sources for the 'Select directory' menu. the items you see in that menu get collected from all of these places:

  • current recording directories
  • current timer directories
  • directories used in search timers
  • directories specified in this file 👈 (that's us!!)
  • entries in the VDR file folders.conf

the menu consolidates all the found directories and shows only the distinct ones — no dupes, we don't do dupes here ✨.

the 'yellow' key lets you change the level of the directories shown. and items that contain EPG category variables, like '%Genre%', always appear before other directories. they also don't depend on the level at all, and they're shown with their full directory path.

heads up, this one's a real detail: if this menu is called from the timer-edit menu and the selected item already contains the variables '%Title%' or %Subtitle, the timer's 'File' entry gets cleared — because the title or subtitle is already included in the 'Directory' item. so like, don't be surprised when it happens 🫶

🦋 SYNTAX 🦋

each line contains the pathname of a directory, and that pathname can include variables if it needs to. you can use internal variables, EPG category variables configured in epgsearchcats.conf, and variables defined in epgsearchuservars.conf. mix and match, go off 👑

the following internal variables are available:

  • %Time% — an event's start time, in 'HH:MM' format ⏰
  • %Time_D% — an event's start date, in 'DD' format
  • %Time_W% — the name of the weekday on which an event starts
  • %Time_Lng% — an event's start date and time in Epoch encoding (i.e., seconds since 1970-01-01 00:00 UTC) — yes, the big number 🧮
  • %Date% — an event's start date, in 'DD.MM.YY' format
  • %DateSh% — an event's start date, in 'DD.MM' format
  • %Title% — an event's title 🌟
  • %Subtitle% — an event's subtitle

also see epgsearchcats.conf(5) and epgsearchuservars.conf(5) for further variables — there's more where that came from 💜

🌈 EXAMPLE 🌈

here's the whole thing in action, copy-paste energy:

   %Category%~%Genre%
   %Category%~%Genre%~%Title%~%Episode%: %Subtitle%
   %Series%
   Information~Nature~%Title%~%Episode%: %Subtitle%
   Movies~Action
   Movies~Documentary
   Movies~Drama
   Movies~Horror
   Music
   Sports

look at those tidy little paths. obsessed. 🍓

🧚 AUTHOR (man pages) 🧚

Mike Constabel <epgsearch (at) constabel (dot) net> — thank you for your service 🫡

💀 REPORT BUGS 💀

bug reports (german):

<http://projects.vdr-developer.org/projects/plg-epgsearch>

mailing list:

<http://www.vdr-developer.org/mailman/listinfo/epgsearch>

found something cursed? tell the people, they wanna know 🙈

Copyright (C) 2004-2010 Christian Wieninger

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 http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

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

fr fr read the license, bestie — it's giving "legally required and also kind of iconic" 📜✨

⭐ SEE ALSO ⭐

epgsearch(1), epgsearchcats.conf(5), epgsearchuservars.conf(5)

and that's the page!! 💖 this build was rendered by perl v5.40.1 on 2026-04-19 — so if you're reading this, hi from the future, hope your directories are cute and your timers are tidy. slay 🎀🦋💅

📦 where this page comes from