XMLTVProject

From XMLTV
(Difference between revisions)
Jump to: navigation, search
(Source code: move to XMLTVProjectDownload section)
(Mailing lists)
 
(33 intermediate revisions by 11 users not shown)
Line 4: Line 4:
  
 
At present there are back-ends grabbing TV listings for the following countries
 
At present there are back-ends grabbing TV listings for the following countries
 +
[[Argentina]]
 
  [[Australia]]
 
  [[Australia]]
 
  [[Belgium and Luxembourg]]
 
  [[Belgium and Luxembourg]]
 
  [[Brazil]]
 
  [[Brazil]]
[[Argentina]]
 
 
  [[Britain and Ireland]]
 
  [[Britain and Ireland]]
  [http://www.gonix.net/ Croatia]
+
  [[Caribbean (Spanish)]]
 +
[[Chile]]
 +
[[Colombia]]
 +
[[NonameTV|Croatia]]
 +
[[Czech Republic]]
 
  [[Denmark]]
 
  [[Denmark]]
 +
[[Ecuador]]
 
  [[Estonia]]
 
  [[Estonia]]
 
  [[Europe]]
 
  [[Europe]]
 
  [[Finland]]
 
  [[Finland]]
  [http://www.lahiette.com/biboobox/ France]
+
  [[France]]
 
  [[Hungary and Romania]]
 
  [[Hungary and Romania]]
 
  [[Iceland]]
 
  [[Iceland]]
 
  [[Italy]]
 
  [[Italy]]
[[Japan]]
 
 
  [[Netherlands]]
 
  [[Netherlands]]
 
  [[North America]]
 
  [[North America]]
  [http://www.mspc.no/gf/ Norway]
+
  [[NonameTV|Norway]]
 +
[[Peru]]
 
  [[Portugal]]
 
  [[Portugal]]
 +
[[Puerto Rico]]
 
  [[Reunion Island (France)]]
 
  [[Reunion Island (France)]]
 +
[[Slovakia]]
 +
[[Slovenia]]
 
  [[South Africa]]
 
  [[South Africa]]
 
  [[Spain]]
 
  [[Spain]]
  [http://tv.swedb.se/ Sweden]
+
  [[NonameTV|Sweden]]
 
  [[Switzerland]]
 
  [[Switzerland]]
 +
[[Trinidad]]
 +
[[Turkey]]
 +
[[Uruguay]]
 +
[[Venezuela]]
 
See [[XmltvWorldDomination]].
 
See [[XmltvWorldDomination]].
  
Line 40: Line 52:
 
==Packaged versions==
 
==Packaged versions==
  
These packaged versions for various operating systems may not necessarily be up to date with the latest xmltv source release. However they are usually built within a week or so.
+
see [[XMLTVProjectDownload]]
  
For most Windows users, who may not wish to install perl and the necessary libraries, there is a 'binary' release created by Robert Eden. This combines all the different xmltv programs into a single wrapper xmltv.exe. It is released as part of the XMLTV project, so get it from Sourceforge as above. See [[XmltvWindowsExecutable]].
+
==Windows notes==
  
For Mac OS X there is an xmltv package as part of the Fink project, maintained by Justin Hallett. Latest version appears to be 0.5.31.
+
Information on XMLTV (Windows Distribution ) [[XmltvWindowsExecutable]]
  
For various Red Hat/Fedora Linux versions Axel Thimm has made some [http://atrpms.net/ RPM packages] for xmltv. They are may also work on Mandriva Linux.
+
Information on running the source code XMLTV distribution using Strawberry Perl [[XMLTVWindowsBuild]]
  
Debian GNU/Linux's xmltv source package produced by Chris Butler generates four binary packages: libxmltv-perl, xmltv, xmltv-gui and xmltv-util.
+
Information on building XMLTV.EXE  see [[XMLTVexeBuild]]
 
+
For Gentoo, the list of available versions can be found at [http://packages.gentoo.org packages.gentoo.org]
+
  
 
==Mailing lists==
 
==Mailing lists==
Posting to the lists are restricted to list members only. For quick response, be sure and sign up before posting using the email address you will post from. (you can disable emails if you read via gmane)
+
Posting to these lists is restricted to list members. For quick response, be sure and sign up before posting using the email address you will post from. (you can disable emails if you read via Gmane)
 
{|
 
{|
 
|List
 
|List
 
|Purpose
 
|Purpose
 
|Subscribe
 
|Subscribe
|Gmane
+
|SF Archive
|-
+
|Gmane (dead. may come back)
|[mailto:xmltv-announce@lists.sourceforge.net xmltv-announce]
+
|Low-traffic announcement of new releases
+
|[http://lists.sourceforge.net/lists/listinfo/xmltv-announce subscribe]
+
|[http://news.gmane.org/gmane.comp.tv.xmltv.announce gmane.comp.tv.xmltv.announce]
+
 
|-
 
|-
 
|[mailto:xmltv-users@lists.sourceforge.net xmltv-users]
 
|[mailto:xmltv-users@lists.sourceforge.net xmltv-users]
|General user questions about xmltv (not third-party software)
+
|General user questions about XMLTV (not third-party software)
 
|[http://lists.sourceforge.net/lists/listinfo/xmltv-users subscribe]
 
|[http://lists.sourceforge.net/lists/listinfo/xmltv-users subscribe]
 +
|[https://sourceforge.net/p/xmltv/mailman/xmltv-users/ SF archive]
 
|[http://news.gmane.org/gmane.comp.tv.xmltv.general gmane.comp.tv.xmltv.general]
 
|[http://news.gmane.org/gmane.comp.tv.xmltv.general gmane.comp.tv.xmltv.general]
 
|-
 
|-
Line 73: Line 80:
 
|Development discussion and patches
 
|Development discussion and patches
 
|[http://lists.sourceforge.net/lists/listinfo/xmltv-devel subscribe]
 
|[http://lists.sourceforge.net/lists/listinfo/xmltv-devel subscribe]
 +
|[https://sourceforge.net/p/xmltv/mailman/xmltv-devel/ SF archive]
 
|[http://news.gmane.org/gmane.comp.tv.xmltv.devel gmane.comp.tv.xmltv.devel]
 
|[http://news.gmane.org/gmane.comp.tv.xmltv.devel gmane.comp.tv.xmltv.devel]
|-
 
|[mailto:xmltv-commit@lists.sourceforge.net xmltv-commit]
 
|CVS commit logs
 
|[http://lists.sourceforge.net/lists/listinfo/xmltv-commit subscribe]
 
|[http://news.gmane.org/gmane.comp.tv.xmltv.cvs gmane.comp.tv.xmltv.cvs]
 
 
|}
 
|}
  
 
==Sourceforge trackers==
 
==Sourceforge trackers==
* [http://sourceforge.net/tracker/?group_id=39046&atid=424135 Bugs]     
+
* [http://sourceforge.net/tracker/?group_id=39046&atid=424135&status=1 Bugs]     
* [http://sourceforge.net/tracker/?group_id=39046&atid=424136 Support Requests]
+
* [http://sourceforge.net/tracker/?group_id=39046&atid=424136&status=1 Support Requests]
* [http://sourceforge.net/tracker/?group_id=39046&atid=424137 Patches]
+
* [http://sourceforge.net/tracker/?group_id=39046&atid=424137&status=1 Patches]
* [http://sourceforge.net/tracker/?group_id=39046&atid=424138 Feature Requests]
+
* [http://sourceforge.net/tracker/?group_id=39046&atid=424138&status=1 Feature Requests]
  
 
==Being notified of new releases==
 
==Being notified of new releases==
Line 91: Line 94:
 
If you do download a copy, please subscribe to the xmltv-announce mailing list so you can find out when new releases happen. Since websites change their format without warning, a new release might be needed at any time!
 
If you do download a copy, please subscribe to the xmltv-announce mailing list so you can find out when new releases happen. Since websites change their format without warning, a new release might be needed at any time!
 
==Information for Developers==
 
==Information for Developers==
Information is available on [[HowtoUseGrabbers]], [[HowtoWriteAGrabber]], and [[HowtoSubmitAGrabber]].
+
Information is available on [[HowtoUseGrabbers]], [[HowtoWriteAGrabber]], [[HowtoSubmitAGrabber]], and [[HowToMakeARelease]].
  
==Notes on UK/ROI Radio Times listings==
+
==Feature Requests==
 +
The XMLTVProject is a quintessential Open Source project.  Most developers had an "itch to scratch", wrote some code satisfy the itch, and released it to others via this project.  You can request a feature, but it's very likely the tool already does what the developer wanted, so it may take a while (if ever) for that feature to be added.  Of course, this is OSS software, so feel free to add the feature  yourself (or commission its addition if you can't code) and submit a patch.  Most developers would gladly add a feature if someone else has already done most of the work.
 +
 
 +
Similar rules go for changes to the XMLTV DTD.  You may have to push a bit for your changes and keep the discussion moving.  Don't hesitate to push discussions forward that seem to have stagnated.  If people aren't complaining about it, there may simply be no objections.  Follow up with something like "There doesn't appear to be serious objections, so here's proposed patches to the DTD (and maybe XMLTV.PM)".  If nothing happens after that, ping again.... the change is your "itch to scratch" :)  I don't recommend non-core developers update the DTD or XMLTV.PM directly.
  
The tvgrabuk_rt grabber gets machine-readable data from the radiotimes.com site. They would like me to point out that all data is the copyright of the Radio Times website and the use of this data is restricted to personal use only.
 
 
==Other stuff==
 
==Other stuff==
  
RFC 2838 suggests a way of storing channel names based on the existing DNS hierarchy (though the channel names are not Internet hostnames). XMLTV has adopted this idea as a way to store globally-unique channel names, though at present not all the listings-grabbers use it. We have the channels.xml file (whose format is described by channels.dtd) to map between internal channel IDs and human-readable names.
+
RFC 2838 suggests a way of storing channel names based on the existing DNS hierarchy (though the channel names are not Internet hostnames). XMLTV has adopted this idea as a way to store globally-unique channel names, though at present not all the listings-grabbers use it.
  
 
An interesting side effect of keeping a preferences file listing programme titles is that you can crunch through the file later to see what words in titles you like and don't like, and what words occur most frequently in TV show titles. See A totally unscientific analysis of words appearing in British TV programme titles.
 
An interesting side effect of keeping a preferences file listing programme titles is that you can crunch through the file later to see what words in titles you like and don't like, and what words occur most frequently in TV show titles. See A totally unscientific analysis of words appearing in British TV programme titles.
Line 104: Line 109:
 
On March 14th 2002 Ed gave a on XMLTV.
 
On March 14th 2002 Ed gave a on XMLTV.
  
[[TV CHECK]] is an application distributed with XMLTV that generates a HTML report highlighting schedule changes and bonus episodes of your favorite shows.
+
{{program|tv_check}} is an application distributed with XMLTV that generates a HTML report highlighting schedule changes and bonus episodes of your favorite shows.
 +
 
 +
{{grabber|eu_epgdata}} is a new grabber that covers many European countries for a nominal cost
 +
 
 +
[[XmltvGrabberChannels]] is some work in progress to organize which channels are best fetched by which grabbers. If you use one of the xmltv grabbers, feel free to update it.
  
[[EU_epgdata|tv_grab_eu_epgdata]] is a new grabber that covers many European countries for a nominal cost
+
{{grabber|uk_bbcbackstage}} is a prototype grabber which downloads BBC TV and radio listings from [http://backstage.bbc.co.uk BBC Backstage]. <span style="color:Red;">(NOTE: The BBC Backstage service closed down in December 2010.)</span>
  
?XmltvGrabberChannels is some work in progress to organize which channels are best fetched by which grabbers. If you use one of the xmltv grabbers, feel free to update it.
+
[[autoEpg]] is an application for easier configuration and automatic download of XMLTV data, also integrates other grabbers, TVxb, epgstream.net.. translation of the data from various languages, spain, french... to another language example, english, macedonian... and finally import to Windows Media Center (I've lost the source code so now I'm starting all over, you can track the progress [https://sourceforge.net/projects/autoepg/files/ hier].
  
 
==Sourceforge==
 
==Sourceforge==

Latest revision as of 00:40, 16 October 2017

Contents

XMLTV PROJECT

The XMLTV Project is a set of (mostly Perl) utilities to manage your TV viewing. They work with TV listings stored in the XMLTVFormat, which is based on XML. The idea is to separate out the back-end (getting the listings) from the front-end (displaying them for the user), and to implement useful operations like picking out your favorite programmes as filters that read and write XML documents.

At present there are back-ends grabbing TV listings for the following countries

Argentina
Australia
Belgium and Luxembourg
Brazil
Britain and Ireland
Caribbean (Spanish)
Chile
Colombia
Croatia
Czech Republic
Denmark
Ecuador
Estonia
Europe
Finland
France
Hungary and Romania
Iceland
Italy
Netherlands
North America
Norway
Peru
Portugal
Puerto Rico
Reunion Island (France)
Slovakia
Slovenia
South Africa
Spain
Sweden
Switzerland
Trinidad
Turkey
Uruguay
Venezuela

See XmltvWorldDomination.

There are filters to sort the listings by date, to remove shows that have already been broadcast, and a couple of programmes to organize your viewing by storing preferences of what shows you watch. There are a couple of back ends to produce printed output.

This software is still being developed and most of the tools are command-line based, but at least many of them have manual pages. See the XmltvStatus page for information about which grabbers currently work correctly.

Source code

see XMLTVProjectDownload

Packaged versions

see XMLTVProjectDownload

Windows notes

Information on XMLTV (Windows Distribution ) XmltvWindowsExecutable

Information on running the source code XMLTV distribution using Strawberry Perl XMLTVWindowsBuild

Information on building XMLTV.EXE see XMLTVexeBuild

Mailing lists

Posting to these lists is restricted to list members. For quick response, be sure and sign up before posting using the email address you will post from. (you can disable emails if you read via Gmane)

List Purpose Subscribe SF Archive Gmane (dead. may come back)
xmltv-users General user questions about XMLTV (not third-party software) subscribe SF archive gmane.comp.tv.xmltv.general
xmltv-devel Development discussion and patches subscribe SF archive gmane.comp.tv.xmltv.devel

Sourceforge trackers

Being notified of new releases

If you do download a copy, please subscribe to the xmltv-announce mailing list so you can find out when new releases happen. Since websites change their format without warning, a new release might be needed at any time!

Information for Developers

Information is available on HowtoUseGrabbers, HowtoWriteAGrabber, HowtoSubmitAGrabber, and HowToMakeARelease.

Feature Requests

The XMLTVProject is a quintessential Open Source project. Most developers had an "itch to scratch", wrote some code satisfy the itch, and released it to others via this project. You can request a feature, but it's very likely the tool already does what the developer wanted, so it may take a while (if ever) for that feature to be added. Of course, this is OSS software, so feel free to add the feature yourself (or commission its addition if you can't code) and submit a patch. Most developers would gladly add a feature if someone else has already done most of the work.

Similar rules go for changes to the XMLTV DTD. You may have to push a bit for your changes and keep the discussion moving. Don't hesitate to push discussions forward that seem to have stagnated. If people aren't complaining about it, there may simply be no objections. Follow up with something like "There doesn't appear to be serious objections, so here's proposed patches to the DTD (and maybe XMLTV.PM)". If nothing happens after that, ping again.... the change is your "itch to scratch" :) I don't recommend non-core developers update the DTD or XMLTV.PM directly.

Other stuff

RFC 2838 suggests a way of storing channel names based on the existing DNS hierarchy (though the channel names are not Internet hostnames). XMLTV has adopted this idea as a way to store globally-unique channel names, though at present not all the listings-grabbers use it.

An interesting side effect of keeping a preferences file listing programme titles is that you can crunch through the file later to see what words in titles you like and don't like, and what words occur most frequently in TV show titles. See A totally unscientific analysis of words appearing in British TV programme titles.

On March 14th 2002 Ed gave a on XMLTV.

tv_check is an application distributed with XMLTV that generates a HTML report highlighting schedule changes and bonus episodes of your favorite shows.

tv_grab_eu_epgdata is a new grabber that covers many European countries for a nominal cost

XmltvGrabberChannels is some work in progress to organize which channels are best fetched by which grabbers. If you use one of the xmltv grabbers, feel free to update it.

tv_grab_uk_bbcbackstage is a prototype grabber which downloads BBC TV and radio listings from BBC Backstage. (NOTE: The BBC Backstage service closed down in December 2010.)

autoEpg is an application for easier configuration and automatic download of XMLTV data, also integrates other grabbers, TVxb, epgstream.net.. translation of the data from various languages, spain, french... to another language example, english, macedonian... and finally import to Windows Media Center (I've lost the source code so now I'm starting all over, you can track the progress hier.

Sourceforge

Please look at our Sourceforge project page. You can file bug reports there, or just send questions to the xmltv-users mailing list.

Authors and copying

The maintainer of the xmltv project is currently Robert Eden. To get in contact use one of the mailing lists mentioned above. The project code (particularly the different grabbers) was written by many people. The manual page of each program should list its authors.

If you have a question about a grabber for a particular country, it is probably best to contact the grabber's author. And then you can write in your own language instead of English. But feel free to cc the xmltv-users mailing list anyway.

These programs are free software; you may distribute them under the GNU General Public License as published by the Free Software Foundation, either version 2 or (at your option) any later version. (See the file COPYING.)

But I do not place any restrictions on files conforming to the DTD or on programs reading and writing the XMLTV format (even if the law gave me the power to do so). You are free to use the XMLTV file format (or variants of it) for any purpose. The DTD itself is copyrighted and GPLed (it's arguably a literary work), but that does not imply that I have any copyright interest in files you create by following its instructions. -- ?EdAvis

There is no warranty for this software, see the file COPYING.

Personal tools