gst123(1)

1GST123(1)                     gst123 Manual Page                     GST123(1)
2
3
4

NAME

6       gst123 - A GStreamer based command line media player
7
8

SYNOPSIS

10       gst123 [OPTIONS] [URIS...]
11
12

DESCRIPTION

14       gst123  is  a command line based media player released as free software
15       under the GNU LGPL.
16
17

OPTIONS

19       gst123 follows the usual GNU command line  syntax,  with  long  options
20       starting with two dashes ('-').
21
22       -h, --help
23              Shows a brief help message.
24
25       --version
26              Prints out gst123 version.
27
28       --full-version
29              Prints  out  gst123  version  and  version  of libraries used by
30              gst123.
31
32       -r, --repeat
33              Repeat playlist forever.
34
35       -z, --shuffle
36              Shuffle playlist before playing.
37
38       -Z, --random
39              Play files in random order forever.
40
41       -x, --novideo
42              Do not play the video stream.
43
44       -f, --fullscreen
45              Use fullscreen video output.
46
47       -@ <playlist>, --list <playlist>
48              Load files to play from the playlist file.
49
50       -a, --audio-output <driver>[=<device>]
51              Set audio output driver (and device). See section audio  drivers
52              for details.
53
54       -v, --visualization <plugin_name>
55              Use a plugin for visualization during audio playback.
56
57       -V, --visualization-list
58              Show  a  list of available audio visualization plugins which can
59              be used with the -v option.
60
61       -k <n>, --skip <n>
62              Skip the first 'n' seconds of each file.
63
64       --volume <volume>
65              Set initial replay volume (in percent).
66
67       -s, --subtitle <subtitle_file>
68              Set subtitle file to use for video playback.
69
70       -q, --quiet
71              Don't display any messages (title, codec, ui feedback).
72
73       --verbose
74              Print GStreamer pipeline used to play files
75
76       Besides filenames, playlist entries or command line args can be  direc‐
77       tories.  In  this  case,  gst123 recursively searches the directory and
78       plays all files contained in it.
79
80

INTERRUPT

82       You can abort gst123 at any time by pressing Ctrl-C. If you are playing
83       multiple  files,  this will stop the current file and begin playing the
84       next one. If you want to abort playing immediately instead of  skipping
85       to  the next file, press Ctrl-C within the first second of the playback
86       of a new file.
87
88

KEYBOARD INPUT

90       cursor left/right
91              Seek 10 seconds backwards/forwards.
92
93       cursor down/up
94              Seek 1 minute backwards/forwards.
95
96       page down/up
97              Seek 10 minute backwards/forwards.
98
99       space  Toggle pause.
100
101       +/-    Increase/decrease volume by 10%.
102
103       m      Toggle mute/unmute.
104
105       f      Toggle fullscreen display (only for videos).
106
107       1      Normal video size (only for videos).
108
109       A/a    Increase/decrease opacity by 10% (only for videos).
110
111       s      Toggle subtitles (only for videos).
112
113       n      Play next file.
114
115       q      Quit gst123.
116
117       ?      Show keyboard help.
118

CONFIGURATION FILE

120       During start, gst123 will read ~/.gst123rc, if this file exists.  Empty
121       lines  and  lines starting with a # are ignored. The following commands
122       are available:
123
124       audio_output <driver>[=<device>]
125              This sets the default audio driver and the default audio device.
126              It  has  the same effect as the -a / --audio-output command line
127              option. When both are present, a config file entry and the  com‐
128              mand line option, the value from the command line option will be
129              used. Read the section on  audio  drivers  for  details  on  the
130              available drivers and syntax.
131
132       visualization <visualization_plugin>
133              Set  default  visualization plugin for audio files. This setting
134              has the same effect as the -v  /  --visualization  command  line
135              option.  When  both are present, the value from the command line
136              option will be used.
137

AUDIO DRIVERS

139       alsa=[<device>]
140              The ALSA driver; when used without argument (as in -a alsa), the
141              ALSA  driver  uses the default device. To select an ALSA device,
142              its possible to use for example alsa=hw:1 (which  will  use  the
143              hw:1 ALSA device).
144
145       oss=[<device>]
146              The  OSS  driver; when used without argument (as in -a oss), the
147              OSS driver uses the default device. The device can be  specified
148              using  for example oss=/dev/dsp1 (which would use the OSS device
149              /dev/dsp1).
150
151       pulse=[<device>]
152              The PulseAudio driver. This driver optionally accepts  a  device
153              name using the pulse=<device> syntax.
154
155       jack   The JACK driver. Device selection is not supported in this case.
156
157       none   Dummy output driver, will not output any audio.
158