Difference between revisions of "XMLTV"

From MythTV Official Wiki
Jump to: navigation, search
m (Belgium: Date correction)
(New Zealand: add reference to the transmitted guide in MHEG5)
(31 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
{{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.
 +
 +
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])}}
 +
 
The purpose of this page is to cover specific issues that aren't necessarily covered in the official documentation.   
 
The purpose of this page is to cover specific issues that aren't necessarily covered in the official documentation.   
  
Line 5: Line 9:
  
  
 +
 +
== Important 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.}}
 +
 +
== 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.
  
 
== Outside North America ==
 
== Outside North America ==
Line 10: Line 22:
  
 
If you live outside the USA and Canada, there are some other sources of guide information.
 
If you live outside the USA and Canada, there are some other sources of guide information.
 
=== Important 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.}}
 
  
 
=== Australia ===
 
=== Australia ===
 
Refer to [[Australian TV Listings]] for further details.
 
Refer to [[Australian TV Listings]] for further details.
  
# [http://minnie.tuhs.org/tivo-bin/tvguide.pl OzTivo Guide] (Free, requires registration)
+
# [http://www.oztivo.net/ OzTivo Guide] (Free, requires registration)
 
# http://www.icetv.com.au (AU$3 per week subscription)
 
# http://www.icetv.com.au (AU$3 per week subscription)
 
# [http://www.cse.unsw.edu.au/~willu/xmltv/index.html Australian XMLTV grabbers] (ice + tvguide)
 
# [http://www.cse.unsw.edu.au/~willu/xmltv/index.html Australian XMLTV grabbers] (ice + tvguide)
# [http://svn.whuffy.com/wiki Shepherd ] (Free : Ice,OzTivo hybrid multi source )
 
 
# http://immir.com/tv_grab_au (Free) (may be inactive/broken now)
 
# http://immir.com/tv_grab_au (Free) (may be inactive/broken now)
# http://www.onlinetractorparts.com.au/rohbags/xmltvau/ (not confirmed if working)
+
{{warning_box|Please note that Shepherd is completely unsupported by the MythTV project. It is not an XMLTV compliant grabber and operates directly on your database. It does not allow MythTV to schedule listings updates like supported grabbers. This will only change if you lobby the developers to change their stance.}}
 +
# [http://svn.whuffy.com/wiki Shepherd] (Free: Ice, OzTivo hybrid multi source )
  
 
=== Belgium ===
 
=== Belgium ===
Line 32: Line 40:
 
# http://users.skynet.be/jxmltv  
 
# http://users.skynet.be/jxmltv  
 
# http://pytvgrab.sourceforge.net/
 
# http://pytvgrab.sourceforge.net/
# http://membled.com/work/apps/xmltv/
 
  
 
=== Brazil ===
 
=== Brazil ===
Line 47: Line 54:
  
 
=== Croatia ===
 
=== Croatia ===
 +
The grabber in the official XMLTV distribution works correctly. More information is available on http://www.gonix.net/.
  
The grabber for Croatia tv_grab_hr is using the goNIX service as its backend.
+
=== Czech Republic ===
  
More information is available on http://www.gonix.net/
+
The XMLTV grabber for "Hungary/Romania" was extended to the Czech Republic.
  
 
+
Another way to get TV listings in Czech Republic is [[TVxb]].
=== Czech Republic ===
 
 
 
The only way to get TV listings in Czech Republic is [[TVxb]], there is no grabber for XMLTV.
 
  
 
Not public XMLTV file for czech and slovak channels (UPC channels included) can be send after request to [mailto:rfordinal@gmail.com rfordinal].
 
Not public XMLTV file for czech and slovak channels (UPC channels included) can be send after request to [mailto:rfordinal@gmail.com rfordinal].
Line 81: Line 86:
  
 
=== Finland ===
 
=== Finland ===
Finnish XMLTV data can be acquired with tv_grab_fi. The script parses www.telkku.com web site in order to get EPG entries.
+
The grabbers in the official XMLTV distribution work correctly.
 
 
Latest version of the tv_grab_fi can be downloaded from: <br>
 
http://xmltv.cvs.sourceforge.net/*checkout*/xmltv/xmltv/grab/fi/tv_grab_fi <br>
 
Due frequent site updates of the www.telkku.com user should always have the latest version of the grabber. <br>
 
