Skip to content
Hika van den Hoven edited this page Jan 12, 2016 · 8 revisions

#A description and syntax for the sourcematching.json file

  • Dict-keywords always must be strings.
  • Quotes must be double quotes
  • Unless otherwise specified, all values are strings enclosed in double quotes.
  • Group numbers and Source numbers are always integers. Unless they are dict-keywords.
  • On not backward compatible syntactical changes, a table is copied adding a version number. The old table is for backward compatibility kept for 2 to 3 months.

##Tables only used on configure ###source_channels (dict)
Syntax: A dict of all the source numbers each containing a dict of all the chanids containing the ID for that source.
Since: 2.2.6
Description: This table creates the linking between the channels supplied on the various sources. It should contain all the channels for that source as here also the chanid is defined. If a channel is missing a chanid is creating from the source number and the ID.

###channel_rename (dict)
Syntax: A dict of chanids with their channel name.
Since: 2.2.6
Description: Normally the channel name provided by the first source is used. This table can be used to override this naming.

###channel_groups (dict)
Syntax: A dict of channel groups with their name.
Since: 2.2.6
Description: These names are used as the group headers in the configuration file.

###group_order (list)
Syntax: An ordered list of the group numbers
Since: 2.2.8
Description: This is used by configure to order the groups. The first number should be 0 to place the active channels on top if group_active_channels is set to True. Both this table and the previous table are compared on every run. Any missing number in either one is added on the fly.

###channel_grouping (dict)
Syntax: A dict of all sources containing a dict of all channel groups each containing a list of IDs from that source.
Since: 2.2.6
Description: Most of the time a channel group is provided by the source. These lists override these values.

###rtl_channellist (dict)
###virtual_channellist (dict)
Syntax: A dict of dicts, the keywords being the IDs of the channels provided by source 2/11. Each channel dict must contain the "name" keyword. Optional keywords are:

  • group: integer
  • icon: string
  • icongrp: integer
  • HD: TRUE/FALSE

Since: 2.2.9
Description: This table is used by configure to define the available channels for this source.

###logo_source_preference (list)
Syntax: A list of logo source numbers
Since: 2.2.8
Description: This list defines the order of preference for the available logo_providers. Most are linked to a channel source. 0, 1 and 4 are (semi) independent and defined through the following table. On configure the first logo_provider providing a logo is selected.

###logo_names (dict)
Syntax: A dict of chanids keywords containing a logo reference. This is a list of a logo_provider and a logo name, possibly also containing part of the url path and an extension.
Since: 2.2.6
Description: On every run the logo_provider url and this logo name is concatenated to a full url. Historically no extensions were added to the logo name. For most providers this is always the same and is added on configure. As at least one provider has mixed extensions, future additions should also contain the extension.

##Tables used on both configure and regular runs ###data_version Syntax: A string containing the current data version
Since: 2.2.6
Description: This is compared to the value in the users configuration. If it is higher, the warning messages for the higher numbers will be placed in the log file

###warning_message_2/warning_message (dict) Syntax: A dict of version numbers each containing a list of strings/lines to be placed in the log for that version. Each line should be closed with a newline ('\n')
Since: 2.2.7/2.2.6
Description:

###program_version
Syntax: Since: 2.2.6
Description:

###version_message (list)
Syntax: Since: 2.2.6
Description:

###user_agents (list)
Syntax:
Since: 2.2.6
Description:

###active_sources (list)
Syntax:
Since: 2.2.6
Description:

###prime_source_order (list)
Syntax:
Since: 2.2.6
Description:

###prime_source (dict)
Syntax:
Since: 2.2.6
Description:

###prime_source_groups (dict)
Syntax:
Since: 2.2.6
Description:

###empty_channels (dict) Syntax:
Since: 2.2.6
Description:

###merge_into (dict) Syntax: A dict of chanid keywords containing a dict. The keywords are:

  • "chanid" string, the old chanid to be potentially used as alias
  • "sources" a dict of sources and their IDS that are moved
  • "date" a date string "yyyymmdd" being the date of addition
  • "message" a string to be placed in the log

Since: 2.2.8
Description: This table is for changes on Channel/source combinations that can affect the chanids. If a source being moved into another source is found active, the new channel is aliased to the old one. 2 to 3 month after a new entry this will again be removed making the change definitive without the automatic aliasing.

##Tables only used on regular runs ###combined_channels_2/combined_channels (dict)
Syntax: A dict of chanid keywords containing a list of other channels. These are all either dicts or strings, the latter implying the "chanid" keyword. Further optional keywords are:

  • "start" a string containing a time "uu:mm". This should be in the CET_CEST timezone.
  • "end" a string containing a time "uu:mm". This should be in the CET_CEST timezone.

Since: 2.2.8/2.2.6
Description: This contains a list of channels to be merged in to the keyworded chanid. Further values give restrictions on the merge.

###groupslot_names (list) Syntax:
Since: 2.2.6
Description:

###no_genric_matching (dict) Syntax:
Since: 2.2.8
Description:

###coutrytrans (dict) Syntax:
Since: 2.2.6
Description:

###notitlesplit (list) Syntax:
Since: 2.2.6
Description:

###ttvdb_aliasses (dict) Syntax:
Since: 2.2.6
Description:

###logo_provider (list) Syntax:
Since: 2.2.6
Description:

Clone this wiki locally