epgsearchblacklists.conf(5)

📦
version 2.4.6 · 8 versions
, in ubuntu stonking

💅 epgsearchblacklists.conf(5) — blacklist central, bestie 💅

okay so this is the epgsearchblacklists.conf(5) manual page for EPGSearch Version 2.4.6, and it’s literally all about blacklists for searches and search timers. buckle up, we’re going in. 🎀

🌸 NAME 🌸

epgsearchblacklists.conf — blacklist for searches and search timers

💖 DESCRIPTION 💖

Blacklists can be created for searches and search timers, and they are saved in this file. periodt. ✨

Blacklists are essentially the same as normal searches. One or more blacklists can be selected for each search or search timer as needed.

Take this example, bestie: consider a search timer "Crime" that is intended to find all crime series. The blacklist "Columbo", on the other hand, retrieves all episodes of the crime series "Columbo." If the blacklist "Columbo" is added to the search timer "Crime", all crime series are first searched for, and the results are then compared with the results in the blacklist. Events that are also included in the results of the blacklist are then discarded. no cap, that’s the whole filtering moment. 🔥

🧚 SYNTAX 🧚

This file has a format similar to epgsearch.conf. However, blacklists are no search timers, but rather "simple" searches. Therefore, the fields ("parameters") that are only needed for timer management, such as 'use as search timer', are irrelevant and omitted. The fields are also arranged differently than in search timers for historical reasons. iykyk, history said “vibes only.” 🦋

Blacklists include the following fields, which (with the exception of field 22) are also present in search timers:

  • 1 — Unique identifier
  • 2 — Search term
  • 3 — Use time
  • 4 — Start after [HHMM]
  • 5 — Start before [HHMM]
  • 6 — Use channel
  • 7 — Channel selection
  • 8 — Match case
  • 9 — Search mode
  • 10 — Use title
  • 11 — Use subtitle
  • 12 — Use description
  • 13 — Use duration
  • 14 — Minimum duration [HHMM]
  • 15 — Maximum duration [HHMM]
  • 16 — Use day of week
  • 17 — Day of week
  • 18 — Use extended EPG information
  • 19 — Extended EPG information values
  • 20 — Fuzzy tolerance
  • 21 — Matching mode of extended EPG information
  • 22 — Use as global blacklist
    • Flag with values 0 = no, 1 = yes.
  • 23 — Content descriptors
  • 24 — Matching mode of content categories
  • 25 — Matching mode of special characteristics
  • 26 — Use parental rating
  • 27 — Minimum parental rating
  • 28 — Maximum parental rating

A blacklists's entry is considered valid if it covers at least the first 19 fields. that’s the cutoff, bestie.

For common fields of blacklists and search timers, the specifications from epgsearch.conf(5) apply.

🫶 AUTHORS (man pages) 🫶

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

Revised and adapted to recent plugin features by the current maintainers. shoutout to the maintainers, they’re doing amazing work. ✨

🌈 PROJECT SITE 🌈

The plugin is maintained as GitHub project:

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

that’s the spot 👀

🐛 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/>

don’t be shy, that’s literally what it’s for 💅

Copyright (C) 2004-2010 Christian Wieninger

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

okay legal bestie time — here’s the whole thing:

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 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), epgsearch.conf(5)

that’s the whole page, bestie 💖 — cute footer sign-off: perl v5.40.1, date 2026-04-19, manual name epgsearchblacklists.conf(5). slay and bye 👑

📦 where this page comes from