# &app; Manual V&manrevision;

2003
Chee Bin HOH
GNOME Documentation Project

&legal;

Chee Bin
HOH
GNOME Documentation Project

     cbhoh@gnome.org

&app; Manual V&manrevision;
&date;

Chee Bin HOH cbhoh@gnome.org

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

The &app; application is a movie player for the GNOME desktop based on xine library, it enables you to play movies or songs.

&app; provides the following features:

- Support a variety of video and audio files.

- Provide a variety of zoom levels and aspect ratios, and a full screen view.

- Seek and Volume controls.

- A playlist.

- A complete keyboard navigation.

&app; also comes with additional functionalities such as:

- Video thumbnailer for GNOME.

- Webcam utility.

- Nautilus properties tab.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Multimedia &app; .

Command line

  To start &app; from a command line, type the following command, then press Return:

  `totem`

  To view other command line options that are available, type `totem --help`, then press Return.

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Start Up Window

Shows &app; main window. Contains menubar, display area, time elapsed slider, seek control buttons, volume slider and statusbar.

The &app; window contains the following elements:

Menubar.

  The menus on the menubar contain all of the commands you need to use in &app;.

Display area.

  The display area displays movie or visualisation of song.

Time elapsed slider.

  The time elapsed slider displays the elapsed time of movie or song that is playing. It also enables you to skip forward or backward a movie or song.

Seek control buttons.

  The seek control buttons enables you to move to next or previous track, to pause or play a movie or song.

Volume slider.

  The volume slider enables you to adjust volume.

Statusbar.

  The statusbar displays status information about movie or song that is playing.

## Usage

### To Open a File

To open a video or an audio file, choose Ctrl O Movie Open . The Select files dialog is displayed. Select the file you want to open, then click OK.

You can drag a file from another application such as a file manager to the &app; window. The &app; application will open the file and play the movie or song. &app; displays the title of the movie or song beneath the display area and in the titlebar of the window.

If you try to open a file format that &app; does not recognize, the application displays an error message.

You can double-click on a video or an audio file in the Nautilus file manager to open it on the &app; window.

### To Open a Location

To open a file by URI location, choose Ctrl L Movie Open Location . The Open from URI dialog is displayed. Use the drop-down combination box to specify the URI location of file you would like to open, then click on the Open button.

### To Play a DVD, VCD or CD

To play a DVD

  Insert the DVD in the DVD device of your computer, then choose Movie Play DVD .

To play a VCD

  Insert the VCD in the VCD device of your computer, then choose Movie Play VCD .

To play a CD

  Insert the CD in the CD device of your computer, then choose Movie Play CD .

### To Eject a DVD, VCD or CD

To eject a DVD, VCD, or CD, choose Ctrl E Movie Eject .

### To Pause a Movie or Song

To pause a movie or song that is playing, click on the Shows pause button. button, or choose P Movie Play / Pause . When you pause a movie or song, the statusbar displays Paused and the time elapsed on the current movie or song stops.

To resume playing a movie or song, click on the Shows play button. button, or choose P Movie Play / Pause .

### To View Properties of a Movie or Song

To view properties of a movie or song, choose Movie Properties . The Properties dialog is displayed. The dialog contains the following information:

General

  Title, artist, year and duration of movie or song.

Video

  Video dimensions, codec and framerate.

Audio

  Audio bitrate and codec.

### To Seek Through Movies or Songs

To seek through movies or songs, you can use the following methods:

To skip forward

  To skip forward a movie or song, choose Right Go Skip Forward .

To skip backward

  To skip backward a movie or song, choose Left Go Skip Backward .

To skip to time

  To skip to a specific elapsed time, choose S Go Skip to . The Skip to dialog is displayed. Use the spin box to specify the elapsed time (in second) to skip to, then click OK.

To move to next movie or song

  To move to next movie or song, choose N Go Next Chapter/Movie or click on the Shows a seek next button button.

To move to previous movie or song

  To move to previous movie or song, choose B Go Previous Chapter/Movie , or click on the Shows a seek previous button button.

### To Change the Zoom Factor

To change the zoom factor of display area, you can use the following methods:

- To zoom to full screen mode, choose F View Fullscreen . To exit fullscreen mode, click on the Exit Fullscreen button or press Esc.

- To zoom to half size (50%) of the original movie or visualisation, choose 0 View Zoom 1:2 .

- To zoom to size (100%) of the original movie or visualisation, choose 1 View Zoom 1:1 .

- To zoom to double size (200%) of the original movie or visualisation, choose 2 View Zoom 2:1 .

