https://wiki.xmltv.org/api.php?action=feedcontributions&user=Bilbo+uk&feedformat=atomXMLTV - User contributions [en]2024-03-29T08:50:12ZUser contributionsMediaWiki 1.26.4https://wiki.xmltv.org/index.php?title=XmltvValidation&diff=2100XmltvValidation2014-07-25T10:16:49Z<p>Bilbo uk: Add new section "Basic tests"</p>
<hr />
<div>==Validation==<br />
<br />
The xmltv distribution contains a number of tools that can help you validate that a grabber behaves the way it is expected to.<br />
===tv_validate_grabber===<br />
<br />
tv_validate_grabber tests one grabber to see that it supports the correct command-line parameters and that it produces the correct output. See ''perldoc tv_validate_grabber'' for instructions.<br />
===tv_validate_file===<br />
<br />
tv_validate_file checks an xmltv file against the xmltv dtd and the other rules defined in [[XMLTVFormat]]. See {{manpage|tv_validate_file|1}} for instructions.<br />
<br />
===Basic tests===<br />
<br />
To ensure consistency of results between grabbers each one must pass some basic tests. Before submitting a new grabber for inclusion in the distribution you should run the following series of tests and check for errors.<br />
<br />
'''1)'''<br /> <br />
Basic validation<br />
::<tt> tv_validate_grabber tv_grab_xx </tt><br />
<br />
'''2)'''<br /><br />
Grab 2 days starting from day 1<br />
::<tt> tv_grab_xx --config-file test.conf --offset 1 --days 2 > t_1.xml --quiet 2>t_1.log </tt><br />
<br />
Check that t_1.log is empty<br />
<br />
Sort the xml file<br />
::<tt> tv_sort --duplicate-error t_1.xml > t_1.sorted.xml </tt><br />
<br />
'''3)'''<br /><br />
Grab separate files for day 1 and day 2<br />
::<tt> tv_grab_xx --config-file test.conf --offset 1 --days 1 --output t_2.xml </tt><br />
::<tt> tv_grab_xx --config-file test.conf --offset 2 --days 1 > t_3.xml </tt><br />
<br />
Join them<br />
::<tt> tv_cat t_2.xml t_3.xml > t_2_3.xml </tt><br />
<br />
...and sort<br />
::<tt> tv_sort --duplicate-error t_2_3.xml > t_2_3.sorted.xml </tt><br />
<br />
There should be no difference between the combined two separate day files and the 2-day grab<br />
::<tt> diff t_1.sorted.xml t_2_3.sorted.xml </tt><br />
<br />
Validate the joined file<br />
::<tt> tv_validate_file t_2_3.sorted.xml </tt><br />
<br />
<br />
===test_grabbers===<br />
<br />
The test_grabbers script is used to test all grabbers in the distribution at once. It can be found under grab/ in the source distribution of xmltv. To run it, cd to an empty directory and run it from there. It will automatically test all grabbers found in subdirectories relative to itself. It uses test.conf-files found in the subdirectory for each grabber. These can be created with<br />
<br />
% ./grab/test_grabbers --configure --only xx<br />
<br />
The test_grabbers script is run every night and published on the web. See [[XmltvStatus]].</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=XMLTVProject&diff=2099XMLTVProject2014-07-25T09:49:45Z<p>Bilbo uk: /* Other stuff */ BBC Backstage service is closed down</p>
<hr />
<div>=XMLTV PROJECT=<br />
<br />
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.<br />
<br />
At present there are back-ends grabbing TV listings for the following countries<br />
[[Argentina]]<br />
[[Australia]]<br />
[[Belgium and Luxembourg]]<br />
[[Brazil]]<br />
[[Britain and Ireland]]<br />
[[Caribbean (Spanish)]]<br />
[[Chile]]<br />
[[Colombia]]<br />
[[NonameTV|Croatia]]<br />
[[Czech Republic]]<br />
[[Denmark]]<br />
[[Ecuador]]<br />
[[Estonia]]<br />
[[Europe]]<br />
[[Finland]]<br />
[[France]]<br />
[[Hungary and Romania]]<br />
[[Iceland]]<br />
[[Italy]]<br />
[[Netherlands]]<br />
[[North America]]<br />
[[NonameTV|Norway]]<br />
[[Peru]]<br />
[[Portugal]]<br />
[[Puerto Rico]]<br />
[[Reunion Island (France)]]<br />
[[Slovakia]]<br />
[[Slovenia]]<br />
[[South Africa]]<br />
[[Spain]]<br />
[[NonameTV|Sweden]]<br />
[[Switzerland]]<br />
[[Trinidad]]<br />
[[Turkey]]<br />
[[Uruguay]]<br />
[[Venezuela]]<br />
See [[XmltvWorldDomination]].<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Source code==<br />
<br />
see [[XMLTVProjectDownload]]<br />
<br />
==Packaged versions==<br />
<br />
see [[XMLTVProjectDownload]]<br />
<br />
==Windows executable notes==<br />
<br />
see [[XmltvWindowsExecutable]]<br />
<br />
==Mailing lists==<br />
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)<br />
{|<br />
|List<br />
|Purpose<br />
|Subscribe<br />
|Gmane<br />
|-<br />
|[mailto:xmltv-users@lists.sourceforge.net xmltv-users]<br />
|General user questions about XMLTV (not third-party software)<br />
|[http://lists.sourceforge.net/lists/listinfo/xmltv-users subscribe]<br />
|[http://news.gmane.org/gmane.comp.tv.xmltv.general gmane.comp.tv.xmltv.general]<br />
|-<br />
|[mailto:xmltv-devel@lists.sourceforge.net xmltv-devel]<br />
|Development discussion and patches<br />
|[http://lists.sourceforge.net/lists/listinfo/xmltv-devel subscribe]<br />
|[http://news.gmane.org/gmane.comp.tv.xmltv.devel gmane.comp.tv.xmltv.devel]<br />
|}<br />
<br />
==Sourceforge trackers==<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424135&status=1 Bugs] <br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424136&status=1 Support Requests]<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424137&status=1 Patches]<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424138&status=1 Feature Requests]<br />
<br />
==Being notified of new releases==<br />
<br />
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!<br />
==Information for Developers==<br />
Information is available on [[HowtoUseGrabbers]], [[HowtoWriteAGrabber]], and [[HowtoSubmitAGrabber]].<br />
<br />
<br />
==Feature Requests==<br />
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.<br />
<br />
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.<br />
<br />
==Other stuff==<br />
<br />
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.<br />
<br />
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.<br />
<br />
On March 14th 2002 Ed gave a on XMLTV.<br />
<br />
{{program|tv_check}} is an application distributed with XMLTV that generates a HTML report highlighting schedule changes and bonus episodes of your favorite shows.<br />
<br />
{{grabber|eu_epgdata}} is a new grabber that covers many European countries for a nominal cost<br />
<br />
[[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.<br />
<br />
{{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><br />
<br />
[[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].<br />
<br />
==Sourceforge==<br />
<br />
Please look at our Sourceforge project page. You can file bug reports there, or just send questions to the xmltv-users mailing list.<br />
==Authors and copying==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.)<br />
<br />
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<br />
<br />
There is no warranty for this software, see the file COPYING.</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=BBC_Backstage&diff=2098BBC Backstage2014-07-25T09:45:43Z<p>Bilbo uk: BBC Backstage service is closed down</p>
<hr />
<div><span style="color:Red;font-weight:bold;font-size:120%;">NOTE: The BBC Backstage service closed down in December 2010.</span> [http://en.wikipedia.org/wiki/Backstage.bbc.co.uk (link)]<br />
<br />
<br />
{{third-party tool}}<br />
I've put together a quick script that grabs data from the<br />
[http://backstage.bbc.co.uk/data/BbcWebApi?v=fcd listings service] available from [http://backstage.bbc.co.uk BBC Backstage]. <br />
<br />
= Download =<br />
It's available from [http://git.crustynet.org.uk/?p=xmltv.git;a=history;f=grab/uk_bbcbackstage/tv_grab_uk_bbcbackstage;hb=tv_grab_uk_bbcbackstage my git repository]. It's very rough-and-ready right now, but it basically works.<br />
<br />
= License =<br />
Like the rest of XMLTV, I've put my code under the GPL. The data is subject to the [http://backstage.bbc.co.uk/archives/2005/01/terms_of_use.html backstage API terms of use].<br />
<br />
= Developer notes =<br />
It uses the XML web service API, rather than the download. I originally started with the download, but I had problems with the archives not being update, which is when I switched to using the web service. The code for the web service is also simpler.<br />
<br />
[[User:ChrisB|ChrisB]] 09:47, 13 November 2008 (CET)</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=XMLTVProject&diff=2097XMLTVProject2014-07-25T09:32:43Z<p>Bilbo uk: /* XMLTV PROJECT */ Update the list of countries</p>
<hr />
<div>=XMLTV PROJECT=<br />
<br />
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.<br />
<br />
At present there are back-ends grabbing TV listings for the following countries<br />
[[Argentina]]<br />
[[Australia]]<br />
[[Belgium and Luxembourg]]<br />
[[Brazil]]<br />
[[Britain and Ireland]]<br />
[[Caribbean (Spanish)]]<br />
[[Chile]]<br />
[[Colombia]]<br />
[[NonameTV|Croatia]]<br />
[[Czech Republic]]<br />
[[Denmark]]<br />
[[Ecuador]]<br />
[[Estonia]]<br />
[[Europe]]<br />
[[Finland]]<br />
[[France]]<br />
[[Hungary and Romania]]<br />
[[Iceland]]<br />
[[Italy]]<br />
[[Netherlands]]<br />
[[North America]]<br />
[[NonameTV|Norway]]<br />
[[Peru]]<br />
[[Portugal]]<br />
[[Puerto Rico]]<br />
[[Reunion Island (France)]]<br />
[[Slovakia]]<br />
[[Slovenia]]<br />
[[South Africa]]<br />
[[Spain]]<br />
[[NonameTV|Sweden]]<br />
[[Switzerland]]<br />
[[Trinidad]]<br />
[[Turkey]]<br />
[[Uruguay]]<br />
[[Venezuela]]<br />
See [[XmltvWorldDomination]].<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Source code==<br />
<br />
see [[XMLTVProjectDownload]]<br />
<br />
==Packaged versions==<br />
<br />
see [[XMLTVProjectDownload]]<br />
<br />
==Windows executable notes==<br />
<br />
see [[XmltvWindowsExecutable]]<br />
<br />
==Mailing lists==<br />
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)<br />
{|<br />
|List<br />
|Purpose<br />
|Subscribe<br />
|Gmane<br />
|-<br />
|[mailto:xmltv-users@lists.sourceforge.net xmltv-users]<br />
|General user questions about XMLTV (not third-party software)<br />
|[http://lists.sourceforge.net/lists/listinfo/xmltv-users subscribe]<br />
|[http://news.gmane.org/gmane.comp.tv.xmltv.general gmane.comp.tv.xmltv.general]<br />
|-<br />
|[mailto:xmltv-devel@lists.sourceforge.net xmltv-devel]<br />
|Development discussion and patches<br />
|[http://lists.sourceforge.net/lists/listinfo/xmltv-devel subscribe]<br />
|[http://news.gmane.org/gmane.comp.tv.xmltv.devel gmane.comp.tv.xmltv.devel]<br />
|}<br />
<br />
==Sourceforge trackers==<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424135&status=1 Bugs] <br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424136&status=1 Support Requests]<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424137&status=1 Patches]<br />
* [http://sourceforge.net/tracker/?group_id=39046&atid=424138&status=1 Feature Requests]<br />
<br />
==Being notified of new releases==<br />
<br />
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!<br />
==Information for Developers==<br />
Information is available on [[HowtoUseGrabbers]], [[HowtoWriteAGrabber]], and [[HowtoSubmitAGrabber]].<br />
<br />
<br />
==Feature Requests==<br />
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.<br />
<br />
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.<br />
<br />
==Other stuff==<br />
<br />
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.<br />
<br />
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.<br />
<br />
On March 14th 2002 Ed gave a on XMLTV.<br />
<br />
{{program|tv_check}} is an application distributed with XMLTV that generates a HTML report highlighting schedule changes and bonus episodes of your favorite shows.<br />
<br />
{{grabber|eu_epgdata}} is a new grabber that covers many European countries for a nominal cost<br />
<br />
[[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.<br />
<br />
{{grabber|uk_bbcbackstage}} is a prototype grabber which downloads BBC TV and radio listings from [http://backstage.bbc.co.uk BBC Backstage].<br />
<br />
[[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].<br />
<br />
==Sourceforge==<br />
<br />
Please look at our Sourceforge project page. You can file bug reports there, or just send questions to the xmltv-users mailing list.<br />
==Authors and copying==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.)<br />
<br />
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<br />
<br />
There is no warranty for this software, see the file COPYING.</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=XMLTVWindowsBuild&diff=2094XMLTVWindowsBuild2014-06-15T07:45:27Z<p>Bilbo uk: For clarity</p>
<hr />
<div> ** IN PROGRESS ** <br />
<br />
Historically, one of the trickier tasks for XMLTV has been installing Perl and all the necessary modules for Windows. The situation has been made much better with the release of the Windows XMLTV distribution that includes a prepackaged PERLApp executable called XMLTV.EXE.<br />
<br />
There are times when folks would like to run native XMLTV or other Perl programs on Windows. This Page documents the process I followed to do it using Strawberry Perl. <br />
<br />
[http://strawberryperl.com/ Strawberry Perl] is a perl environment for MS Windows containing all you need to run and develop perl applications. It is designed to be as close as possible to perl environment on UNIX systems.<br />
<br />
Strawberry Perl is a Windows Perl distribution that includes a compiler (gcc) and other tools that allow you to install packages from CPAN just like you would on a Unix/Linux system.<br />
<br />
'''WARNING: I don't recommend using any directories with spaces or other special characters in them!'''<br />
<br />
'''IMPORTANT: Unlike Windows, Perl is case-sensitive: "makefile.pl" is NOT the same as "Makefile.PL"'''<br />
<br />
----<br />
1. Download/Install [http://strawberryperl.com/ Strawberry Perl] (I use c:\strawberry )<br />
<br />
2. Verify your Strawberry install by opening a windows command prompt (cmd.exe) and executing "perl -v". (You type "exit" to close the command prompt.)<br />
<br />
3. Drill down the [http://files.xmltv.org XMLTV Sourceforge Distribution site] and grab the latest non-Win32 XMLTV distribution (for example: xmltv-0.5.65.tar.bz2.<br />
<br />
4. Extract tar.bz2 source tree to a local directory (I use c:\xmltv) . I use [http://www.7-zip.org/ 7-Zip]. Note, you may have do it twice (first unzip to .tar, then to folder.<br />
<br />
5. Open a windows command prompt (cmd.exe) and CD to the local directory you specified above (e.g. c:\xmltv).<br />
<br />
6. Execute "perl Makefile.PL". Look for the XMLTV utility you would like to use. Is it already "yes" to include? If not, answer the questions and note the modules the Makefile.PL says you need to include.<br />
<br />
7. I installed the prerequisites with these commands. You only need to do the ones you need. ( I prefer ppm over CPAN )<br />
ppm install Date::Manip<br />
ppm install XML::DOM<br />
ppm install XML::Twig<br />
ppm install Tk<br />
ppm install Tk::TableMatrix<br />
cpan install HTTP::Cache::Transparent<br />
cpan install DateTime<br />
cpan install DateTime::Format::ISO8601<br />
cpan install XML::Writer<br />
<br />
8. Execute 'dmake clean' and then 'perl Makefile.PL' again... repeat step 6 until you're happy.<br />
<br />
9. Build XMLTV normally 'dmake'<br />
<br />
10. You can test XMTLV if you wish 'dmake test', but I fail 2/5 programs, 26/125 subtests<br />
<br />
11. Install to strawberry's bin folder with 'dmake install' (it will fail, but important stuff is there)<br />
<br />
12. *PROFIT* (for example, cd to another directory and type tv_grab_na_dd --configure )<br />
<br />
We should work on fixing the test and install parts of the Makefile for windows! :)</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=Britain_and_Ireland&diff=2086Britain and Ireland2014-03-15T12:15:54Z<p>Bilbo uk: add infoboxes for other 3 grabbers</p>
<hr />
<div>{{Infobox grabber<br />
| grabbername=uk_rt<br />
| maintainername=knowledgejunkie<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_bleb<br />
| maintainername=<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_atlas<br />
| maintainername=honir<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2014-03-14<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_tvguide<br />
| maintainername=honir<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2014-01-31<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_guardian<br />
| maintainername=honir<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2014-01-23<br />
}}<br />
There are five grabbers available for Britain and Ireland.<br />
<br />
==Notes on UK/ROI Radio Times listings==<br />
<br />
The tv_grab_uk_rt grabber processes machine-readable data from the radiotimes.com site. All data is the copyright of the Radio Times, and its use is subject to the following terms of use:<br />
<br />
"In accessing this XML feed, you agree that you will only access its contents for your own personal and non-commercial use and not for any commercial or other purposes, including advertising or selling any goods or services, including any third-party software applications available to the general public."<br />
<br />
<br />
On 12 Dec 2011, the Radio Times [http://www.radiotimes.com/blog/2011-12-12/changes-to-the-radio-times-xml-tv-service outsourced the data feed] to [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas MetaBroadcast] who now provide the service from their [http://atlas.metabroadcast.com/ Atlas installation]. The service continues as before except that film ratings and the Radio Times Choices are not available on the new platform.<br />
<br />
Subsequent to the transfer to MetaBroadcast no new channels will be added to the Radio Times feed except in exceptional circumstances (e.g. "4Seven").<br />
<br />
==Atlas==<br />
The Radio Times feed is now [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas provided by MetaBroadcast] from their [http://atlas.metabroadcast.com/ Atlas installation]. The Atlas software itself is available as open source, so you can extend it or host your own instance.<br />
You can get a free Atlas API key at http://atlas.metabroadcast.com/<br />
<br />
A new grabber (tv_grab_uk_atlas) uses this API to access the Atlas data directly, and has all UK channels. To use it you must first [http://metabroadcast.com/blog/create-and-manage-your-atlas-api-key get an Atlas API key].</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=Britain_and_Ireland&diff=2085Britain and Ireland2014-03-15T12:01:28Z<p>Bilbo uk: add Atlas grabber</p>
<hr />
<div>{{Infobox grabber<br />
| grabbername=uk_rt<br />
| maintainername=knowledgejunkie<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_bleb<br />
| maintainername=<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
There are two grabbers available for Britain and Ireland.<br />
<br />
==Notes on UK/ROI Radio Times listings==<br />
<br />
The tv_grab_uk_rt grabber processes machine-readable data from the radiotimes.com site. All data is the copyright of the Radio Times, and its use is subject to the following terms of use:<br />
<br />
"In accessing this XML feed, you agree that you will only access its contents for your own personal and non-commercial use and not for any commercial or other purposes, including advertising or selling any goods or services, including any third-party software applications available to the general public."<br />
<br />
<br />
On 12 Dec 2011, the Radio Times [http://www.radiotimes.com/blog/2011-12-12/changes-to-the-radio-times-xml-tv-service outsourced the data feed] to [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas MetaBroadcast] who now provide the service from their [http://atlas.metabroadcast.com/ Atlas installation]. The service continues as before except that film ratings and the Radio Times Choices are not available on the new platform.<br />
<br />
Subsequent to the transfer to MetaBroadcast no new channels will be added to the Radio Times feed except in exceptional circumstances (e.g. "4Seven").<br />
<br />
==Atlas==<br />
The Radio Times feed is now [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas provided by MetaBroadcast] from their [http://atlas.metabroadcast.com/ Atlas installation]. The Atlas software itself is available as open source, so you can extend it or host your own instance.<br />
You can get a free Atlas API key at http://atlas.metabroadcast.com/<br />
<br />
A new grabber (tv_grab_uk_atlas) uses this API to access the Atlas data directly, and has all UK channels. To use it you must first [http://metabroadcast.com/blog/create-and-manage-your-atlas-api-key get an Atlas API key].</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=Britain_and_Ireland&diff=2084Britain and Ireland2014-03-15T11:49:44Z<p>Bilbo uk: expand info about MetaBroadcast</p>
<hr />
<div>{{Infobox grabber<br />
| grabbername=uk_rt<br />
| maintainername=knowledgejunkie<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
{{Infobox grabber<br />
| grabbername=uk_bleb<br />
| maintainername=<br />
| countries=GB,IE<br />
| modusoperandi=grab<br />
| updated=2012-05-04<br />
}}<br />
There are two grabbers available for Britain and Ireland.<br />
<br />
==Notes on UK/ROI Radio Times listings==<br />
<br />
The tv_grab_uk_rt grabber processes machine-readable data from the radiotimes.com site. All data is the copyright of the Radio Times, and its use is subject to the following terms of use:<br />
<br />
"In accessing this XML feed, you agree that you will only access its contents for your own personal and non-commercial use and not for any commercial or other purposes, including advertising or selling any goods or services, including any third-party software applications available to the general public."<br />
<br />
<br />
On 12 Dec 2011, the Radio Times [http://www.radiotimes.com/blog/2011-12-12/changes-to-the-radio-times-xml-tv-service outsourced the data feed] to [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas MetaBroadcast] who now provide the service from their [http://atlas.metabroadcast.com/ Atlas installation]. The service continues as before except that film ratings and the Radio Times Choices are not available on the new platform.<br />
<br />
Subsequent to the transfer to MetaBroadcast no new channels will be added to the Radio Times feed except in exceptional circumstances (e.g. "4Seven").<br />
<br />
==Atlas==<br />
The Radio Times feed is now [http://metabroadcast.com/blog/providing-the-radiotimes-xmltv-feed-from-atlas provided by MetaBroadcast] from their [http://atlas.metabroadcast.com/ Atlas installation]. The Atlas software itself is available as open source, so you can extend it or host your own instance.<br />
You can get a free Atlas API key at http://atlas.metabroadcast.com/</div>Bilbo ukhttps://wiki.xmltv.org/index.php?title=XmltvCapabilities&diff=2082XmltvCapabilities2014-01-29T17:47:17Z<p>Bilbo uk: move --config-file to 'baseline' + minor clarifications</p>
<hr />
<div>=XMLTV Grabber Command-Line Parameters=<br />
<br />
This document describes the command-line interface to the xmltv grabbers. It contains the parameters that are common between many grabbers. Each grabber may support additional parameters apart from the ones listed below.<br />
<br />
All grabbers shall support a <code>--description</code> parameter. It shall print a description that identifies the grabber:<br />
<br />
Example:<br />
<br />
$ tv_grab_se_swedb --description<br />
Sweden (tv.swedb.se)<br />
$<br />
<br />
The command-line parameters are divided into a number of groups called capabilities. Each capability has a name and defines a set of parameters that all grabbers that claim to implement that particular capability must support.<br />
<br />
To list the capabilities that a grabber supports, call the grabber with a single parameter: <code>--capabilities</code>. The grabber shall then respond by printing a list of all the capabilities that it supports to stdout, one capability per line, and then exiting with an exit code of 0. It must be possible to run the grabber with the <code>--capabilities</code> parameter without any prior configuration.<br />
<br />
Example:<br />
<br />
$ tv_grab_se_swedb --capabilities<br />
baseline<br />
manualconfig<br />
apiconfig<br />
$<br />
<br />
Each section below describes which command-line parameters that capability includes.<br />
===baseline===<br />
<br />
If the grabber claims to implement the baseline capability, it must support the following command-line options when grabbing data:<br />
<br />
--quiet<br />
<br />
Suppress all progress information. When <code>--quiet</code> is used, the grabber shall only print error-messages to stderr.<br />
<br />
--output FILENAME<br />
<br />
Redirect the xmltv output to the specified file. Otherwise output goes to stdout. This option is mostly there for Windows where there can be strange difficulties redirecting stdout.<br />
<br />
--days X<br />
<br />
Supply data for X days. Each grabber may have an upper limit to the number of days that it can return data for. If X is larger than that limit, the grabber shall return no data for the days that it lacks data for, print a warning to stderr, and exit with an error-code. See [[XmltvErrorCodes]].<br />
<br />
In other words, if too many days are requested, the grabber will return data for as many days as it can.<br />
<br />
The default number of days is 'as many as possible'.<br />
<br />
--offset X<br />
<br />
Start with data for day today plus X days. The default is 0, today; 1 means start from tomorrow, etc.<br />
<br />
--config-file FILENAME<br />
<br />
The grabber shall read all configuration data from the specified file. <br />
<br />
<br />
A grabber that claims to support the baseline capability must also be able to download data without any command-line options apart from the ones listed above. All other information must be supplied in the configuration stage.<br />
<br />
Ideally, default values should be provided within the grabber so it can be run without any command-line options at all.<br />
<br />
The grabber must output data that adheres to the [[XmltvFormat]] with the following additional requirements:<br />
<br />
* All start- and stoptimes must include a timeoffset (e.g. +0100). Timezones (e.g. EST) are not permitted.<br />
* The data must contain exactly one <channel> entry for each channel mentioned in the file.<br />
* The data must not contain <channel> entries for channels that are not included in the data.<br />
* All xmltvids must match the regexp <code>/^[-a-zA-Z0-9]+(\.[-a-zA-Z0-9]+)+$/</code>.<br />
* If the grabber is first run with <code>--offset 1 --days 1</code> and then with <code>--offset 2 --days 1</code>, then the two datasets returned must not overlap in time. By concatenating the two datasets, the result shall be identical to the output provided by <code>--offset 1 --days 2</code>.<br /> In practice this means the first programme output should be that which ''starts'' within the requested date range (i.e. not one which started yesterday).<br />
* Days should run from midnight to midnight - some data sources run from 06:00 - 06:00 so will need some adjustment.<br />
<br />
===manualconfig===<br />
<br />
The manualconfig capability means that the grabber implements a configuration procedure where it asks the user a set of questions using the XMLTV::Ask library. This library currently has two implementations: one to prompt on the terminal and one to ask graphically with a Perl/Tk interface.<br />
<br />
--configure<br />
<br />
Allow the user to answer questions regarding the operation of the grabber. This can include usernames, passwords and lineup and it should also include a way for the user to specify which channels he wants to download data for.<br />
<br />
If this parameter is combined with --config-file, the configuration is written to the specified file.<br />
<br />
?EdAvis: Personally, as I've mentioned on the list, I'm not that happy with including passwords <br />as part of configuration. But I don't want to fight a holy war about this right now. I suppose we <br />can have passwords in the config file for grabbers that need them - though no grabber should require it.<br />
<br />
===apiconfig===<br />
<br />
The grabber shall support the following parameters to allow for automated configuration:<br />
<br />
--configure-api<br />
<br />
Return an xml-document compliant with the [[XmltvConfigurationDtd]]. The document describes any questions that the user must answer to configure the grabber.<br />
<br />
--stage STAGENAME<br />
<br />
Specify which stage of the configuration shall be run.<br />
<br />
--list-channels<br />
<br />
See [[XmltvConfigurationApi]] for a more detailed explanation and examples.<br />
<br />
===share===<br />
<br />
The grabber supports the following command-line option:<br />
<br />
--share sharedir<br />
<br />
sharedir specifies the location of the metadata for the grabber. For a properly installed grabber, this parameter should not be necessary to use.<br />
===cache===<br />
<br />
The grabber can cache the response to HTTP-requests in a file and reuse them without contacting the server again. This is useful if the grabber is run multiple times or when doing tests. Note that some grabbers may return the wrong result if a cachefile from a previous day is specified.<br />
<br />
--cache cachefile<br />
<br />
Store the cache in cachefile.<br />
===preferredmethod===<br />
<br />
The grabber can tell the application how it prefers to be called in order to download data as efficiently as possible.<br />
<br />
If the grabber does not support the preferredmethod capability, the calling application shall assume that the consumed bandwidth is proportional to the number of days of data that is requested. It is therefore more efficient to download data for only the days that the application wants data.<br />
<br />
--preferredmethod<br />
<br />
Prints a single word to stdout (?) that tells the calling application that the grabber prefers to be used in a specific way. By calling the grabber in this way, the calling application can make sure that the grabber uses as little bandwidth as possible.<br />
<br />
Available responses:<br />
<br />
allatonce<br />
<br />
The grabber downloads data in a single chunk and filters out the requested days. This means that it is more efficient to call this grabber once with a long period instead of several times with short periods. For example: If the application needs data for day 1 and 5, it should call the grabber with<br />
<br />
tv_grab_xx --offset 1 --days 5<br />
<br />
instead of<br />
<br />
tv_grab_xx --offset 1 --days 1<br />
<br />
tv_grab_xx --offset 5 --days 1<br />
<br />
Additional responses may be defined in the future. If the application does not understand the response, it shall act as if the grabber did not support the preferredmethod capability.<br />
==Proposed Capabilities==<br />
<br />
This section describes a number of capabilities that have been discussed on the xmltv mailing list, but that no grabber has implemented yet and the details may change.<br />
===newchannels===<br />
<br />
The newchannels capability means that the grabber can notify a PVR application if it can supply data for channels that weren't available when the grabber was last configured. The behaviour of this mechanism can be controlled with the following command-line parameter:<br />
<br />
--channel-updates add|ignore|notify<br />
<br />
"add" means that the grabber shall automatically supply data for all new channels without informing the PVR application.<br />
<br />
"ignore" means that the grabber shall ignore any new channels until the grabber is reconfigured.<br />
<br />
"notify" means that the grabber shall tell the PVR application that there are new channels available by exiting with a special error-code after outputting the data for all the configured channels. See [[XmltvErrorCodes]].<br />
<br />
The default value for <code>--channel-updates</code> is "ignore". This is also the behaviour implemented by all grabbers that don't implement the newchannels capability.<br />
<br />
I wonder if it makes sense to include this information in the output XML. For example when a new channel appears just start writing channel elements for it in the output XML though not necessarily programmes. Need to think about this some more.<br />
<br />
===channelnumberremapping===<br />
<br />
The grabber can change the channel number associated with each channel. This is described in XmltvConfigurationFile.<br />
===lineups===<br />
<br />
See [[LineupProposal]], [[LineupProposal2]], [[NoLineupProposal]].</div>Bilbo uk