This is an old revision of the document!


Command-line Options

The general usage of the command line options is:

parole [OPTION...] [FILES...]

Here is a summary of all the options, grouped by type. Explanations are in the following sections.

Help Options
-h, –help; –help-all; –help-gst; –help-gtk

Application Options
-i, –new-instance; -n, –no-plugins; -d, –device; –xv; -E, –embedded; -F, –fullscreen; -p, –play; -N, –next; -P, –previous; -r, –volume-up; -l, –volume-down; -m, –mute; -u, –unmute; -a, –add; -V, –version; –display=DISPLAY

Help Options

-h, –help
List the various command line options supported by Parole and exit

–help-all
List all command line options supported by Parole and exit

–help-gst
List all GStreamer multimedia framework options supported by Parole and exit

–help-gtk
List all GTK+ platform options supported by Parole and exit

Application Options

-i, –new-instance
Opens a new instance of Parole

-n, –no-plugins
Starts Parole without loading its plugins

-d, –device
Sets the Audio-CD/VCD/DVD device path

–xv
Enables/Disables the X video extension for the X Window System (true or false, default=true)

-E, –embedded
Starts Parole in embedded mode

-F, –fullscreen
Starts Parole in fullscreen mode

-p, –play
Plays, or pauses Parole if already playing

-N, –next
Plays the next track

-P, –previous
Plays the previous track

-r, –volume-up
Raises the volume of Parole's output audio

-l, –volume-down
Lowers the volume of Parole's output audio

-m, –mute
Mutes the volume of Parole's output audio

-u, –unmute
Unmutes (restores) the volume of Parole's output audio

-a, –add
Add files to Parole's playlist

-V, –version
Prints Parole's version information and exit

–display=DISPLAY
Default X display to use

GStreamer Options

–gst-version
Prints the GStreamer Core Library version and exit

–gst-fatal-warnings
Make all warnings fatal

–gst-debug-help
Prints the available debug categories and exit

–gst-debug-level=LEVEL
Default debug level from 1 (only error) to 5 (anything) or 0 for no output

–gst-debug=LIST
Comma-separated list of category_name:level pairs to set specific levels for the individual categories. Example:

GST_AUTOPLUG:5,GST_ELEMENT_*:3

–gst-debug-no-color
Disables colored debugging output

–gst-debug-color-mode
Changes coloring mode of the debug log. Possible modes: off, on, disable, auto, unix

–gst-debug-disable
Disables debugging

–gst-plugin-spew
Enables verbose plugin loading diagnostics

–gst-plugin-path=PATHS
Colon-separated paths containing plugins

–gst-plugin-load=PLUGINS
Comma-separated list of plugins to preload in addition to the list stored in environment variable GST_PLUGIN_PATH

–gst-disable-segtrap
Disables trapping of segmentation faults during plugin loading

–gst-disable-registry-update
Disables updating the registry

–gst-disable-registry-fork
Disables spawning a helper process while scanning the registry

GTK+ Options

–class=CLASS
Program class as used by the window manager

–name=NAME
Program name as used by the window manager

–gdk-debug=FLAGS
GDK debugging flags to set

–gdk-no-debug=FLAGS
GDK debugging flags to unset

–gtk-module=MODULES
Loads additional GTK+ modules

–g-fatal-warnings
Make all warnings fatal

–gtk-debug=FLAGS
GTK+ debugging flags to set

–gtk-no-debug=FLAGS
GTK+ debugging flags to unset