# Totem Movie Player Manual

2003
Chee Bin HOH
2007
David Lodge (dave@cirt.net)

Totem Movie Player is a movie player for the GNOME desktop

GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the license.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORISED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

Chee Bin
HOH
GNOME Documentation Project

     cbhoh@gnome.org

Baptiste
Mille-Mathias
GNOME Documentation project

     baptiste.millemathias@gmail.org

Update documentation
Totem Movie Player Manual V2.0
August 2006

Chee Bin HOH cbhoh@gnome.org

GNOME Documentation Project

This manual describes version 1.6.0 of Totem Movie Player.

## Feedback

To report a bug or make a suggestion regarding the Totem Movie Player application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

The Totem Movie Player application is a movie player for the GNOME desktop based on Gstreamer framework and xine library, it enables you to play movies or songs.

Totem Movie Player 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.

Totem Movie Player also comes with additional functionalities such as:

- Video thumbnailer for GNOME.

- Nautilus properties tab.

## Getting Started

### To Start Totem Movie Player

You can start Totem Movie Player in the following ways:

Applications menu

  Choose Multimedia Totem Movie Player.

Command line

  To start Totem Movie Player 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 Totem Movie Player

When you start Totem Movie Player, the following window is displayed.

#### Totem Movie Player Start Up Window

Shows Totem Movie Player main window with sidebar opened on playlist. Contains menubar, display area, sidebar, time elapsed slider, seek control buttons, volume slider and statusbar.

The Totem Movie Player window contains the following elements:

Menubar.

  The menus on the menubar contain all of the commands you need to use in Totem Movie Player.

Display area.

  The display area displays movie or visualisation of song.

Sidebar.

  The sidebar displays properties of file played and acts as playlist.

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 Movies or Playlists dialogue is displayed. Select the file(s) you want to open, then click OK.

You can drag a file from another application such as a file manager to the Totem Movie Player window. The Totem Movie Player application will open the file and play the movie or song. Totem Movie Player 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 Totem Movie Player does not recognise, 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 Totem Movie Player window.

### To Open a Location

To open a file by URI location, choose Ctrl L Movie Open Location. The Open from URI dialogue 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 Movie (DVD, VCD or CD)

Insert the disc in your computer's optical drive, then choose Movie Play Disc.

### 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 View Sidebar to make the sidebar appear, and choose Properties in the grop-down list.

The dialogue 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 dialogue 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 Video Size

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 Leave Fullscreen button or press Esc or F.

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

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

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

#### To Change the Video Aspect Ratio

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

- Auto

- Square

- 4:3 (TV)

- 16:9 (Widescreen)

- 2.11:1 (DVB)

The default aspect ratio is Auto.

### 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 adjust the sound volume, you can also use the volume button. Press the volume button and choose the volume level with the slider.

### To Make Window Always On Top

To make the Totem Movie Player window always on top of other application windows, choose View Always on Top.

### To Show or Hide Controls

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

If the Show Controls option is selected, Totem Movie Player 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 Sidebar, or click the Sidebar button, and choose Playlist on the top of the sidebar. The Playlist dialogue is displayed.

To hide Playlist, choose View Sidebar or click on the Sidebar button again.

#### Manage a PlayList

You can use the Playlist dialogue 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 dialogue 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 dialogue 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 Select or Unselect Repeat Mode

To enable or disable repeat mode, choose Edit Repeat Mode.

#### To Select or Unselect Shuffle Mode

To enable or disable shuffle mode, choose Edit Shuffle Mode.

### To Choose Subtitle

To choose the language of the subtitles, select View Subtitles and choose the subtitles language you want to display.

To disable the display of subtitles, select View Subtitles None.

By default, Totem Movie Player will choose the same language for the subtitles that the one you use on your computer.

Totem Movie Player will automatically load and display subtitles if the file which content them has the same name than the video file played and the extention `asc`, `txt`, `sub`, `smi`, or `ssa`.

### To Take Screenshot

To take screenshot of movie or visualisation of song that is playing, choose Edit Take Screenshot. The Save Screenshot dialogue 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.

## Preferences

To modify the preferences of Totem Movie Player, choose Edit Preferences. The Preferences dialogue contains the following tabbed sections:

### General

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 (Selected by default if you don't have an TV-out interface).

  - TV-out in fullscreen by Nvidia (NTSC): select this option if you want TV-out connection in NTSC.

  - TV-out in fullscreen by Nvidia (PAL): select this option if you want TV-out connection in PAL.

Text Subtitles

  - Font: select this option to change the font used to display subtitles.

  - Encoding: select this option to the encoding used to display subtitles.

### Display

Display

  Select the resize option if you want Totem Movie Player 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.

Colour balance

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

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

  - Saturation: use the slider to specify the level of saturation.

  - Hue: use the slider to specify the level of hue.

### Audio

Audio Output

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

## About Totem Movie Player

Totem Movie Player 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 Totem Movie Player, please visit the Totem Movie Player 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 licence as published by the Free Software Foundation; either version 2 of the Licence, or (at your option) any later version. A copy of this licence can be found at this link, or in the file COPYING included with the source code of this program.