totem.1 5.42 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
.\" Copyright (C) 2004 Andre Lehovich <andrel@u.arizona.edu>
.\"
.\" This is free software; you may redistribute it and/or modify
.\" it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2,
.\" or (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License 
.\" along with this; if not write to the Free Software Foundation, Inc.
.\" 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
16
.TH totem 1 "2008\-08\-25" "GNOME"
17
.SH NAME
18
Totem \- GNOME desktop movie player based on GStreamer
19 20 21 22
.SH SYNOPSIS
.B totem
.RI [ option... ] " " [ filenames | URI ]
.SH DESCRIPTION
23
.B Totem
24
is a movie player for the GNOME desktop.  Through use of the
25
.B GStreamer
26
backend many popular file and streaming formats are supported including:
27
MPEG audio and video (MP3/MPV), Ogg, AVI, ASF, MOV, WMV,
28 29
QuickTime, and more.  Playing of DVD and VCD media is
also possible.
30
Although primarily intended as a movie player,
31
.B Totem
32 33 34
can also play many audio formats.
.P
For additional documentation on interactive use of 
35
.B Totem
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
select the
.I Help
menu option.  The menus allow access to some features not
available through keybindings or command-line options.
.SH OPTIONS
.TP
.B \-?, --help
Output a longer help message then quit.  (Any discrepancies
between this man page and the output of
.B totem --help
should be reported as a documentation bug.)
.TP
.B --version
Output version information then quit.
.P
51 52
The following options command an already-running instance of
.B Totem
53 54 55 56 57
to do something; they are useful for remote-control scripting. If 
.B Totem
is not already running, these commands will launch a new instance of
.B Totem
but will not do anything further.
58 59
.TP
.B --play-pause
60 61
Tell an already-running instance of 
.B Totem
62 63
to toggle between play and pause.
.TP
Bastien Nocera's avatar
Bastien Nocera committed
64
.B --play
65 66
Tell an already-running instance of
.B Totem
Bastien Nocera's avatar
Bastien Nocera committed
67 68 69
to play (has no effect if already playing)
.TP
.B --pause
70 71
Tell an already-running instance of
.B Totem
Bastien Nocera's avatar
Bastien Nocera committed
72 73
to pause (has no effect if already paused)
.TP
74
.B --next
75 76
Tell an already-running instance of 
.B Totem
77 78 79
to skip to the next movie or chapter in the playlist.
.TP
.B --previous
80 81
Tell an already-running instance of 
.B Totem
82 83 84
to return to the previous movie or chapter in the playlist.
.TP
.B --seek-fwd
85 86
Tell an already-running instance of 
.B Totem
87 88 89
to seek forwards 15 seconds in the current movie.
.TP
.B --seek-bwd
90 91
Tell an already-running instance of 
.B Totem
92 93 94
to seek backwards 15 seconds in the current movie.
.TP
.B --volume-up
95 96
Tell an already-running instance of 
.B Totem
97 98 99
to raise the volume by 8%.
.TP
.B --volume-down
100 101
Tell an already-running instance of 
.B Totem
102 103 104
to lower the volume by 8%.
.TP
.B --fullscreen
105 106
Tell an already-running instance of 
.B Totem
107 108
to toggle fullscreen mode.
.TP
109 110 111 112 113
.B --toggle-controls
Tell an already-running instance of
.B Totem
to toggle showing the controls.
.TP
114
.B --quit
115 116
Tell an already-running instance of
.B Totem
117 118 119
to quit.
.TP
.BI "--enqueue " filename|URI
120
Tell an already-running instance of Totem to add a new stream
121 122 123
to the playlist.
.TP
.BI "--replace " filename|URI
124
Tell an already-running instance of Totem to play 
125 126 127
from the playlist.
.SH KEYBINDINGS
Global keybindings for
128
.BR Totem :
129 130 131 132
.P
.ta \w'Down-arrow   'u	
i	toggle interlacing on and off
.br
Bastien Nocera's avatar
Bastien Nocera committed
133 134
a	cycle between aspect ratios
.br
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149
p	toggle between play and pause
.br
Esc	exit full screen mode
.br
f	toggle full screen
.br
h	toggle display of on-screen controls
.br
0	resize window to 50% original size
.br
1	resize window to 100% original size
.br
2	resize window to 200% original size
.br
.br
Bastien Nocera's avatar
Bastien Nocera committed
150 151 152 153 154 155 156 157 158 159
r	zoom in the video
.br
t	zoom out the video
.br
d	start and stop the telestrator (drawing) mode
.br
e	erase the drawing
.br
Left-arrow        skip back 15 seconds
.br
160
Right-arrow       skip forward 60 seconds
Bastien Nocera's avatar
Bastien Nocera committed
161 162 163 164 165 166 167 168 169
.br
Shift+Left-arrow  skip back 5 seconds
.br
Shift+Right-arrow skip forward 15 seconds
.br
Ctrl+Left-arrow   skip back 3 minutes
.br
Ctrl+Right arrow  skip forward 10 minutes
.br
170 171 172 173 174 175 176 177 178 179
Up-arrow	increase volume by 8%
.br
Down-arrow	decrease volume by 8%
.br
b		jump back to previous chapter/movie in playlist
.br
n		jump to next chapter/movie in playlist
.br
q		quit
.br
180
Ctrl+E          eject the playing optical media
Bastien Nocera's avatar
Bastien Nocera committed
181
.br
182
Ctrl+O		open a new file
183
.br
184
Ctrl+L		open a new URI
185
.br
186
F9		toggle display of the playlist
187 188 189 190
.br
m		show the DVD menu
.br
c		show the DVD chapter menu
191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208
.SH FILES
.I /usr/lib/totem/plugins/
.RS
The global plugins directory, which contains all the system-installed
plugins.
.RE
.I ~/.local/share/totem/plugins/
.RS
The user plugins directory, containing plugins available only to that user.
It is always in the "totem/plugins" subdirectory of your 
.B XDG_DATA_HOME
directory.
.RE
.I ~/.config/totem/state.ini
.RS
The configuration file for the main window's appearance, stored in a
simple INI format.
.RE
209
.SH BUGS
210
.B Totem
211 212
cannot play files using some proprietary codecs.
.SH AUTHOR
213
.B Totem
214 215 216 217 218
was written by Bastien Nocera <hadess@hadess.net>.
This manual page was written by Andre Lehovich for the
Debian Project.
.SH DISTRIBUTION
The latest version of Totem may be downloaded from
219 220
.UR http://projects.gnome.org/totem/
<http://projects.gnome.org/totem/>
221 222 223 224 225 226 227
.UE
.SH SEE ALSO
.BR "totem-video-thumbnailer" (1),
.P
The online documentation available through the program's
.I Help
menu.