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