.\" 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
.TH totem 1 "2022\-06\-20" "GNOME"
.SH NAME
GNOME Videos \- Movie player
.SH SYNOPSIS
.B totem
.RI [ option... ] " " [ filenames | URI ]
.SH DESCRIPTION
.B Videos
is a movie player for the GNOME desktop.  Through use of the
.B GStreamer
backend many popular file and streaming formats are supported including:
H.264 (AVC) and H.265 (HEVC) MPEG-4, WebM and AV1, MPEG-2 and MPEG-1, as well
as legacy videos types: Ogg, AVI, ASF, MOV, WMV, QuickTime, and more.
Playback of DVDs is also possible.
.P
For additional documentation on interactive use of 
.B Videos
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
The following options command an already-running instance of
.B Videos
to do something; they are useful for remote-control scripting. If 
.B Videos
is not already running, these commands will launch a new instance of
.B Videos
but will not do anything further.
.TP
.B --play-pause
Tell an already-running instance of 
.B Videos
to toggle between play and pause.
.TP
.B --play
Tell an already-running instance of
.B Videos
to play (has no effect if already playing)
.TP
.B --pause
Tell an already-running instance of
.B Videos
to pause (has no effect if already paused)
.TP
.B --next
Tell an already-running instance of 
.B Videos
to skip to the next movie or chapter in the playlist.
.TP
.B --previous
Tell an already-running instance of 
.B Videos
to return to the previous movie or chapter in the playlist.
.TP
.B --seek-fwd
Tell an already-running instance of 
.B Videos
to seek forwards 15 seconds in the current movie.
.TP
.B --seek-bwd
Tell an already-running instance of 
.B Videos
to seek backwards 15 seconds in the current movie.
.TP
.B --volume-up
Tell an already-running instance of 
.B Videos
to raise the volume by 8%.
.TP
.B --volume-down
Tell an already-running instance of 
.B Videos
to lower the volume by 8%.
.TP
.B --mute
Tell an already-running instance of 
.B Videos
to toggle between muted and unmuted audio.
.TP
.B --fullscreen
Tell an already-running instance of 
.B Videos
to toggle fullscreen mode.
.TP
.B --quit
Tell an already-running instance of
.B Videos
to quit.
.TP
.BI "--enqueue " filename|URI
Tell an already-running instance of
.B Videos
to add a new stream to the playlist.
.TP
.BI "--replace " filename|URI
Tell an already-running instance of
.B Videos
to play from the playlist.
.SH KEYBINDINGS
Information about keybindings is available once the application
is started by typing
.B Ctrl+Question Mark
which might require pressing Shift in some keyboard configurations.
.TP
.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
.SH BUGS
.B Videos
cannot play files using some proprietary codecs.
.SH AUTHOR
.B Videos
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 Videos may be downloaded from
.UR https://flathub.org/apps/details/org.gnome.Totem
<https://flathub.org/apps/details/org.gnome.Totem>
.UE
.SH SEE ALSO
.BR "totem-video-thumbnailer" (1),
.P
The online documentation available through the program's
.I Help
menu.