epgsearchblacklists.conf(5)  EPGSearch Version 2.4.6 epgsearchblacklists.conf(5)

NAME
     epgsearchblacklists.conf – blacklist for searches and search timers

DESCRIPTION
     Blacklists  can  be created for searches and search timers and are saved in
     this file.

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

     As an example, 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.

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.

     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 covers at least the first 19
     fields.

     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.

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 and LICENSE
     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 un‐
     der 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  FIT‐
     NESS 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)

perl v5.40.1                       2026-04-19        epgsearchblacklists.conf(5)
