To use FreeGuide on Linux you need Java and XMLTV.
You will need the Java 2
Runtime Environment version 1.4 or above: You can check this by
typing java -version in a terminal. (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
. Ask on the FreeGuide Users'
mailing list (see the Contact page) if you
have trouble installing Java.
Ubuntu users can install Sun's version of Java by typing:
sudo apt-get install sun-java5-jre
in a terminal, after making sure the "multiverse" repository is enabled.
Continue with your distribution:
First, you will need the latest version of XMLTV. This is made fairly easy for RedHat and Fedora users who can sign up for the ATRPMs package repository by following the instructions at atrpms.net/install.html and then install XMLTV by simply typing
su -c "yum install xmltv"
or similar.
For other RPM-based distros, you should find XMLTV in your favourite package repository (let us know so we can add it here).
If you want to do it the hard way, you can find RPMs (for RedHat and Fedora) at http://atrpms.physik.fu-berlin.de/name/xmltv/.
Now, to download FreeGuide, go to the sourceforge
download page, 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 "
" or " ") or alternatively by typing into a terminal:freeguide
You'll now need to answer a few questions, and then you're ready to go.
First, you will need the latest version of XMLTV which you can get by typing:
sudo apt-get install xmltv
or just:
apt-get install xmltv
logged in as root. On Ubuntu, the xmltv package is in the "universe" repository, so ensure that is enabled. On Debian, the best version is usually in "unstable".
Now download and install the FreeGuide Debian packages from http://packages.debian.org/freeguide.
You can now run FreeGuide by choosing it from the menu or alternatively by typing into a terminal:
freeguide
You'll now need to answer a few questions, and then you're ready to go.
First, you will need to install XMLTV. Either use emerge if the xmltv package is available, or, if you have to, install XMLTV from source.
FreeGuide isn't officially supported by Gentoo, but there are ebuilds which can be installed manually.
First, go to the sourceforge
download page and download the
freeguide_gentoo_ebuilds_x.y.z.tar.bz2
file.
Second: Follow the instructions on Gentoo Wiki: Installing 3rdParty ebuilds.
After you have set up your local portage overlay dir, extract the freeguide ebuild file into the directory and do a
ACCEPT_KEYWORDS="~x86" emerge install freeguide
There are several freeguide packages in portage, but "freeguide" alone installs the most necessary ones. If you need another grabber or other plugins, type
emerge search freeguide
and choose the right ones for you.
You can now run FreeGuide by choosing it from the menu or alternatively by typing into a terminal:
freeguide
You'll now need to answer a few questions, and then you're ready to go.
First, you will need to install XMLTV. Either use your operating system's package management system, or, if you have to, install XMLTV from source.
Go to the sourceforge
download page and download
freeguide-x.y.z-bin.tar.gz
.
You can either unzip this tarball in /
as
root, or unzip it somewhere else and modify the file
usr/bin/freeguide
to point at the correct
paths.
You can now run FreeGuide by typing:
freeguide
You'll now need to answer a few questions, and then you're ready to go.
NOTE: if you use a different operating system or Linux distribution and would like to contribute either more detailed installation instructions or a specific installer, we'd welcome your contribution! Please contact the developers' mailing list.
Most people will not need to do this. See the instructions above for your distro on how to get XMLTV.
To install XMLTV 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
su -c "make install"
If you have a proxy server or are behind a firewall, you may need to follow the instructions below to allow FreeGuide to see past them to the Internet.
NOTE: most home users will NOT need to do this - you are ready to start FreeGuide! Go straight to the User Guide.
Add 2 lines to the file
~/.bash_profile
:
export http_proxy=http://proxy.uni.ac.uk:8080
export FREEGUIDE_OPTS=-DproxySet=true -DproxyHost=http://proxy.uni.ac.uk -DproxyPort=8080
Replace "proxy.uni.ac.uk
" with your proxy server
address, and "8080
" with the port it
uses.