Add latest version of tv_grab_fi somewhere where mythtv can find it for example in debian system to /usr/bin/. Also remember to assure that you don't have any older versions installed.
 
 
 
To use tv_grab_fi you need to first run in ~/.mythtv
 
tv_grab_fi --configure --config-file dvb.xmltv <br>
 
This will ask which channels does the user want to use grabber for. <br>
 
Once you have generated dvb.xmltv it should contain lines like this 'channel 0 YLE1'. Channels with '#' in front of them will not be added.
 
 
 
Now we need to tell XMLTV ID's to mythtv. In dvb.xmltv take the number after word "channel" and add ".telkku.com" after that and you'll have the ID. For example if the channel has line of 'channel 62 YLE24' the ID is 62.telkku.com. <br>
 
Start Mythtv setup <br>
 
mythtv-setup <br>
 
Go to: 'channel editor' -> "channel that you want to use grabber for" -> XMLTV ID: xx.telkku.com (Where 'xx' is the number in dvb.xmltv) -> Next -> Ready.
 
 
 
To update program guide do
 
mythfilldatabase
 
If that doesn't add EPG entries then do:
 
mythfilldatabase --refresh-all
 
 
 
Another way to get XMLTV ID's is to do
 
tv_grab_fi --config-file dvb.xmltv --days 0 --output channels.tmp
 
In channels.tmp find line that has '<channel id="...>' in it. In place of "..." you will have the XMLTV ID. For example if the line is: "<channel id="2.telkku.com">" then the XMLTV ID is 2.telkku.com.
 
  
 
=== France ===
 
=== France ===
  
