Difference between revisions of "XMLTV"

From MythTV Official Wiki
Jump to: navigation, search
(Denmark)
m (Introduction: Typo)
(105 intermediate revisions by 45 users not shown)
Line 1: Line 1:
Setting up XmlTV for use with MythTV is documented in the
+
{{User Manual TOC}}
[http://www.mythtv.org/docs/mythtv-HOWTO-5.html#ss5.2 MythTV HOWTO 5.2].
 
  
The purpose of this page is to cover specific issues that aren't necessarily covered in the official documentation. 
+
==Introduction==
  
Info on XMLTV
+
XMLTV is the name of a system which obtains and processes program guide information. If you are in North America you will use the Schedules Direct grabber which is built-in to MythTV. You do not need to install XMLTV (so you may skip this section). See instead [[Schedules Direct]]. All users in other countries need to install and configure XMLTV in order to obtain program guide listings.
http://xmltv.org/wiki/
 
  
== [[Data Direct]] ==
+
Install the xmltv package on your master backend server, using your distribution's package manager. Alternatively you can get it from http://sourceforge.net/projects/xmltv/files/
  
With zap2it no longer providing listing information to XMLTV for North America (tv_grab_na), the only option is for the new Data Direct solution. Supported fully in version 0.15 of MythTV, the 0.14 version of MythTV, for a short time, requires a fix to continue downloading listing information successfully.  More information is available in the [[Data Direct]].
+
Info on XMLTV is here: http://xmltv.org/wiki/.
  
 +
{{note_box|Not all grabbers on this page are XMLTV compliant. Only fully compliant grabbers are supported by MythTV and we advise against the use of the rest.
  
== Outside North America ==
+
If you know a grabber listed here does not conform entirely to both the xmltv grabber specifications ([http://wiki.xmltv.org/index.php/HowtoWriteAGrabber XMLTV grabber spec]) and XMLTV xml format ([http://wiki.xmltv.org/index.php/XMLTVFormat XMLTV Format]) then please mark it as unsupported. If in doubt XMLTV provide a script to validate a grabber ([http://wiki.xmltv.org/index.php/XmltvValidation XMLTV Validator])}}
If you live outside the USA and Canada, there are some other sources of guide information
 
  
=== Import Notes for all XMLTV users ===
 
  
 
{{Warning box|You should '''not''' include channels in your xmltv config which are not required. This places an unnecessarily high load on both the source websites and your own system.}}
 
{{Warning box|You should '''not''' include channels in your xmltv config which are not required. This places an unnecessarily high load on both the source websites and your own system.}}
 +
 +
== Worldwide ==
 +
=== EPG Collector ===
 +
[http://sourceforge.net/projects/epgcollector/ EPG Collector] is a .NET/Mono program for collecting the transmitted guide data from DVB or ATSC streams in various formats and creating an XMLTV file.
  
 
=== Australia ===
 
=== Australia ===
 
Refer to [[Australian TV Listings]] for further details.
 
Refer to [[Australian TV Listings]] for further details.
  
# http://www.icetv.com.au (AU$3 per week subscription)
+
# [http://www.oztivo.net/ OzTivo Guide] (Free, requires registration)
# http://immir.com/tv_grab_au (Free) (may be inactive/broken now)
+
# http://www.icetv.com.au (AU$99 per year subscription)
# http://www.tvguide.org.au (Free, requires registration)
+
# [http://svn.whuffy.com/wiki Shepherd] (Free: hybrid multi source)
# [http://www.cse.unsw.edu.au/~willu/xmltv/index.html Australian XMLTV grabbers] (ice + tvguide)
+
 
# http://www.onlinetractorparts.com.au/rohbags/xmltvau/ (not confirmed if working)
+
See also this (largely historical) [http://www.cse.unsw.edu.au/~willu/xmltv/index.html list of Australian grabbers].
  
 
=== Belgium ===
 
=== Belgium ===
  
# http://users.skynet.be/jxmltv (very fast, written in Java)
+
The following is a list of grabbers for Belgium. It is presented only for historical purposes, because at the time of writing this (January 2011) none of them work.
 +
 
 +
# https://launchpad.net/belguide
 +
# http://users.skynet.be/jxmltv  
 
# http://pytvgrab.sourceforge.net/
 
# http://pytvgrab.sourceforge.net/
# http://membled.com/work/apps/xmltv/
 
  
 
=== Brazil ===
 
=== Brazil ===
  
There are no working tv_grab perl scripts (or any other Linux native solutions) for Brazilian TV programming. A functional alternative is to use [http://www.tvxb.com TVxb], which isn't open source or even Linux, but works well with wine (at least as far as version 1.0085).   
+
There are a working grabber, tv_grab_br_net a perl scripts (or any other Linux native solutions) for Brazilian TV programming. This grabber get data from Net [http://www.net.tv.br] cable TV. No open to air TV on this source, just paid tv programme. It is detected by mythtvsetup and you are prompted (on background windows) to make your choice about your city, line-up and channels. It provide both, simple and complete description for programs.
 +
 
 +
Other functional alternative is to use [http://www.tvxb.com TVxb], which isn't open source or even Linux, but works well with wine (at least as far as version 1.0085).   
  
 
TVxb is configurable for different countries via ini-files.  Check the following page for Brazilian templates.  As of today, there are some for NET (PR), and others for TVA as well.
 
TVxb is configurable for different countries via ini-files.  Check the following page for Brazilian templates.  As of today, there are some for NET (PR), and others for TVA as well.
Line 43: Line 48:
  
 
For information on how to set it up with MythTV, check out [[TVxb]].
 
For information on how to set it up with MythTV, check out [[TVxb]].
 +
 +
=== Croatia ===
 +
The grabber in the official XMLTV distribution works correctly. More information is available on http://www.gonix.net/.
 +
 +
=== Czech Republic ===
 +
 +
The XMLTV grabber for "Hungary/Romania" was extended to the Czech Republic.
 +
 +
Another way to get TV listings in Czech Republic is [[TVxb]].
 +
 +
Not public XMLTV file for czech and slovak channels (UPC channels included) can be send after request to [mailto:rfordinal@gmail.com rfordinal].
  
 
=== Denmark ===
 
=== Denmark ===
Line 49: Line 65:
  
 
* A Wiki located at http://niels.dybdahl.dk/xmltvdk
 
* A Wiki located at http://niels.dybdahl.dk/xmltvdk
* A mailing list located at http://uk.groups.yahoo.com/group/xmltvdk  
+
* A mailing list located at http://uk.groups.yahoo.com/group/xmltvdk very 10 minutes. Only title and descr
 
* A sourceforge repository located at http://sourceforge.net/projects/xmltvdk
 
* A sourceforge repository located at http://sourceforge.net/projects/xmltvdk
 +
* Another source of info: http://xmltv.se
  
Currently seven grabbers are maintained:  
+
Currently three grabbers are maintained:
  
* The original (tv.tv2.dk),
+
* DR 2012 grabber written in perl (dr.dk)
* An additional written in perl (dr.dk)  
+
* An additional written in python (yousee.dk)  
* Five written in Python (tdc.dk, tv-guiden.dk, ahot.dk, jubii.dk, ontv.dk).
+
* An universal grabber combining data from mutiple sources (tvtid.tv2.dk, yousee.dk, tv-guiden.dk, jubii.dk, ontv.dk, ahot.dk, dr.dk and swedb)
  
The group also maintains the following:
+
=== Finland ===
 +
The grabbers in the official XMLTV distribution work correctly.
 +
Alternate source: http://xmltv.se
  
* A merger written in Python to combine xmltv information from multiple sources, to obtain the highest possible quality (merge end time of last show from tdc.dk with episode numbers from tv2.dk and long descriptions from tv-guiden.dk etc.).
+
=== France ===
* A "combined" grabber, which configures each of the other grabbers and runs them in parallel and then merge the output. That combined grabber does also support the swedish grabber (swedb).
 
  
The mailing list is used to inform users when there are updates or problems with the current grabbers.
+
The grabber in the upcoming XMLTV release works correctly. More information is available on [http://www.kazer.org/].
  
 
=== Germany/Austria ===
 
=== Germany/Austria ===
The XMLTV Data usefull in Austria/ Germany you get with tv_grab_de_tvtoday. It  has the episodes of series all mixed up in he main title. The part Number ('Teil')  of the series are not always nicely structured and spill over to the title and subtitle  field. This makes it quite impossible to  record every sequence of a series (if you do not want to make a time based recording on a single channel). I decided to write a small mySQL script to update the programm data after performing the daily load of the xmltv file. This mySQL statment is batched after the daily mythfilldatabase entry in my CRON Script. The Statment looks for sequences That have the Word 'Teil' in it. This is the German word for 'Part'.
+
# [http://wiki.xmltv.org/index.php/Europe epgData] offers data on a subscription basis, the grabber from the main xmltv distribution works.
 +
# [http://xmltv.se/ XMLTV.se] offers many of the main channels for personal use, the grabber from the main xmltv distribution works.
 +
# Some channels are available via [http://xmltv.spaetfruehstuecken.org/xmltv/ Egon Zappt] in the upcoming release of xmltv.
 +
# TV Movie can not give out their data without additional license, see [http://www.bucksch.org/1/projects/various/xmltv/ Ben Bucksch's log].
 +
 
 +
=== Greece ===
 +
 
 +
Try this link for Nova Greece: [http://sgcpm.com/epg/devilcosta.gz http://sgcpm.com/epg/devilcosta.gz], for example using mythfilldatabase. (Be aware that its just a dump of DVB-EIT using the service_id as channel_id which is not proper xmltv. Please consider writing a proper grabber for the file so it can be configured via the GUI or simply provide a proper guide feed with tools like [http://wiki.xmltv.org/index.php/NonameTV NonameTV].)
  
<pre><nowiki>UPDATE IGNORE program
+
=== India ===
    SET    chanid=chanid
+
The grabber for What's-On-India has been added to the official XMLTV distribution.
          ,starttime=starttime
 
          ,subtitle= concat_ws(' ', substring_index(substring(title,locate('Teil', title)-6,4+20), ' ', -2), subtitle )
 
          ,title= left(title,locate(substring_index(substring(title,locate('Teil', title)-6,4+20), ' ', -2),title) -1)
 
    WHERE title like '%Teil%';</nowiki></pre>
 
  
Ther is also another Grabber available for Germany: "Prisma". More info at http://www.mythwiki.de/index.php/HOWTO_Prisma_EPG. Download via http://sfr.mythwiki.de or http://hamsta.net/myth_epg.html. The Prisma grabber is slightly faster than the TV Today grabber and allows to fetch 4 weeks in advance compared to 1 week for the TV Today grabber.
+
An XMLTV grabber for all channels in India can be found at [http://ravihtpc.wordpress.com/2010/01/09/india-epg-data-for-mythtv-xmltv-listings-grabber/ http://ravihtpc.wordpress.com/2010/01/09/india-epg-data-for-mythtv-xmltv-listings-grabber/].
  
 
=== Italy ===
 
=== Italy ===
The grabber in the official xmltv distribution works correctly.
+
The grabber in the official XMLTV distribution works correctly.
 +
 
 +
=== Hong Kong ===
 +
First thanks to http://www.akbkhome.com/blog.php/View/119/Mythtv_xmltv_importer_for_HK.html.
  
=== Netherlands ===
+
I modify his source code to get information from TVB new web site.
Netherlands (Holland) specific info can be found here: http://www.mythtv.org/wiki/index.php/Netherlands
+
 
 +
    download Tv.php http://mythtv-xmltvhk.googlecode.com/files/Tv.php
 +
    download hongkong.ini http://mythtv-xmltvhk.googlecode.com/files/hongkong.ini
 +
    build xml from tvb, atv website using following command, just entry
 +
          php ./Tv.php hongkong.ini > hongkong.xml
 +
    using 'myfilldatabase' to update mythtv schedule program, just entry
 +
          mythfilldatabase --file 1 hongkong.xml
  
=== Norway ===
+
    (* it is my first development on php, so it may be simplified *)
 +
[Last Update by hwkit (17/04/2010)]
  
To use the XMLTV Data for Norway, you will have to use:
+
Since TVB web site is changed, the program need to be updated.  (My php skill is poor, so there are error when running, however it also can get schedule from TVB web site), I also change the program name called 'xmltvhk.php'. Please download it from google.
tv_grab_no --configure --config-file=tv_grab_no.xmltv
+
     
It will then ask you what channels you would like.
+
    download xmltvhk.php and copy it to /etc/xmltvhk (http://mythtv-xmltvhk.googlecode.com/files/xmltvhk.php)
Next copy the file to your ''.mythtv'' directory.
+
    download updated hongkong.ini and copy it to /etc/xmltvhk (http://mythtv-xmltvhk.googlecode.com/files/hongkong.ini)
 +
    download filltv  and copy it to /etc/cron.weekly (make it executable (chmod +x /etc/cron.weekly/filltv) (http://mythtv-xmltvhk.googlecode.com/files/filltv)
  
Next, you have to get the tags for each channel.. So let's fetch the data and save it to a tmp file.
+
    Source code
tv_grab_no --config-file=tv_grab_no.xmltv --list-channels --output=channels.tmp
+
    svn checkout http://mythtv-xmltvhk.googlecode.com/svn/trunk/ mythtv-xmltvhk-read-only
  
Open that file and write down each tag for each channel. Look for lines like:
+
[Last Update by hwkit (07/07/2010)]
<channel id="nrk1.nrk.no">
 
  
As you will see in the file: '''nrk1.nrk.no''' is for '''Nrk1'''.
+
=== Netherlands ===
 +
Netherlands (Holland) specific info can be found here: [[Netherlands]]
  
So now when you run mythtv-setup --> channel editor, in order to capture '''Nrk1''', you need to set the '''XMLTV ID''' to '''nrk1.nrk.no'''.
+
=== New Zealand ===
 +
Sky TV threatened legal action to get the [http://reven.co.nz/post/whatever-happened-to-xmltvnz xmltv grabber for NZ taken down].
 +
You can still receive the transmitted guide in MHEG5 with tools like [[XMLTV#EPG_Collector|EPG Collector]].
  
Do this for all the channels. When you are finally finished with doing all that, just run
+
=== Norway ===
mythfilldatabase
+
The grabber in the official XMLTV distribution works correctly.
 +
Another source of info: http://xmltv.se
  
When its finished, start up mythfrontend.
+
=== Slovakia ===
 +
The XMLTV grabber for "Hungary/Romania" was extended to Slovakia.
  
 
=== South Africa ===
 
=== South Africa ===
 
 
See the [[South Africa MUG]] WIKI page for details.
 
See the [[South Africa MUG]] WIKI page for details.
  
 
=== Spain ===
 
=== Spain ===
 
+
Both grabbers in the official XMLTV distribution work correctly.
The included parser works (www.elpais.es/parrillatv/index.html). Although it has been found some inconsistencies with the real programation.
 
 
 
One alternative, abeit not been as complete: http://www.miguiatv.com/todos-los-canales.html
 
  
 
=== Sweden ===
 
=== Sweden ===
 
+
The grabber in the official XMLTV distribution works correctly. More information is available on http://xmltv.se.
# http://tv.swedb.se/
 
  
 
=== Switzerland ===
 
=== Switzerland ===
 
+
The grabber in the official XMLTV distribution works correctly.
# [[XMLTV_CH]]: Info on available grabbers and icon listings.
 
  
 
=== United Kingdom ===
 
=== United Kingdom ===
 +
The grabbers in the official XMLTV distribution work correctly.
 +
A brief [[Uk_xmltv|guide to configuring tv_grab_uk_rt]] is available, and one for [[Atlas|Metabroadcast Atlas]].
  
# [[Uk_xmltv]]
+
=== Ukraine, Russia, Belarus ===
 +
# [http://www.free-x.de/xmltv/ tv_grab_ru] Converts JTV-formatted archive with about 200 channels to XMLTV. But this application does not show additional info about programmes.
 +
# [http://tipok.org.ua/downloads/media/mythtv/tv_grab_ua/tv_grab_ua tv_grab_ua] Downloads XMLTV-formatted data from sites like [http://www.teleguide.info/article1.html teleguide], [http://izbushka.kiev.ua/television/xmltv/ izbushka] or [http://www.star.poltava.ua/index.php?id=132 star.poltava.ua]. In addition it parses existing data and adds category/rating/credits into output XMLTV file.
 +
# [http://www.teleguide.info/download/new3/tvguide.zip teleguide.info] XMLTV-formatted zip archive with programmes inside.
  
A brief guide to configuring tv_grab_uk_rt is available at the link above.
+
=== Latvia ===
  
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]
 +
[[Category:EPG Providers]]
 +
[[Category:Post Installation Tasks|1300]]

Revision as of 15:25, 8 January 2016


Introduction

XMLTV is the name of a system which obtains and processes program guide information. If you are in North America you will use the Schedules Direct grabber which is built-in to MythTV. You do not need to install XMLTV (so you may skip this section). See instead Schedules Direct. All users in other countries need to install and configure XMLTV in order to obtain program guide listings.

Install the xmltv package on your master backend server, using your distribution's package manager. Alternatively you can get it from http://sourceforge.net/projects/xmltv/files/

Info on XMLTV is here: http://xmltv.org/wiki/.


Important.png Note: Not all grabbers on this page are XMLTV compliant. Only fully compliant grabbers are supported by MythTV and we advise against the use of the rest.

If you know a grabber listed here does not conform entirely to both the xmltv grabber specifications (XMLTV grabber spec) and XMLTV xml format (XMLTV Format) then please mark it as unsupported. If in doubt XMLTV provide a script to validate a grabber (XMLTV Validator)


Warning.png Warning: You should not include channels in your xmltv config which are not required. This places an unnecessarily high load on both the source websites and your own system.

Worldwide

EPG Collector

EPG Collector is a .NET/Mono program for collecting the transmitted guide data from DVB or ATSC streams in various formats and creating an XMLTV file.

Australia

Refer to Australian TV Listings for further details.

  1. OzTivo Guide (Free, requires registration)
  2. http://www.icetv.com.au (AU$99 per year subscription)
  3. Shepherd (Free: hybrid multi source)

See also this (largely historical) list of Australian grabbers.

Belgium

The following is a list of grabbers for Belgium. It is presented only for historical purposes, because at the time of writing this (January 2011) none of them work.

  1. https://launchpad.net/belguide
  2. http://users.skynet.be/jxmltv
  3. http://pytvgrab.sourceforge.net/

Brazil

There are a working grabber, tv_grab_br_net a perl scripts (or any other Linux native solutions) for Brazilian TV programming. This grabber get data from Net [1] cable TV. No open to air TV on this source, just paid tv programme. It is detected by mythtvsetup and you are prompted (on background windows) to make your choice about your city, line-up and channels. It provide both, simple and complete description for programs.

Other functional alternative is to use TVxb, which isn't open source or even Linux, but works well with wine (at least as far as version 1.0085).

TVxb is configurable for different countries via ini-files. Check the following page for Brazilian templates. As of today, there are some for NET (PR), and others for TVA as well.

http://www.tvxb.com/country/br-ini.html

For information on how to set it up with MythTV, check out TVxb.

Croatia

The grabber in the official XMLTV distribution works correctly. More information is available on http://www.gonix.net/.

Czech Republic

The XMLTV grabber for "Hungary/Romania" was extended to the Czech Republic.

Another way to get TV listings in Czech Republic is TVxb.

Not public XMLTV file for czech and slovak channels (UPC channels included) can be send after request to rfordinal.

Denmark

In Denmark there is a group maintaining several grabbers. This group has created the following:

Currently three grabbers are maintained:

  • DR 2012 grabber written in perl (dr.dk)
  • An additional written in python (yousee.dk)
  • An universal grabber combining data from mutiple sources (tvtid.tv2.dk, yousee.dk, tv-guiden.dk, jubii.dk, ontv.dk, ahot.dk, dr.dk and swedb)

Finland

The grabbers in the official XMLTV distribution work correctly. Alternate source: http://xmltv.se

France

The grabber in the upcoming XMLTV release works correctly. More information is available on [2].

Germany/Austria

  1. epgData offers data on a subscription basis, the grabber from the main xmltv distribution works.
  2. XMLTV.se offers many of the main channels for personal use, the grabber from the main xmltv distribution works.
  3. Some channels are available via Egon Zappt in the upcoming release of xmltv.
  4. TV Movie can not give out their data without additional license, see Ben Bucksch's log.

Greece

Try this link for Nova Greece: http://sgcpm.com/epg/devilcosta.gz, for example using mythfilldatabase. (Be aware that its just a dump of DVB-EIT using the service_id as channel_id which is not proper xmltv. Please consider writing a proper grabber for the file so it can be configured via the GUI or simply provide a proper guide feed with tools like NonameTV.)

India

The grabber for What's-On-India has been added to the official XMLTV distribution.

An XMLTV grabber for all channels in India can be found at http://ravihtpc.wordpress.com/2010/01/09/india-epg-data-for-mythtv-xmltv-listings-grabber/.

Italy

The grabber in the official XMLTV distribution works correctly.

Hong Kong

First thanks to http://www.akbkhome.com/blog.php/View/119/Mythtv_xmltv_importer_for_HK.html.

I modify his source code to get information from TVB new web site.

   download Tv.php http://mythtv-xmltvhk.googlecode.com/files/Tv.php
   download hongkong.ini http://mythtv-xmltvhk.googlecode.com/files/hongkong.ini
   build xml from tvb, atv website using following command, just entry 
          php ./Tv.php hongkong.ini > hongkong.xml
   using 'myfilldatabase' to update mythtv schedule program, just entry
          mythfilldatabase --file 1 hongkong.xml
   (* it is my first development on php, so it may be simplified *)

[Last Update by hwkit (17/04/2010)]

Since TVB web site is changed, the program need to be updated. (My php skill is poor, so there are error when running, however it also can get schedule from TVB web site), I also change the program name called 'xmltvhk.php'. Please download it from google.

   download xmltvhk.php and copy it to /etc/xmltvhk (http://mythtv-xmltvhk.googlecode.com/files/xmltvhk.php)
   download updated hongkong.ini and copy it to /etc/xmltvhk (http://mythtv-xmltvhk.googlecode.com/files/hongkong.ini)
   download filltv  and copy it to /etc/cron.weekly (make it executable (chmod +x /etc/cron.weekly/filltv) (http://mythtv-xmltvhk.googlecode.com/files/filltv)
   Source code 
   svn checkout http://mythtv-xmltvhk.googlecode.com/svn/trunk/ mythtv-xmltvhk-read-only

[Last Update by hwkit (07/07/2010)]

Netherlands

Netherlands (Holland) specific info can be found here: Netherlands

New Zealand

Sky TV threatened legal action to get the xmltv grabber for NZ taken down. You can still receive the transmitted guide in MHEG5 with tools like EPG Collector.

Norway

The grabber in the official XMLTV distribution works correctly. Another source of info: http://xmltv.se

Slovakia

The XMLTV grabber for "Hungary/Romania" was extended to Slovakia.

South Africa

See the South Africa MUG WIKI page for details.

Spain

Both grabbers in the official XMLTV distribution work correctly.

Sweden

The grabber in the official XMLTV distribution works correctly. More information is available on http://xmltv.se.

Switzerland

The grabber in the official XMLTV distribution works correctly.

United Kingdom

The grabbers in the official XMLTV distribution work correctly. A brief guide to configuring tv_grab_uk_rt is available, and one for Metabroadcast Atlas.

Ukraine, Russia, Belarus

  1. tv_grab_ru Converts JTV-formatted archive with about 200 channels to XMLTV. But this application does not show additional info about programmes.
  2. tv_grab_ua Downloads XMLTV-formatted data from sites like teleguide, izbushka or star.poltava.ua. In addition it parses existing data and adds category/rating/credits into output XMLTV file.
  3. teleguide.info XMLTV-formatted zip archive with programmes inside.

Latvia