THIS PAGE IS CURRENTLY UNDER CONSTRUCTION estrand (at) isomedia (dot) com DON'T RELY ON THESE INSTRUCTIONS UNTIL I COMPLETE THEM
Here are steps I've taken to get Freevo 1.7.4 to work under Ubuntu Gutsy Gibbon (specifically Kubuntu 7.10). I developed and tested them upon a brand new installation of Kubuntu from the alternate installation CD.
It is important to note that this installation assumes that you will be running freevo and the recordserver under a user account. Running Freevo as root is problematic. In fact, after installation, the mere attempt to run Freevo as root messes up Freevo's ability to run under the user account.
So I started by creating a working directory in my home directory and moving to it:
mkdir ~/tmp cd ~/tmp
Freevo itself is installed from its sources. So based on the information on this page: SourceInstallation, you must obtain the Freevo sources and the kaa sources:
Here is how I download the source files into my working directory:
wget http://downloads.sourceforge.net/freevo/kaa-base-0.1.3.tar.gz wget http://downloads.sourceforge.net/freevo/kaa-imlib2-0.2.1.tar.gz wget http://downloads.sourceforge.net/freevo/kaa-metadata-0.6.1.tar.gz wget http://downloads.sourceforge.net/freevo/freevo-1.7.4.tar.gz
and here is how I extracted the files from the tar archives:
tar -xzf kaa-base-0.1.3.tar.gz tar -xzf kaa-imlib2-0.2.1.tar.gz tar -xzf kaa-metadata-0.6.1.tar.gz tar -xzf freevo-1.7.4.tar.gz
The next step is to install from these sources, but several things must be done before they'll compile successfully. This is where I've seen evidence of people getting stuck. The kaa utilities and Freevo need to be compiled, but the base installation of Ubuntu does not have a sufficient development environment installed.
Here is what I did to get the development environment at a stage where the kaa utilities and Freevo would compile.
sudo apt-get install build-essential
Further, kaa-imlib2-0.2.1 needs a library installed before it will compile successfully, so:
sudo apt-get install libimlib2-dev
While we are in the process of installing packages, we might as well install several more that are required to install Freevo:
sudo apt-get install python-beautifulsoup sudo apt-get install python-pygame sudo apt-get install python-imaging sudo apt-get install python-twisted sudo apt-get install python-xml
Those files will allow Freevo to install, but several more packages are needed for Freevo to run. Let's grab those helper programs too:
sudo apt-get install mplayer sudo apt-get install mencoder sudo apt-get install tvtime sudo apt-get install xmltv sudo apt-get install lame
OK, those are all the packages that have to be installed. If you use xine or some other helper programs, I leave it to you to install those. My needs only require the packages above.
So now we can actually install the kaa utilities. This is how I did it:
cd ./kaa-base-0.1.3 sudo python setup.py install --record installed_files cd ../kaa-imlib2-0.2.1 sudo python setup.py install --record installed_files cd ../kaa-metadata-0.6.1 sudo python setup.py install --record installed_files cd ..
Now to install Freevo itself:
cd ./freevo-1.7.4 sudo python setup.py install
Now run the Freevo setup:
It will create a directory in your home directory called ".freevo". In it will be "freevo.conf".
The next step is to create a local_conf.py in the same directory. The Freevo installation instructions suggest copying the example file:
cp local_conf.py.example ~/.freevo/local_conf.py
and then editing it to suit your needs. These configuration instructions will help you configure Freevo to your liking:
The rest of the installation is specific to my needs, but I'll include it here in the event that it might prove useful.
TODO: My configuration TODO: Starting/Stopping recordserver