Read Me

1. Installation

1. Install the addon using the zip file from the 'Add-ons' sub-menu under 'System' on the XBMC home menu.
2. Under 'Programs' on the home menu you should now see 'TV Guide (XMLTV)'. Right-click on this (or press 'c') to bring up the context menu and select 'Add-on settings'. Under 'General' select 'XMLTV folder' and change it to where you keep your XMLTV listings file(s).
3. Check your XMLTV listings files are valid using tv_validate_file (see http://wiki.xmltv.org/index.php/XmltvValidation for how to do this).
4. Start the addon by selecting 'TV Guide (XMLTV)'. You should see a 'Reading TV listings...' progress bar and then a list of the current and next programs for each channel. If you get a blank screen, hit ESC and check the 'XMLTV folder' and its contents.

2. XMLTV

You need to generate a valid XMLTV file and put it into the configured directory. You will need to install and configure XMLTV (http://wiki.xmltv.org/). Add a cron (progammed task) to generate daily the XMLTV files, e.g.:

rm ~/.xbmc/userdata/addon_data/script.program.xmltv/xmltv/*xml
tv_grab_uk_rt --day 1 | tv_sort | tv_split --output ~/.xbmc/userdata/addon_data/script.program.xmltv/xmltv/%channel%.xml

When you configure XMLTV itself it will ask you which channels you want. The addon displays all configured channels, alphabetically. There is no filtering or sorting in the addon.

XMLTV has "grabbers" for many countries (see http://wiki.xmltv.org/).

3. Launching channel viewers (optional)

'XMLTV Source 1/2' are only used to launch another addon when you select a channel (e.g. to actually watch that channel).

For example, settings:

'XMLTV Source Info URL': 'http://www.laguiatv.com/programacion.php'
'TV plugin': 'htsp://127.0.0.1:9982/tags/0/'

...will run the htsp (tvheadend) when you select a channel whose source URL (from the XMLTV file) is 'http://www.laguiatv.com/programacion.php'.