Freevo

- User Documentation

# MovieUsage

Site Index:

1. General
2. Movie images
3. FXD files for movies

### General

The main menu item Watch A Movie contains all which is associated with movies. You find your movie directories here (as defined in local_conf.py, see MovieConfig) and your cd/dvd drives.

Freevo shows all you rom drives in the MOVIE MAIN MENU (set the variable ROM_DRIVES in the config file if the auto detection doesn't work). You don't need to mount the disc, freevo will automatically mount and umount the drive. After you insert a new disc, the MAIN MENU will update. You have complete control over your drive, the EJECT button on the drive should work all the time, except when you play a file from the disc and when you browse the disc with freevo.

You can use mplayer or xine for watching movies. Both players support a variety of codecs. You can give freevo lists which kind of files should be played by mplayer and which by xine, see MovieConfig.

The big advantage of xine is that it supports the menus which are on DVDs. If you use xine for DVDs, selecting a DVD will start the main movie. Pressing MENU should show the dvd menu, and pressing GUIDE should show the chapter menu. You can navigate in this menu with LEFT, RIGHT, UP, DOWN and SELECT. The language is changed by the LANG button and the subtitle by the SUBTITLE button. See KeyMaps

### Movie images

You can drop a JPEG or PNG image file with the same basename as the movie into the folder and this image will be used for this movie.

Example: movie.png will be used for movie.avi

There is also a generic way for images of tv shows. Recordings for tv shows have a common name scheme. If you drop an image with the name of the show into the tv show image directory, this image will be taken. The name of the image _must_ be lower case. You can specify a directory for tv show images in freevo_config.py, the default is

    TV_SHOW_DATA_DIR = "tv-show-images/"

Example: if you have tv-show-images/show.png, this image will be used for "Show 2x10 - A cool episode.avi"

### FXD files for movies

A more complex way is the FXD support for movies. The FXD file is a special XML file that contains a link to a movie. The movie can be on your hard disk, on CD-ROM or even a DVD or (S)VCD. The FXD file contains the title, the image and a list of files. FXD files can also be used to define alternate audio tracks or to string together the pieces of a movie that spans multiple media files. You can use imdb.py in freevos helpers directory to create these FXD files.

If you store the id of the DVD/VCD/SVCD/CD in the FXD file (use --add-id as parameter for imdb.py). Freevo will display the title and the image in the MOVIE MENU menu when you insert the disc. The FXD files for this feature are searched in DIR_MOVIES and in MOVIE_DATA_DIR.

See MovieFxd for more detail and some examples.

last edited 2005-01-05 11:44:21 by JohnMolohan
current version: http://freevo.sourceforge.net/cgi-bin/doc/MovieUsage