GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GST123 (1)

NAME

gst123 - A GStreamer based command line media player

CONTENTS

Synopsis
Description
Options
Interrupt
Keyboard Input
Configuration File
Audio Drivers
See Also

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.
-k <n>, --skip <n>
  Skip the first ’n’ seconds of each file.
-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 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 <http://space.twc.de/~stefan/gst123.php>)

Search for    or go to Top of page |  Section 1 |  Main Index


Revision 921 GST123 (1) 2013-04-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.