Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GST123(1)							       GST123(1)

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
     -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.

     -f, --fullscreen
	 Use fullscreen video output.

     -@ <playlist>, --list <playlist>
	 Load files to play from the playlist file.

     -a <driver>[=<device>], --audio-output <driver>[=<device>]
	 Set audio output driver (and device). See section audio drivers for de-
	 tails.

     -v <plugin>, --visualization <plugin>
	 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.

     -k <n>, --skip <n>
	 Skip the first n seconds of each file.

     --volume <volume>
	 Set initial replay volume (in percent).

     -s <subtitle_file>, --subtitle <subtitle_file>
	 Set subtitle file to use for video playback.

     -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	directo-
     ries. 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.

     +/-
	 Increase/decrease volume by 10%.

     m
	 Toggle mute/unmute.

     f
	 Toggle fullscreen display (only for videos).

     1
	 Normal video size (only for videos).

     A/a
	 Increase/decrease opacity by 10% (only for videos).

     s
	 Toggle subtitles (only for videos).

     r
	 Toggle playback direction, forward or reverse.

     [ ]
	 Change playback rate to 10% faster/slower.

     { }
	 Change playback rate to 2x faster/slower.

     Backspace
	 Change playback rate to normal speed, 1x.

     n
	 Play next file.

     q
	 Quit gst123

     ?
	 Show keyboard help.

CONFIGURATION FILE
     During  start,  gst123  will  read ~/.config/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).

     oss=<device>
	 The OSS driver; when used without argument (as in -a oss), the OSS dri-
	 ver  uses the default device. The device can be specified using for ex-
	 ample oss=/dev/dsp1 (which would use the OSS device /dev/dsp1).

     pulse=<device>
	 The PulseAudio driver. This driver optionally accepts a device name us-
	 ing the pulse=<device> syntax.

     jack
	 The JACK driver. Device selection is not supported in this case.

     none
	 Dummy output driver, will not output any audio.

SEE ALSO
     gst123 Website (http://space.twc.de/~stefan/gst123.php)

				   08/08/2023			       GST123(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gst123&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help