rt2mei - Configuration

File Format

NOTE: The format of the configuration file changed in version 0.5 to include Service Start Time and Service Stop Time.

The configuration file is a plain text file that can be edited in any plain text editor for the platform upon which rt2mei is to be run.

Each line is considered on its own. Configuration data never spans more than one line.

Blank lines are ignored.

Comments are permitted and may appear anywhere within the document. A comment starts with the characters // and continues until the end of the line. A comment may, therefore, appear on the same line as configuration data.

Configuration data is in the form of 6 fields, separated by a | character, as shown below.

<Selected>|<LCN>|<RT id>|<RT Channel>|<Svc Start Time>|<Svc Stop Time>

Where

Field	Description
Selected	Determines whether or not the EPG data for this channel will be grabbed. See fuller explanation below.
LCN	Logical Channel Number. The number the Toppy (or any other Freeview box) assigns to the channel. This may vary slightly depending on location so check here to ensure that it is correct.
RT id	The number that the Radio Times website uses to identify this channel. Under no circumstances should you change this.
RT Channel	This is the name of the channel, as used by the Radio Times website. Try to resist the urge to change this :)
Svc Start Time	This is the time that broadcasts start on the channel. This may be omitted if EPG data from the RT website does not cover more hours than is broadcast on Freeview.
Svc Stop Time	This is the time that broadcasts end on the channel. This may be omitted if EPG data from the RT website does not cover more hours than is broadcast on Freeview.

The rt2mei.cfg file that is included in the download is a good example.

You will notice that the same LCN is used on more than one line, this is to account for regional variations. An LCN may only be selected once.

The 'Selected' Field

If you do not want to grab the EPG data for this channel then leave this field blank. Spaces count as blank so feel free to include them.

If this field is not blank then the EPG data for this channel will be grabbed unless you have selected the same LCN more than once.

If you have used the -f option in order to suppress the creation of a Favourites file then it does not matter what non-blank characters you put in this field to indicate that the EPG data should be grabbed.

If you have not used the -f option (which is the default) then you must insert a number in this field. The number indicates the order in which the data will be written in the rt2mei.mcl file, and hence the order in which it will be displayed by MyStuff. Channels appear in the Favourites in ascending order of number in this field. Duplicate numbers are not permitted.

The Service Start and Stop Time Fields

There are some channels that broadcast 24/7 on Sky, for example, but only broadcast between certain hours on Freeview. An example of such a channel is ABC1 that only broadcasts between 0600hrs and 1800hrs on Freeview.

These two fields will filter out EPG data that falls outside of the Freeview broadcast hours and will prevent the unwary user from trying to record programs that will not be received on Freeview. In the event that the start or end of a program is clipped because of the limited Freeview broadcasting hours then a note to this effect is added to the start of the program description.

Channels such as BBC3 that broadcast universally between 1900hrs and 0600hrs do not need their hours entering into these fields because the only available EPG data is for those hours.

Including unneeded service times will do no harm but will slow down the generation of the MEI file because more work is required to be done.