Prerequisite
This might be obvious for some of you, but Freevo relies on external tools and programs for it's functions. For example it calls Xine or Mplayer to show videos and TV, lirc for mapping remote functions, ... you get it. So please make sure they work as intended before trying to set up Freevo. If it doesn't work, Freevo won't fix it. Please see the Links sections for a list of those tools.
Overview
There are three configuration files for Freevo:
freevo.conf
freevo_config.py
local_conf.py
The first one, freevo.conf, contains some basic information about your system, as paths to important programs, the type of your display (X11 or framebuffer), the resolution of your screen and other things. It will be generated by the command freevo setup . A system wide one might be at /etc/freevo/freevo.conf.
The second one, freevo_config.py is where the default parameters are stored, so DO NOT EDIT freevo_config.py. This file will probably be in /usr/share/freevo.
If you want to change anything in Freevo's configuration, put the stuff in local_conf.py. Things in local_conf.py will override the defaults in freevo_config.py.
Usually you will find your local_conf.py in your home directory in the .freevo directory, if that is not the case you should look for an example file of local_conf.py in your freevo installation and copy it to ~/.freevo/local_conf.py.
When editing local_conf.py, you should be aware that it is not a normal config file, but Python code. Therefore you have to follow some rules to avoid crashes. The most important thing is that lines starting with a variable must not have SPACES or TABS at the beginning. If you make a mistake there, Freevo will crash complaining about: invalid syntax.
Note: On Gentoo, as of 2004-12-29, there is no copy of local_conf.py in the installed freevo package (in site-packages). You can find a copy in the ViewCVS repository.
Subpages:
Basic Configuration: An introduction to some basic configurations in Freevo
Detailed Configuration: Notes on all the settings in local_conf.py (partial)
.
TV: Configure analog or digital cards to use in Freevo
Movie: Configure the video menu
Audio: Configure the audio menu
Image: Configure the image menu
Games: Configure freevo for playing mame, snes and playstation games.
.
Recordserver: how to configure the recordserver
Webserver: how to configure the internal webserver
.
Lirc: Configure the remote control for Freevo
TV Out: Configure a TV Out
Boot into Freevo: How to boot directly into Freevo