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.
  • -v, --version
    Prints out gst123 version.
  • -z, --shuffle
    Play files in pseudo random order.
  • -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). For instance using gst123 -a oss ... would use the oss driver, and gst123 -a alsa=hw:1 ... would use the alsa driver with the alsa device hw:1. For JACK support, use -a jack (device is not supported in this case).
  • --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.

KEYBOARD INPUT

  • 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.
  • m
    Toggle mute/unmute.
  • f
    Toggle fullscreen display (only for videos).
  • 1
    Normal video size (only for videos).
  • 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 (which may be oss, alsa or jack) and the default audio device (which may be something like /dev/dsp1 for the oss driver or an alsa device like hw:1 for the alsa driver), and 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.

SEE ALSO