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

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. If you like, you can simply run the FreeGuide installation (see below) and the grabber will be configured within that. If you would like to do it manually, type (at a command prompt):

`tv_grab_`

and then press TAB a couple of times. You should see a list of the possible commands. You want the one for your country: e.g. "na_dd" for North America, "uk_bleb" for UK, "dk" for Denmark. Continue typing the command by adding the correct completion, and then a space, and then `--configure`. So the full command should look like this:

`tv_grab_fi --configure`

(Except with "fi" relaced with the correct country code.)

Now press return and follow the instructions to configure your grabber.

## Installation

To install FreeGuide, download the FreeGuide-xx-noarch.rpm RPM file and install it like so:

`su -c "rpm -i FreeGuide-xx-noarch.rpm"`. This will install FreeGuide and put a shortcut to it in the menu.

You can now run FreeGuide by choosing it from the menu (in RedHat it's under "Accessories" or "Other") or alternatively by typing:

`java -jar /usr/share/freeguide/FreeGuide.jar`

You'll now need to answer a few questions, and then you're ready to go.

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.

If you prefer not to use RPM, you can build FreeGuide from source. You'll need Apache Ant. Further instructions are on the developers' page.

Binary packages built for other operating systems and distributions will be welcomed.

There are also Debian packages available from http://packages.debian.org/freeguide.