====== Australian TV Guide Data for MythTV ======
===== Author(s) =====
Bill Giannikos (bill2 at giannikos.com.au) [[http://www.billgiannikos.com]]
===== Introduction =====
This guide will help you get TV guide data for MythTV. There are currently three options available, [[http://minnie.tuhs.org/twiki/bin/view/TVGuide|OzTivo]], [[http://svn.whuffy.com/|Shepherd]] and [[http://www.icetv.com.au|IceTV]].

This guide assumes that you already have configured MythTV have setup the channels for digital free to air and optionally Foxtel by following the [[Configuring MythTV for Australian Digital TV]] and [[Setting up Foxtel Channels in MythTV]] guides.

===== Comparsion =====
^ ^OzTivo^Shepherd^IceTV^
^Price|Free|Free|Commercial|
^Foxtel|Yes|Yes|No|
^Guide Quality|Good|Excellent|Excellent|
^Legality|Legal|Questionable*|Legal|

===== OzTivo =====
OzTivo is a community driven TV guide. Here is how to setup MythTV to use it.
To begin, you will need to create a account at [[http://oztivo.net/twiki/bin/view/TWiki/TWikiRegistration]]. Make a note of your username and password, you will need it for later.

Log in to the [[http://oztivo.net/tivo-bin/tvguide.pl|OzTivo site]] and click on 'Set user preferences'. Select all the stations you will like to receive TV Guide data for and make sure the 'My preferred download format' option is set to 'XMLTV format'. Then click on 'Submit your new preferences' to save these changes.

On the MythTV system, switch to root and type in the following:

<code>cd /usr/local/bin
wget http://www.cse.unsw.edu.au/~willu/xmltv/tv_grab_au_reg
chmod 755 tv_grab_au_reg
ln -s /usr/local/bin/tv_grab_au_reg /usr/local/bin/tv_grab_au
tv_grab_au --configure --config-file ~/.mythtv/FTA-Oz.xmltv</code>

And if you have foxtel type

<code>tv_grab_au --configure --config-file ~/.mythtv/Foxtel.xmltv</code>

Now edit the ~/.mythtv/FTA-Oz.xmltv file with your favourite editor, something like 'nano -w ~/.mythtv/FTA-Oz.xmltv' should work. If you followed the [[Configuring MythTV for Australian Digital TV]] and [[Setting up Foxtel Channels in MythTV]] guides then all you need to do here is change the username and password to match your registration details on the [[http://oztivo.net/tivo-bin/tvguide.pl|OzTivo]] site. Otherwise follow the instructions in this file to map the channel IDs from OzTivo to your XMLTV IDs in MythTV. If you have Foxtel, edit the ~/.mythtv/Foxtel.xmltv file as well.

For more information on tv_grab_au_reg please visit [[http://www.cse.unsw.edu.au/~willu/xmltv/tv_grab_au_reg.html]].

You can now run 'mythfilldatabase' which should download the TV Guide data for you.

===== Shepherd =====
[[http://svn.whuffy.com/index.cgi/wiki/Installation|Shepherd Install Page]]

===== IceTV =====
Purchase an account at [[http://www.icetv.com.au/]] and make a note of your username and password.

Follow the XMLTV setup for OzTivo as the tv_grab_au_reg script integrates both OzTivo and IceTV guide fetching.