Freevo

- User Documentation

# TroubleShooting

When troubleshooting there are a few steps you need to follow to make your life reposting an issue, and our life trying to resolve the issue, easier.

## Step 0

Check this Wiki, the FAQ and the archives of the mailing lists, maybe you find any hints.

## Step 1

Produce more debug information. Add this lines to local_conf.py :

    DEBUG=1
    CHILDAPP_DEBUG = 1

Then restart Freevo! This will turn on verbose output of most of the plugins. Warning: you'll get more info than you need, but more is better than less...

Freevo's logging output will be saved in `/var/log/freevo/main-X.log` , where X is the uid of the user, who runs freevo. Moreover the `stdout` and `stderr` of every application freevo launches will be saved in correspondent files in `/var/log/freevo` . If freevo doesn't have access to `/var/log/freevo` then you will find the log files in `/tmp/freevo`. You can create the `/var/log/freevo` directory manually if it wasn't created when you installed freevo to stop freevo saving the log files in the `/tmp/freevo` dir. The problem with the log files in `/tmp` is, that everything there is usually deleted when you shutdown your system.

## Step 2

Use the menu to try whatever it is you are trouble shooting, then scroll through the log files for some information on what happens in the background.

### Recordserver

Check the log file:

    /var/log/freevo/recordserver-0.log

Try the command you find. Does it run? If so then maybe you have a permissions issue. Freevo 1.5.X can be running as any user you specify and thus that user needs the permissions set for recording device access and of course for the directories the recording should be saved.

### Other Applications

Check the output files of freevo's childapplications. For example:

    /var/log/freevo/mplayer-stdout.log
    /var/log/freevo/mplayer-strerr.log

Maybe you find a hint. Maybe it is something as wrong/unknown options. As above, try the command freevo runs. Does it work? If so, try it as the freevo user. If not, there's your issue..

An example: sometimes DVDs ripped to DivX by mencoder cannot be played by freevo. They can be played by mplayer directly, however. Looking in local_conf.py we see that the "-idx" option is specified with mplayer when it runs .avi files. Normally this is unnecessary, because its purpose is to rebuild broken avi indexes and most avi files don't need this. Usually it does no harm, but with the mencoded files in question it causes a bunch of error messages and mplayer quits. The fix is simply to remove the "-idx" from the mplayer options in local_conf.py.

## Step 3

If you still can't find the cause of the issue, post a query to the mailing list. Please include the relevant settings in your local_conf.py and the relevant log file output.

last edited 2005-05-08 15:28:22 by DominikRoettsches
current version: http://freevo.sourceforge.net/cgi-bin/doc/TroubleShooting