NAME¶
gst123 - A GStreamer based command line media player
SYNOPSIS¶
gst123 [
OPTIONS] [
URIS...]
DESCRIPTION¶
gst123 is a command line based media player released as free software
under the GNU LGPL.
OPTIONS¶
gst123 follows the usual GNU command line syntax, with long options
starting with two dashes ('-').
- -h, --help
- Shows a brief help message.
- --version
- Prints out gst123 version.
- --full-version
- Prints out gst123 version and version of libraries used by
gst123.
- -r, --repeat
- Repeat playlist forever.
- -z, --shuffle
- Shuffle playlist before playing.
- -Z, --random
- Play files in random order forever.
- -x, --novideo
- Do not play the video stream.
- -@ <playlist>, --list
<playlist>
- Load files to play from the playlist file.
- -a, --audio-output
<driver>[=<device>]
- Set audio output driver (and device). See section audio
drivers for details.
- -v, --visualization
<plugin_name>
- Use a plugin for visualization during audio playback.
- -V, --visualization-list
- Show a list of available audio visualization plugins which
can be used with the -v option.
- -q, --quiet
- Don't display any messages (title, codec, ui
feedback).
- --verbose
- Print GStreamer pipeline used to play files
Besides filenames, playlist entries or command line args can be directories. In
this case,
gst123 recursively searches the directory and plays all
files contained in it.
INTERRUPT¶
You can abort
gst123 at any time by pressing Ctrl-C. If you are playing
multiple files, this will stop the current file and begin playing the next
one. If you want to abort playing immediately instead of skipping to the next
file, press Ctrl-C within the first second of the playback of a new file.
- cursor left/right
- Seek 10 seconds backwards/forwards.
- cursor down/up
- Seek 1 minute backwards/forwards.
- page down/up
- Seek 10 minute backwards/forwards.
- space
- Toggle pause.
- +/-
- Increase/decrease volume by 10%.
- m
- Toggle mute/unmute.
- f
- Toggle fullscreen display (only for videos).
- 1
- Normal video size (only for videos).
- n
- Play next file.
- q
- Quit gst123.
- ?
- Show keyboard help.
CONFIGURATION FILE¶
During start, gst123 will read ~/.gst123rc, if this file exists. Empty lines and
lines starting with a # are ignored. The following commands are available:
- audio_output
<driver>[=<device>]
- This sets the default audio driver and the default audio
device. It has the same effect as the -a / --audio-output command line
option. When both are present, a config file entry and the command line
option, the value from the command line option will be used. Read the
section on audio drivers for details on the available drivers and
syntax.
- visualization
<visualization_plugin>
- Set default visualization plugin for audio files. This
setting has the same effect as the -v / --visualization command line
option. When both are present, the value from the command line option will
be used.
AUDIO DRIVERS¶
- alsa=[<device>]
- The ALSA driver; when used without argument (as in -a
alsa), the ALSA driver uses the default device. To select an ALSA device,
its possible to use for example alsa=hw:1 (which will use the hw:1 ALSA
device).
- jack
- The JACK driver. Device selection is not supported in this
case.
- none
- Dummy output driver, will not output any audio.
- oss=[<device>]
- The OSS driver; when used without argument (as in -a oss),
the OSS driver uses the default device. The device can be specified using
for example oss=/dev/dsp1 (which would use the OSS device /dev/dsp1).
SEE ALSO¶
gst123 Website (
http://space.twc.de/~stefan/gst123.php
<
http://space.twc.de/~stefan/gst123.php>)