Configuration

If you are new to configuring Freevo please see the Prerequisites and Overview sections below. Note that Freevo's configuration variable names sometimes change and these changes aren't necessarily recorded in the wiki. If changing your local_conf.py doesn't have the expected result try running:

freevo convert_config /path/to/local_conf.py
freevo convert_config /path/to/local_conf.py -w

If you are using 1.9.0 run:

freevo convert_config --scan --file path/to/local_conf.py
freevo convert_config --scan --file path/to/local_conf.py -w

The first command will show the changes to be made whilst the second writes them to local_conf.py. If the wiki is wrong please feel free to update it.

Guides

General

• Basic Configuration: An introduction to some basic configurations in Freevo

• Detailed Configuration: Notes on all the settings in local_conf.py (partial)

Media

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

Services

• Recordserver: how to configure the recordserver

• Webserver: how to configure the internal webserver

• SecureWebserver: how to configure the internal webserver with SSL and encrypted passwords

• EncodingServer: how to configure the encodingserver

• CommdetectServer: how to configure the commercial detection server

Display

• LCD: Configure the LCD/VFD display for Freevo

• TV Out: Configure a TV Out

Control

• Lirc: Configure the remote control for Freevo

• Linux Event Interface: Configure the remote control for Freevo without lirc

• Mouse: Configure the mouse to work with Freevo

Usage

• Boot into Freevo: How to boot directly into Freevo

• Multiple Users: How run Freevo with different users

.

Prerequisites

This might be obvious for some of you, but Freevo relies on external tools and programs for its 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 LinkPage for a list of those tools. .

Overview

There are three configuration files for Freevo:

freevo.conf

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.

freevo_config.py

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.

local_conf.py

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.