XMLTV - New pages [en]

XMLTVGrabbers

2026-04-10T14:41:43Z

Rmeden: /* First use example */

== Using XMLTV grabbers ==

The [[XMLTVProject]] includes two major classes of tools.
* Grabbers -- These tools obtain data in XMLTV format.
* Filters -- These tools modify data in XMLTV format

In this post, we're going to focus on the Grabbers.

== NOTE FOR WINDOWS USERS ==

The xmltv tools are command line tools. Of course you can put them in batch files too (and most folks do!). For now, open a '''COMMAND PROMPT''' and get started!

A pre-compiled perl distribution is included in an XMLTV.EXE file. This includes most grabbers and filters! To use it simply download the release file from the [https://github.com/XMLTV/xmltv/releases XMLTV releases] or the [http://alpha-exe.xmltv.org ALPHA EXE]. Save the file in a directory (safer one without spaces... say c:\xmltv) then use it!

To use xmltv.exe simply prefix the xmltv tool with xmltv.exe (or just xmltv).
for example:
cd \xmltv
xmltv tv_grab_na_dd --configure

WARNING: The first time you run xmltv.exe it will take a long time, this is normal.

== CONFIGURING A GRABBER ==

The Grabbers are very consistent in how to use them. That said, a few are different (tv_grab_zz_sdjson_sqlite comes to mind), so read the messages, just don't hit enter! The Grabbers tend to provide useful defaults for most questions.

The first step is the '''CONFIGURE''' step.
''grabber'' --configure
Then answer the questions! yes, it's that easy. You only need to do this once, or when things change. no need to put it in your grabber script.

Once that's done and you're ready to go!

== GRABBING LISTINGS ==
This is even easier, as everything is already configured! The below command will output 7 days to tv.xml

''grabber'' --days 7 --output tv.xml

Leave off --days and you're get that grabber's default value.
Leave off --outout and the outout will be written to STDOUT (in case you want to pipe to a filter!)

That's it! It really is easy.

== First use example ==

This example uses a grabber against [[https://schedulesdirect.org Schedules Direct's]] JSON service. An account is needed (free 7 day trial, no CC needed, so make sure it works for you before paying!). If you're not using windows, leave off the '''xmltv''' command.

C:\Users\robert\batch>'''xmltv tv_grab_zz_sdjson --configure'''
Timezone is -0500
Cache file for lineups, schedules and programs.
Cache file: [C:\Users\robert/.xmltv/tv_grab_zz_sdjson.cache] '''''<enter> for default'''''
If you are migrating from a different grabber selecting an alternate channel ID format can make the migration easier.
Select channel ID format:
0: Default Format (eg: I12345.json.schedulesdirect.org)
1: tv_grab_na_dd Format (eg: I12345.labs.zap2it.com)
2: MythTV Internal DD Grabber Format (eg: 12345)
Select one: [0,1,2 (default=0)] '''''<enter> for default'''''
As the JSON data only includes the previously shown date normally the XML output should only have the date. However some programs such as older versions of MythTV also need a time.
Select previously shown format:
0: Date Only
1: Date And Time
Select one: [0,1 (default=0)] '''''<enter> for default'''''
Schedules Direct username.
Username: '''''SD username'''''
Schedules Direct password.
Password: '''''SD password'''''
** POST https://json.schedulesdirect.org/20141201/token ==> 200 OK (1s)
** GET https://json.schedulesdirect.org/20141201/status ==> 200 OK
** GET https://json.schedulesdirect.org/20141201/lineups ==> 400 Bad Request (1s)
This step configures the lineups enabled for your Schedules Direct account. It impacts all other configurations and programs using the JSON API with your account. A maximum of 4 lineups can by added to your account. In a later step you will choose which lineups or channels to actually use for this configuration.
Current lineups enabled for your Schedules Direct account:
#. Lineup ID | Name | Location | Transport
(none)
Edit account lineups: [add (default=add)] '''''<enter> for default'''''
Lineup ID or Country (ISO-3166-1 alpha 3 such as USA or CAN): '''USA'''
** GET https://json.schedulesdirect.org/20141201/available ==> 200 OK (1s)
Zip Code: '''75104'''
** GET https://json.schedulesdirect.org/20141201/headends?country=USA&postalcode=75104 ==> 200 OK (1s)
#. Lineup ID | Name | Location | Transport
1. USA-0000001-CUSTOM | ChannelsDVR TV-Everywhere | National | IPTV
2. USA-AFN-X | AFN Satellite | National | Satellite
3. USA-AMZPV-X | Amazon Prime Video | National | IPTV
4. USA-DISH623-X | DISH Dallas/Ft. Worth | Dallas | Satellite
5. USA-DITV-X | DIRECTV | National | Satellite
6. USA-DITV623-X | DIRECTV Dallas | Dallas | Satellite
7. USA-DNOW623-X | DIRECTV STREAM Dallas | Dallas | IPTV
8. USA-DTVNOW-X | DIRECTV STREAM | National | IPTV
9. USA-ECHOST-X | DISH Network | National | Satellite
10. USA-FRNDLY-X | frndly | National | IPTV
11. USA-FUBO623-X | FuboTV Dallas | Dallas | IPTV
12. USA-FUBOTV-DEFAULT | fuboTV | None | IPTV
13. USA-FUBOTV-X | fuboTV | None | IPTV
14. USA-GLRYSTR-X | GLORYSTAR | National | Satellite
15. USA-GNSTR-X | US Streaming (Extended) | National | IPTV
16. USA-HULU623-X | Hulu Dallas | Dallas | IPTV
17. USA-HULUTV-X | Hulu | National | IPTV
18. USA-IMDBTV-X | FREEVEE | National | IPTV
19. USA-PEACOCK-X | Peacock | National | IPTV
20. USA-PHILO-X | Philo | National | IPTV
21. USA-PLUTOTV-X | Pluto TV | National | IPTV
22. USA-SAMSUNG-X | Samsung TV Plus | National | IPTV
23. USA-SLINGTV-X | Sling TV | National | IPTV
24. USA-SLNG623-X | Sling TV Dallas | Dallas | IPTV
25. USA-SMSG623-X | Samsung TV Plus Dallas | Dallas | IPTV
26. USA-TUBISTR-X | TUBI TV | National | IPTV
27. USA-TX42822-X | Charter Spectrum North TX | Dallas | Cable
28. USA-TX42822-L | Charter Spectrum North TX | Dallas | Cable
29. USA-TX66409-X | AT&T U-verse TV | Dallas | Cable
30. USA-VIZIO-X | Vizio | National | IPTV
31. USA-XFINSTR-X | Xfinity Stream | National | IPTV
32. USA-XUMOTV-X | Xumo TV | National | IPTV
33. USA-YOUTUBE-X | You Tube TV | National | IPTV
34. USA-YTBE623-X | You Tube Dallas | Dallas | IPTV
35. USA-OTA-75104 | Antenna | 75104 | Antenna
Add lineup (0 = none): [0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35 (default=0)] '''35'''
** PUT https://json.schedulesdirect.org/20141201/lineups/USA-OTA-75104 ==> 200 OK (1s)
** GET https://json.schedulesdirect.org/20141201/lineups ==> 200 OK (1s)
This step configures the lineups enabled for your Schedules Direct account. It impacts all other configurations and programs using the JSON API with your account. A maximum of 4 lineups can by added to your account. In a later step you will choose which lineups or channels to actually use for this configuration.
Current lineups enabled for your Schedules Direct account:
#. Lineup ID | Name | Location | Transport
1. USA-OTA-75104 | Local Broadcast Listings | 75104 | Antenna
Edit account lineups: [continue,add,delete (default=continue)] '''''<enter> for default'''''
Choose whether you want to include complete lineups or individual channels for this configuration.
Select mode: [lineups,channels (default=lineups)] '''''<enter> for default'''''
** GET https://json.schedulesdirect.org/20141201/lineups ==> 200 OK (1s)
Choose lineups to use for this configuration.
USA-OTA-75104 [yes,no,all,none (default=no)] '''yes'''

C:\Users\robert\batch>''xmltv tv_grab_zz_sdjson --days 1 --output tv.xml''
Timezone is -0500
Initializing...
** POST https://json.schedulesdirect.org/20141201/token ==> 200 OK (1s)
** GET https://json.schedulesdirect.org/20141201/status ==> 200 OK (1s)
Updating lineups...
Indexing channels...
Updating schedules...
** POST https://json.schedulesdirect.org/20141201/schedules/md5 ==> 200 OK (7s)
** POST https://json.schedulesdirect.org/20141201/schedules ==> 200 OK (1s)
Updating programs...
Removing old cache entries...
Writing output...
Done

<nowiki>
C:\Users\robert\batch>more tv.xml
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE tv SYSTEM "xmltv.dtd">

<tv source-info-url="http://www.schedulesdirect.org" source-info-name="Schedules Direct" generator-info-name="tv_grab_zz_sdjson 1.4.0_033">
<channel id="I100147.json.schedulesdirect.org">
<display-name>KFWD-DT4</display-name>
<display-name>KFWDDT4</display-name>
<display-name>52_4</display-name>
</channel>
<channel id="I100561.json.schedulesdirect.org">
<display-name>KHFD-LD7</display-name>
<display-name>KHFDLD7</display-name>
<display-name>16_7</display-name>
</channel>
<channel id="I100815.json.schedulesdirect.org">
<display-name>KODF-LD5</display-name>
<display-name>KODFLD5</display-name>
<display-name>26_5</display-name>
<icon src="https://schedulesdirect-api20141201-logos.s3.dualstack.us-east-1.amazonaws.com/stationLogos/s67676_dark_360w_270h.png" width="360" height="270" />
</channel>
<channel id="I101911.json.schedulesdirect.org">
<display-name>KFWD-DT5</display-name>
<display-name>KFWDDT5</display-name>
<display-name>52_5</display-name>
<icon src="https://schedulesdirect-api20141201-logos.s3.dualstack.us-east-1.amazonaws.com/stationLogos/s16604_dark_360w_270h.png" width="360" height="270" />
</channel>
'''Q to QUIT more```
C:\Users\robert\batch>
</nowiki>

HowToMakeARelease

2017-01-24T05:44:40Z

Rmeden: Created page with "XMLTV Release Procedure Generate ChangeLog cd ~/xmltv perl ../cvs2cl.pl vi ChangeLog search for preparation of previous release delete from previo..."

XMLTV Release Procedure

Generate ChangeLog
cd ~/xmltv
perl ../cvs2cl.pl
vi ChangeLog
search for preparation of previous release
delete from previous release to end of file
read commit comments, keep only major changes
reformat into a "Major Changes" list.

Update Readmes
vi README
update release version number
update release date (bottom of file)
copy in "Major Changes"
vi doc/README.win32
update release version number
update release date (bottom of file)
copy in "Major Changes"

Update Version Numbers
grep -lr <previous release> * # to find files to edit
Update version numbers
vi Makefile.PL lib/exe_wrap.pl lib/XMLTV.pm.in lib/Augment.pm
cvs commit
use comment similar to "preparing for x.y.z release"

Make tar release!
./mkdist --version x.y.z --sfuser <yourusername>
make install

Build XMLTV.EXE ( On Windows development box)
cvs update -d -P
dmake distclean
perl Makefile.PL
dmake install
dmake xmltv.exe
send_exe.bat # to upload xmltv.exe

Make Windows Release (Back on Linux)
make distclean
perl Makefile.PL PREFIX=/tmp/xmltv-x.y.z-win32
make windows_dist
cd /tmp/xmltv-x.y.z-win32/
wget http://alpha-exe.xmltv.org
mv index.html xmltv.exe
chmod 755 xmltv.exe
cd /tmp
zip -r xmltv-x.y.z-win32.zip xmltv-x.y.z-win32
scp xmltv-x.y.z-win32.zip <sd-user>,xmltv\@frs.sourceforge.net:/home/frs/project/x/xm/xmltv/xmltv/x.y.z/

On SF website
Files -> XMLTV -> x.y.z
wait for files to show up.
flag tar as everything except windows
flag zip as windows

Send email annoucement

Update XMLTV wiki with release info

ReplayTV2

2015-07-13T06:13:51Z

Rmeden:

'''ReplayTV Replacement FAQ'''

[http://replaytv.com Digital Networks North America] declared bankruptcy on 2015-07-20. Their guide service probably will never return. You have two solutions to keep using your ReplayTV device.

= Using the PercData/LaHo server to provide Guide Data =
Some community members have gotten together to offer a simple replacement ReplayTV guide service. (code name "LAst HOpe RNS" (LaHo)).

The LaHo service is provided by Perc Data. You can sign up at [http://www.percdata.com Percdata.com].

The cost for the Perc/LaHo service (6-month term) is $21 first ReplayTV, $7 for additional units.

PERC/LaHo do not offer support for dial-up devices.

= Using WiRNS to provide Guide Data =
[http://wirns.com WiRNS] is a free (as in beer) application that can feed guide data to ReplayTV devices and offers other features. WiRNS can obtain data from any [[Main Page|XMLTV]] source or [http://schedulesdirect.org Schedules Direct]. ($25/year for Schedules Direct)

With WiRNS 3.0, all ReplayTV units work fine without Replay's server.

The complexity of a WiRNS solution varies with your ReplayTV unit and configuration. It involves setting up a WiRNS server on a local Windows machine.

= Setting the clock on 2k/3k/Showstoppers ==
There is a hack [http://www.oocities.org/flipflop7146/#clock available here] to add a time set page to your Replay. Doing so involves removing the hard disk and adding programs using a PC.

Once connected to a network (see dialup section), 2k/3k units can also use NTP to set the time. WiRNS can provide the NTP proxy functionality.

= Setting the clock on Network Attached 4k/5k Units ==

You can set your clock using WiRNS 3.0 or Perc/Laho. Perc/Laho supports setting your clock without signing up for a PERC Data account. (just point your ReplayTV there)

= What about Dialup Users =

A solution exists where a PC (physical or virtual) is configured as a [http://www.freesco.org FREESCO] router. The ReplayTV can then dial into the FREESCO router using a phone line, phone line simulator, or even a direct connection. Once connected to the FREESCO router, WiRNS or Laho can be used to update the ReplayTV box.

Such a solution is currently complicated, but eventually step by step directions will be provided. A rough draft of a FREESCO solution is [[ReplayTV-FREESCO|HERE]].

= What about Activation =
All units require registry changes to "undo" things DNNA set in some recent updates. Both WiRNS and Perc/Laho will apply these changes for you. We should even be able to activate a new unit.

= Where can i get more information =
Discussion and work on solutions are quite active in the following Forums:

[http://www.planetreplay.com/phpBB2/viewforum.php?f=32 WiRNS Planet Replay Forum]<br />
[http://www.avsforum.com/avs-vb/forumdisplay.php?s=&forumid=27 ReplayTV AVS Forum ]<br />

= How can I help =
* If you see anything wrong with this FAQ, please update it. (it is a Wiki after all)
* If you have the technical ability, monitor the forums and help!
* Create step by step solution instructions. (start in the forum, can move to a wiki later)
* Create step by step instruction videos.