FreeGuide Developers' Page

This is a small page that should expand over time.

Attitude

I (Andy Balaam) am open to contributions from anyone and I expect to accept most patches I receive, except ones that differ radically from my stated aim of creating a nice, simple TV guide.

Development Language

FreeGuide itself is written entirely in Java (1.4 required), but it uses the XMLTV tools (XMLTV is a separate project) which are written in Perl.

The releases are built using Apache's superb Ant build tool. In fact, I use the AntFarm plugin in JEdit, but this isn't necessary.

Building FreeGuide from CVS

Do a checkout with:

cvs -d:cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/freeguide-tv login

cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/freeguide-tv co freeguide-tv

Then download the XMLTV windows binary and source code packages from Sourceforge and do the following:

(Assuming you checked out the sources into ~/freeguide-tv/)

Place the source file xmltv-x.x.x.tar.bz2 into ~/freeguide-tv/xmltv/

Unzip the Windows binary file xmltv-x.x.x-win32.zip to a temporary file and copy the file xmltv.exe to ~/freeguide-tv/xmltv/

You should now be able to build a distribution using Ant. Note that the automatic conversion of the documents README.html and INSTALL-linux.html documents to text files README and INSTALL respectively will only happen on Linux.

Help and questions

Email any questions to freeguide-tv-devel@lists.sourceforge.net and we'll do our best to answer them, and put useful answers up on this page.