- To switch between different aspect ratios, choose A View Toggle Aspect Ratio . The supported aspect ratios are:

  - Automatic Aspect

  - Square Aspect (1:1)

  - 4:3 Aspect (4:3)

  - Anamorphic Aspect (16:9)

  - DVB Aspect (2.11:1)

  The default aspect ratio is Automatic Aspect.

### To Adjust the Volume

To increase the volume, choose Up Sound Volume Up or move the volume slider to the right. To decrease the volume, choose Down Sound Volume Down or move the volume slider to the left.

To turn the volume down to minimum, click on the Shows a mute button button. To turn the volume up to maximum, click on the Shows a maximum volume button button.

### To Make Window Always On Top

To make the &app; window always on top of other application windows, choose View Always on Top .

### To Show or Hide Controls

To hide the &app; window controls, choose H View Show Controls to unselect the Show Controls option. To show the controls on the &app; window, right-click on the window, then choose H Show Controls from the popup menu.

If the Show Controls option is selected, &app; will show the menubar, time elapsed slider, seek control buttons, volume slider and statusbar on the window. If the Show Controls option is unselected, the application will hide these controls and show only display area.

### To Manage Playlist

#### To Show or Hide Playlist

To show playlist, choose View Show/Hide Playlist , or click on the Shows a show/hide playlist button button. The Playlist dialog is displayed. To hide Playlist, choose View Show/Hide Playlist or click on the Shows a show/hide playlist button button again.

#### Manage a PlayList

You can use the Playlist dialog to do the following:

To add a track or movie

  To add a track or movie to the playlist, click on the Add button. The Select files dialog is displayed. Select the file that you want to add to playlist, then click OK.

To remove a track or movie

  To remove track or movie from the playlist, select the filenames from the filename list box, then click on the Remove button.

To save playlist to file

  To save playlist to file, click on the Save button. The Save playlist dialog is displayed, specify the filename that you want to save the playlist.

To move track or movie up the playlist

  To move track or movie up the playlist, select the filenames from the filename list box, then click on the Up button.

To move track or movie down the playlist

  To move track or movie down the playlist, select the filenames from the filename list box, then click on the Down button.

To set repeat mode

  Select the Repeat mode option to play the movies or songs repeatedly.

To set shuffle mode

  Select the Shuffle mode option to play the movies or songs randomly.

#### To Select or Unselect Repeat Mode

To select or unselect repeat mode, choose View Repeat Mode , or use the Repeat mode option from the Playlist dialog.

#### To Select or Unselect Shuffle Mode

To select or unselect shuffle mode, choose View Shuffle Mode , or use the Shuffle mode option from the Playlist dialog.

### To Take Screenshot

To take screenshot of movie or visualisation of song that is playing, choose Edit Take Screenshot . The Save Screenshot dialog is displayed, click the Save button to save the screenshot.

You can save a screenshot to

- File: select the Save screenshot to file option, then click on the Browse button to specify a file to save the screenshot.

- The desktop: select the Save screenshot to the desktop option.

### To Quit &app;

To quit &app;, choose Ctrl Q Movie Quit .

## Preferences

To modify the preferences of &app;, choose Edit Preferences . The Preferences dialog contains the following tabbed sections:

### General

Optical Device

  Select optical device from the Optical device path drop-down list box.

Networking

  Select network connection speed from the Connection speed drop-down list box.

TV-Out

  - No TV-out: select this option if you have no TV-out connection.

  - TV-out mode: select this option if you want normal TV-out connection.

  - DXR3 TV-out: select this option if you want a DXR3 TV-out connection.

Proprietary Plugins

  You can add proprietary plugins to handle additional movie or audio files. To add proprietary plugins to &app;, click on the Add Proprietary Plugins button.

### Display

Display

  Select the resize option if you want &app; to automatically resize the window when a new video is loaded.

Visual Effects

  - visual: select this option to show visual effects while an audio file is playing.

  - Type of visualisation: select type of visualisation from the drop-down list box.

  - Visualisation size: select visualisation size from the drop-down list box.

Brightness/Contrast

  - Brightness: use the slider to specify the level of brightness.

  - Contrast: use the slider to specify the level of contrast.

### Audio

Audio Output

  Select audio output type from the Audio output type drop-down list.

## About &app;

&app; is written by Bastien Nocera (hadess@hadess.net), Julien Moutte (julien@moutte.net) for GStreamer backend, and Guenter Bartsch (guenter@users.sourceforge.net). To find more information about &app;, please visit the &app; Home Page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.