FreeGuide INSTALL-linux-noxmltv

Prerequisites

To use FreeGuide you need:

• The Java 2 Runtime Environment version 1.4 or above. You can check this by typing java -version in a command-line window. (If you've installed the new version of Java but "java -version" still says the old one, you need to look at putting the new version of java in your PATH.
• The latest version of XMLTV.

You can find RPMs for RedHat and Fedora at http://atrpms.physik.fu-berlin.de/name/xmltv/ and if you run Debian you can find xmltv in unstable.

• To install from source (which can be tricky due to the large number of prerequisites) download the latest version plus the prerequisites.

If you want to be able to configure your grabber using the GUI interface from within FreeGuide, you'll need to download the patched grabber and use it instead of the xmltv sources.

Install from source in the usual way with "perl Makefile.PL && make && make install".

After installing XMLTV, you need to configure it. Connect to the Internet before doing this. UK people should type (at a command prompt):

tv_grab_uk_rt --configure

and US and Canadian people should type:

tv_grab_na --configure

people from New Zealand should type:

tv_grab_nz --configure

people from Finland should type:

tv_grab_fi --configure

people from Italy should type:

tv_grab_it --configure

people from Spain should type:

tv_grab_es --configure

people from the Netherlands should type (you may get some errors, but it should work):

tv_grab_nl --configure

people from Denmark should type:

tv_grab_dk --configure

people from Hungary should type:

tv_grab_hu --configure

Follow the instructions to configure your grabber.

Installation

When XMLTV is installed and configured, download the FreeGuide-xx-Linux-NoXMLTV-Install jar file and run it with java -jar FreeGuide-xx-Linux-NoXMLTV-Install.jar. This will install FreeGuide in a directory of your choice.

You can now run FreeGuide by typing:

cd ~/freeguide-tv (adapt if you installed it elsewhere)
java -jar FreeGuide.jar

If you've used the default options everywhere, it should just work.

See the User Guide and FAQ for info on how to use FreeGuide.

If you have any problems, contact us and we'll sort you out.