GST123(1)							gst123 Manual Page							 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

       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.

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

       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  com-
       mands 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>)

Revision 716							    2012-04-20								 GST123(1)