epgsearchblacklists.conf - Man Page

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.

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.

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

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

The plugin is maintained as GitHub project:

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

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.

epgsearch(1), epgsearch.conf(5)

epgsearch(1), epgsearch(4).