FreeGuide INSTALL-linux

These are Linux installation instructions. For Windows installation instructions see INSTALL-windows.html.

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. Installation from source is tricky due to the large number of prerequisites required from CPAN.

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 --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.

German people don't need to do perform this step, lucky them!

Installation

When XMLTV is installed and configured, download the FreeGuide-xx-Linux-Install jar file and run it with java -jar FreeGuide-xx-Linux-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 README for info on how to use FreeGuide.

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