Skip to content
dups edited this page Dec 15, 2011 · 12 revisions

Shepherd (tv_grab_au)

Shepherd provides reliable, high-quality Australian TV guide data by employing a flock of independent data sources.

Background

Australians have traditionally had two options for acquiring TV guide data:

  1. Downloading pre-compiled data from a service like IceTV or OzTivo
  2. Using a tv_grab_au script to read data from a web site like ninemsn.com.au

Each method has drawbacks. The quality of pre-compiled data varies, while tv_grab_au scripts tend to frequently break. Shepherd aims to solve the traditional problems of tv_grab_au scripts:

  1. It employs multiple TV guide grabbers and data sources, switching between them as necessary when one fails
  2. It auto-updates, eliminating the need for users to manually address problems

Description / Features

Shepherd knows enough about the capabilities of each grabber in order to make intelligent judgments about which is most appropriate for any given situation, maximizing data quality while minimizing bandwidth usag e. It analyses the XML output from each grabber to determine whether any further grabbers are required to obtain a full dataset of the required channels. It then employs postprocessor components to further refine the data: the IMDB postprocessor adds movie information from IMDb.com, tvdb_augment_data adds series/episode details from TheTVDB.com, flag_aus_hdtv marks shows that are available in High Definition, and more.

When switching between data sources, Shepherd's reconciler keeps show names consistent. For example, if you're used to recording a programme called House but a different data source names it House, M.D., Shepherd remembers the original name and automatically substitutes it.

If you're a MythTV user, during installation Shepherd will help you choose appropriate guide data for each of your MythTV channels, and can even install MythTV channel icons for you.

Shepherd is designed to be future proof, never requiring manual intervention once installed and configured. It will automatically update itself with fixes, enhancements, and additional grabbers and postprocessors as they become available.

Download & Installation

See the Installation page.

Status

Shepherd is a reliable source of free-to-air guide data. Pay TV and HDTV are somewhat less reliable (particularly HDTV, which is in a transitional phase).

How does it work?

  • The FAQ contains some questions and answers.
  • The Logic wiki page describes how shepherd works. The default policies used by shepherd are documented on the wiki/Policies wiki page.
  • The Security page discusses security issues associated with Shepherd.

Help & Support

For help or further discussion, please join the Shepherd mailing list

There is also an Issues tracker above. Please only use this to report identified problems. If you're not sure what the problem is, use our friendly mailing list to troubleshoot.