Version 3 (modified by lincoln, 7 years ago)

--

Installation

To install Shepherd:

  1. Download http://www.whuffy.com/shepherd/tv_grab_au
  2. Make it executable
  3. Run it. The script will attempt to install and configure itself.

These can be accomplished via: 

wget http://www.whuffy.com/shepherd/tv_grab_au
chmod +x tv_grab_au
./tv_grab_au

We recommended you run Shepherd as a standard user and never as root (super-user).

When run for the first time, Shepherd will install itself in ~/.shepherd/ or /opt/shepherd/. You should symlink /usr/bin/tv_grab_au to the tv_grab_au script in the shepherd directory. In most installations, this is accomplished via: 

ln -s ~/.shepherd/tv_grab_au /usr/bin/tv_grab_au

Dependencies

Shepherd has numerous dependencies on 3rd party modules and software. Some of these are mandatory, some are optional depending on whether you wish Shepherd to run with its full suite of plugin modules or not.

XMLTV

XMLTV needs to be installed. The latest version can be downloaded from http://files.xmltv.org/
If you are unsure about whether you have XMLTV installed, run the command perldoc XMLTV and see if there is any documentation on your system. If there is, then it is already installed.

XMLTV version 0.5.44 or later is recommended as it supports HDTV flags.

Mandatory Perl modules

The following Perl modules are mandatory for Shepherd to be able to run:

  • Algorithm::Diff
  • Getopt::Long
  • Compress:ZLib
  • Data::Dumper
  • Date::Manip
  • List::Compare
  • !LWP::UserAgent?

If these aren't installed on your system, you may be able to install them automtically via CPAN (note: you will probably have to do this while logged in as root or via sudo): 

CPAN LWP::UserAgent Getopt::Long Data::Dumper Compress:ZLib Algorithm::Diff List::Compare

Optional Perl modules

Various grabbers and postprocessors require additional Perl/CPAN dependencies. These include:

  • Cwd
  • !DateTime::Format::Strptime
  • File::Basename
  • File::Path
  • Javascript
  • HTML::Entities
  • !HTML::TokenParser?
  • !HTML::TreeBuilder?
  • IO::File
  • Storable
  • !Time::HiRes?
  • XML::DOM

To install any missing CPAN modules, you can ask CPAN to install/update/check them all using the following (note: you will probably have to do this while logged in as root or via sudo): 

CPAN Cwd DateTime::Format::Strptime File::Basename File::Path Javascript HTML::Entities HTML::TokenParser
CPAN HTML::TreeBuilder IO::File Storable Time::HiRes XML::DOM

(these should all install properly with the possible exception of Javascript which requires your Unix/Linux installation - js and js-devel on Fedora).