Configure the main freevo process

Freevo2's main config file is called freevo2.conf. It is created automatically in ~/.freevo the first time you start freevo. After creation of the config file, freevo exits and tells you to have a look at the settings in the config file and change them to your liking. The file is created with resonable defaults, but you should at least set the locations of your media files (music, video, images), as freevo has no way of determining where you store those files. If you do not change anything, then freevo will start with just the tv menu and the shutdown menu.

Changing settings in the config file

The config file is created automatically and will be updated automatically by freevo when needed. You can set the existing variables, but you cannot create new entries or comments, because they will be overwritten when freevo updates the file. If you want to change a setting, you must remove the # before the specific setting and change the value according to your needs. All settings starting with a # will be resetted to the default values.

Media

There is a section for each media type in the config file (audio, image, tv and video). Each section starts with the activation of this media type.

audio.activate = 30

The number defines the order of the corresponding menu item in the main menu. A smaller number corresponds to a higher position. Thus by varying this numbers you can change the order of the menu entries. The default order is:

tv (10)
video (20)
audio (30)
image (40)
shutdown (90)

If you want to deactivate a specific media menu, you just need to set the number to 0.

audio.activate = 0

As freevo has no way to find media files by itself, you must tell freevo where to look for the media files. You can set any number of locations for each media type.

audio.items[0].path = /music
audio.items[0].name = My music collection

audio.items[1].path = /usr/local/media
audio.items[1].name = More music

Moreover there are for each media type many more options, that can be set. And of course, plugins that can be configured.

Plugins

The configuration of plugins works in the same way as that of the media menus (which are also just plugins internally). The settings of plugins that belong to a specific media type are situated right after the general settings for that media type. Others, as e.g the idlebar plugins, have there own sections. For each plugin there is a activation statement. If the plugins is activated the numeric value of this activation statement must be greater than 0. For deactivating a plugin just set this number to 0. Like in the case of the media menu items the number defines the order of the plugins, e.g. the order of the idlebar plugins in the idlebar or the number of different media item plugins in the context menu of a media item of that type.

idlebar.plugin.logo.activate = 0

plugin.file_ops.activate = 30

Other settings

There is quite a lot of things to configure individually, e.g directory settings, settings for different players (xine, mplayer etc.), settings concerning the display of freevo (screen resolution, overscan etc.) and many many more. Have a look at the comments in the config file.

Helper servers

Each helper programm has its own config file, which also is created automatically when the helper is started the first time and is in the same format as freevo's main config file. For the tv related part of freevo there are e.g. three helper server (see TvConfig).