This web site [http://www.kazer.org/] provides free and very complete XMLTV listings as a downloadable XML file. You will need to run mythfilldatabase with the --file argument to use the downloaded xml.
+
The grabber in the upcoming XMLTV release works correctly. More information is available on [http://www.kazer.org/].
  
 
=== Germany/Austria ===
 
=== Germany/Austria ===
====TV Movie====
+
# [http://wiki.xmltv.org/index.php/Europe epgData] offers data on a subscription basis, the grabber from the main xmltv distribution works.
The TV Movie paper has changed its EPG data publishment in January 2009, breaking the [http://mythtv.linux-dude.de old script].
+
# 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].
A script for the new format can be found [http://swolter.sdf1.org/software/article-tvmovie.html here].
 
This grabber is very fast (runs in a few seconds) and offers up to 8 days of program data for all
 
free-TV stations, including ratings, comments and actor lists.
 
 
 
====XMLTV.info====
 
You can download the TV program as XMLTV file from [http://xmltv.info xmltv.info]. There is also a fast grabber available to automatically fetch the file.
 
  
 
=== Greece ===
 
=== Greece ===
  
This web site [http://www.xmltv.eu/] provides free and very complete XMLTV listings as a downloadable XML file. You will need to run mythfilldatabase with the --file argument to use the downloaded xml.
+
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].)
  
 
=== India ===
 
=== 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/ http://ravihtpc.wordpress.com/2010/01/09/india-epg-data-for-mythtv-xmltv-listings-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/].
  
Line 162: Line 139:
  
 
=== New Zealand ===
 
=== New Zealand ===
A c# application to scrape sites can be found here, runs fine using mono on linux
+
Sky TV threatened legal action to get the [http://reven.co.nz/post/whatever-happened-to-xmltvnz xmltv grabber for NZ taken down].
# http://www.reven.co.nz/
+
You can still receive the transmitted guide in MHEG5 with tools like [[XMLTV#EPG_Collector|EPG Collector]].
  
 
=== Norway ===
 
=== Norway ===
 +
The grabber in the official XMLTV distribution works correctly.
  
To use the XMLTV Data for Norway, you will have to use:
+
=== Slovakia ===
tv_grab_no --configure --config-file=tv_grab_no.xmltv
+
The XMLTV grabber for "Hungary/Romania" was extended to Slovakia.
It will then ask you what channels you would like.
 
Next copy the file to your ''.mythtv'' directory.
 
 
 
Next, you have to get the tags for each channel.. So let's fetch the data and save it to a tmp file.
 
tv_grab_no --config-file=tv_grab_no.xmltv --list-channels --output=channels.tmp
 
 
 
Open that file and write down each tag for each channel. Look for lines like:
 
<channel id="nrk1.nrk.no">
 
 
 
As you will see in the file: '''nrk1.nrk.no''' is for '''Nrk1'''.
 
 
 
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'''.
 
 
 
Do this for all the channels. When you are finally finished with doing all that, just run
 
mythfilldatabase
 
 
 
When its finished, start up mythfrontend.
 
  
 
=== 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://tv.swedb.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.
 
# [http://xmltv.info xmltv.info] offers an XMLTV file for download which includes the TV programm for a number of Swiss channels.
 
  
 
=== United Kingdom ===
 
=== United Kingdom ===
 
+
The grabbers in the official XMLTV distribution work correctly.
# [[Uk_xmltv]]
+
A brief [[Uk_xmltv|guide to configuring tv_grab_uk_rt]] is available.
 
 
A brief guide to configuring tv_grab_uk_rt is available at the link above.
 
  
 
=== Ukraine, Russia, Belarus ===
 
=== Ukraine, Russia, Belarus ===
Line 218: Line 170:
  
 
=== Latvia ===
 
=== Latvia ===
 
http://lvtv.devlat.eu/xmltv.xml XMLTV-formatted EPG for channels received in Latvia. Updated every 10 minutes.
 
Contains LV national free-view EPG for current week (mon - sun), + other pay cable and SAT channels. Titles and descriptions only in original languages. No categories or other data.
 
 
Found on http://alvils.latvietis.com/index.cgi?action=5&id=168.
 
 
'''Free-view DVB-T channels''':
 
*LTV1
 
*LTV7
 
*TV3
 
*LNT
 
*TV5
 
 
'''Non-free-view channels''':
 
REN TV Baltic, TV6, TV3+, NTV Mir, 1. Baltijas kanals, RTR Planeta, TV1000 Krievu kino, TV Center International, RTVi, TV1000, Hallmark Channel,Eurosport, Cartoon Network, Discovery Channel, Extreme Sports Channel, VH1, ESPN Classic, MCM, PRO7, VIASAT Explorer, Discovery World, Dom Kino, NASN, Mezzo, Discovery Science, Boomerang,VIASAT Sport Baltic,Discovery Travel and Living, VIASAT History, Eurosport 2, TV1000 East, TV1000 Premium, TV1000 Action, BCC World, Playhouse Disney, Toon Disney, E!, Private Spice, Playboy, Travel
 
 
MythBuntu usage: (in sudo mythtv accounts "crontab -e" add 2 records to update EPG every hour) 
 
<pre>
 
0 * * * * wget --connect-timeout=30  -O /home/mythtv/lv_xmltv.xml -T 30 --no-cache --user-agent=Mozilla/4.0 "http://lvtv.devlat.eu/xmltv.xml"; mythfilldatabase --file 1 /home/mythtv/lv_xmltv.xml
 
</pre>
 
''Hint: don't forget configure proxy in wget, if you using one. Try both commands from shell first.''
 
  
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]
 
[[Category:EPG Providers]]
 
[[Category:EPG Providers]]

Revision as of 16:35, 19 March 2013

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)

The purpose of this page is to cover specific issues that aren't necessarily covered in the official documentation.

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


Important Notes for all XMLTV users

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

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.

Outside North America

Generally, XMLTV is used by people living outside of North America. North American users should instead see Schedules Direct.

If you live outside the USA and Canada, there are some other sources of guide information.

Australia

Refer to Australian TV Listings for further details.

  1. OzTivo Guide (Free, requires registration)
  2. http://www.icetv.com.au (AU$3 per week subscription)
  3. Australian XMLTV grabbers (ice + tvguide)
  4. http://immir.com/tv_grab_au (Free) (may be inactive/broken now)

Warning.png Warning: Please note that Shepherd is completely unsupported by the MythTV project. It is not an XMLTV compliant grabber and operates directly on your database. It does not allow MythTV to schedule listings updates like supported grabbers. This will only change if you lobby the developers to change their stance.

  1. Shepherd (Free: Ice, OzTivo hybrid multi source )

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 seven grabbers are maintained:

  • The original (tv.tv2.dk),
  • An additional written in perl (dr.dk)
  • Five written in Python (tdc.dk, tv-guiden.dk, ahot.dk, jubii.dk, ontv.dk).

The group also maintains the following:

  • 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.).
  • 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.

Finland

The grabbers in the official XMLTV distribution work correctly.

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. Some channels are available via Egon Zappt in the upcoming release of xmltv.
  3. 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.

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://tv.swedb.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.

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