Introduction
More about XMLTV can be found from:http://en.wikipedia.org/wiki/XMLTV
Supported Datasources
- Local Drop Folder
- Http
XMLTV DTD
XMLTV DTD: http://xmltv.cvs.sourceforge.net/viewvc/xmltv/xmltv/xmltv.dtd
Example of XMLTV
- <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tv source-info-url="https://helpdesk.icareus.com/portal/en/kb/articles/xmltv">
<channel id="Icareus HD">
<display-name>ICAREUS TV</display-name>
</channel>
<programme channel="Icareus HD" start="20250909173000 +0300" stop="20250909181000 +0300">
<content-type>
<value>64</value>
</content-type>
<rating>
<value>9</value>
</rating>
<title lang="en">Icareus magazin</title>
<sub-title lang="en">Short description of interesting program.</sub-title>
<desc lang="en">Description of program here.</desc>
<title lang="fr">Magazine Icareus</title>
<sub-title lang="fr">Brève description d'un programme intéressant.</sub-title>
<desc lang="fr">Description du programme ici.</desc>
<title lang="es">Revista Ícareo</title>
<sub-title lang="es">Breve descripción de un programa interesante.</sub-title>
<desc lang="es">Descripción del programa aquí.</desc>
<title lang="ar" dir="rtl">مجلة إيكاريوس</title>
<sub-title lang="ar" dir="rtl">وصف مختصر للبرنامج المثير للاهتمام.</sub-title>
<desc lang="ar" dir="rtl">هذا وصف البرنامج.</desc>
</programme>
</tv>
1. Start time - 'start' attribute
2. Duration - ('stop'-'start') attributes
3. Language - 'lang' attribute of 'title', 'sub-title' and 'desc' tags
4. name - 'title' tag
5. Short description - 'sub-title' tag
6. Long description - 'desc' tag
7. Free CA mode - not possible to configure using xmltv, always set to 0
8. Parental control - 'value' tag in 'rating' tag, for example 9 means that minimum age is 9 years
9. Content type - 'value' tag in 'content-type', for example 64 equals 0x40, which is Content main type "Sports" and Content sub type "general"
XMLTV Configuration for a service
- Login to Playout Web select the service to configure

- select the service that is meant to provide EPG information
- select "EIT source" tab
- select XMLTV Data Source in "EIT source" combo box
- unselect the "Use default" check box
- type the path for xml data file e.g. /opt/playout/ftp/update/xmltv/1 (here number 1 is the service id) to "Remote source folder"
- type the channel id value (e.g. <channel id="> from XML file) to the "Channel alias" -edit field
- If downloading the XMLTV files from the web, select the "Update from the web site" -check box
- in case of fetching the xml data file from web, it is possible to type API key in case of vendor requiring it
- in case of fetching the xml data file from web type the correct URL to the "URL" -edit field
- in case of uploading the xml data file with .e.g. ftp type just "-" to the "URL" -edit field
- select the "Update periodically" -check box and type suitable period to the "How often to update (seconds)" -edit field
- in
case of updating the EPG information once per day unselect the "Update
periodically" check box, but leave some value to the edit -field
mentioned above
- type suitable clock time when the EPG data should be read from xml file
- select "Overwrite existing events" -check box