[Index] [TitleIndex] [WordIndex

North American listings

In order to use XMLTV for North America, you will need to create a Zap2It Data Direct account (be sure to read the license agreement). Recent versions of XMLTV no longer include the older tv_grab_na script, requiring you to instead use the tv_grab_na_dd script (which connects to Zap2It Data Direct).

Once you have your Data Direct account, you will need to create a "channel lineup" within it (via the Zap2It web interface). This lineup describes the channels which will be included in your XMLTV downloads. They are normally defined by specifying your zip/postal code and then choosing your service provider (e.g. a cable company).

Because the provider of North American listings has recently stopped providing stop time data, an extra step is required to guess the stop times if you are a user of the tv_grab_na tool. The simplest way to fix it is to re-process the guide with tv_sort, which will fix the broken listings. (tv_sort is included with xmltv, so you shouldn't need to install anything).

todayis=`date +%Y%m%d`
/usr/bin/tv_grab_na --days 1 | tv_sort > $HOME/freevo/xmltv/listings_$todayis.xml
rm -f /tmp/TV.xml
ln -s $HOME/freevo/xmltv/listings_$todayis.xml /tmp/TV.xml

(This recipe seems to be outdated now (or does Data Direct suffer the same problem)? It's cleaner than the generic download script at the top of the section, anyway, and runs once you add _dd to the command-name. Should also note that this script assumes (AFAICS) you will be running as the freevo user (or at least someone to whose $HOME directory every other user has access)).

Upgrading Notes:

2014-02-15 05:47