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

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

       +/-
	   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
	   driver uses the default device. The device can be specified using
	   for example oss=/dev/dsp1 (which would use the OSS device
	   /dev/dsp1).

       pulse=<device>
	   The PulseAudio driver. This driver optionally accepts a device name
	   using 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.0>

home | help