Freevo

- Index
- Configuration

# Configuration

Site Index:

1. Configuration Files
2. Basic configuration
3. Main menu
4. Volume control
5. Skins
6. Configuring folders
   1. Appearance
   2. Protection

Subpages:

- Lirc: configure the remote control for Freevo

- TV Out: configure a TV Out

- Boot into Freevo: How to boot directly into Freevo

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

## Configuration Files

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

The second one, freevo_config.py is where the default parameters are stored, so DO NOT EDIT freevo_config.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 your home.

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.

## Basic configuration

You WILL need to make a few customizations to suit your system. So open your local_conf.py with an editor, and have a look what you might want to change. The file is good commented, and for most things there are examples.

Most people will change at least the following variables:

- `VIDEO_ITEMS` : Directories where your movies are

- `AUDIO_ITEMS` : Directories where your audio files are

- `IMAGE_ITEMS` : Directories where your images are

Directories that do not start with a / are relative to the directory that Freevo was started from. Note that you cannot use tilde (~) expansion in filenames.

Also check the mplayer section to specify the audio device and special parameter for mplayer.

## Main menu

If you do not want to use some parts of freevo, you can easily remove them from the main menu:

    plugin.remove('tv')
    plugin.remove('audio')
    plugin.remove('video')
    plugin.remove('image')

## Volume control

In local_conf.py you can give Freevo several default volume level for the different media.

If you press VOL+ and VOL- the volume level is changed by 5%. You can change this step size easily by putting the following stuff in your local_conf.py.

    EVENTS['global']['VOL+'] = Event('MIXER_VOLUP', arg=2)
    EVENTS['global']['VOL-'] = Event('MIXER_VOLDOWN', arg=2)

where the value you give as 'arg' is the step size.

## Skins

At the moment there are three different skins to choose from. You can reach the menu where you can choose the skin by pressing DISPLAY in the main menu. Just select the skin you like best. But be aware that there may be features which are not implemented in all skins. If you like to invent your own skin, you should have a look at: Skins.

## Configuring folders

When you press ENTER while a directory is highlighted a submenu will open. Among other options there is a menu entry for configuring the directory. Choosing that entry gives you a menu, where you can change the behaviour of this directory. Freevo will create a file folder.fxd ( see FXDFiles) in that directory to save your settings. If this file is missing freevo will use the default values. Things that you can change are for example:

- the way entries in the directory are sorted

- or the skin layout

- or if freevo should regard the directory as a playlist

- etc...

### Appearance

Moreover you can specify an image to display in the folder's parent menu by adding an image to the folder called cover.jpg or cover.png. The size of the image depends on the current type of the menu. For movies you have something like DVD covers or movie poster, for audio a cd cover. So the image will be resized to 280x200 for movies, 200x200 for audio and 200x160 for images. These sizes will also be used for the directory images. You can change the sizes by changing the XML file (see FXDFiles for more info).

### Protection

Individual folders can be password protected by adding a text file named ".password" (note the leading dot). This file should contain the access password, in plain text, not encrypted in any way. Obviously, this is a fairly weak access mechanism if a user has local access to the machine, but it works fairly well in informal home environments.

A remote control input can be used to type in the password. That is why a strictly numeric password is suggested.

last edited 2005-01-05 10:24:05 by JohnMolohan
current version: http://freevo.sourceforge.net/cgi-bin/doc/Configuration