gqmpeg(1)

NAME

GQmpeg - A frontend to mpg123.

SYNOPSIS

gqmpeg [option(s)] [file(s) | ipc_command(s)]

DESCRIPTION

A frontend to mpg123 with extensive themeability and playlist support.

OPTIONS

General options:

--skin:skindir: Load skin from skindir.

--geometry [+|-]xxx[+|-]yyy: Specify window position using the format [+|-]xxx[+|-]yyy.

--dock: Enable docking behavior. Changes mouse button behavior only, disconnects middle button (button2) and disables moving of the window by dragging the mouse.

--dockwm: Enable Window Maker docking. Also applies the -dock option.

--skinhelp: Print mouse event coordinates, helpful for skin creation.

--debug: Enable debugging output.

-h, --help: Displays basic usage information.

--blank: Start up with an empty playlist.

Commands (refered to as ipc commands) are also available that allow the control of another GQmpeg process, ipc must be enabled in the programs options. If GQmpeg is not running and ipc commands are used, a new process is spawned for these commands to control. These are the available ipc options:

-p, --play: Starts playback, if already playing works like pause.

-s, --stop: Stop playback.

-n, --next: Skips to the next song in the playlist.

-b, --back: Skips to the previous song in the playlist.

-ps, --pause: If playingm toggles pause of playback.

-pladd, --playlist_add file [...]: Add file(s) to the current playlist.

-pladdplay, --playlist_add_play file: Add file to the current playlist and play it.

-plrm, --playlist_remove file [...]: Remove file(s) from the current playlist, if present.

-plclr, --playlist_clear: Clear the current playlist.

-pl, --playlist file: Load playlist file.

-plappend, --playlist_append file [...]: Append file(s) to the current playlist.

-f, --file file: Play file but do not add to the current playlist, or if file is a playlist, load it as the current playlist.

-q, --quit: Tell a running GQmpeg to quit.

FILES

Files in home directories:

.gqmpeg/gqmpegrc: The main configuration file, all options are saved here.

.gqmpeg/session-playlist.gqmpeg: On application exit, the current playlist is saved to this file. Then depending on start up options, read upon application start.

.gqmpeg/playlists: Default location for playlist files.

.gqmpeg/skins: Default location for skins.

.gqmpeg/command: A FIFO file that commands can be sent to (for example, with echo), to control the currently running process. Example commands are play, pause, stop, next, prev, quit, play_file <filename>, etc. See README for more details.

.gqmpeg/command.pid: Contains the current PID of the gqmpeg process (if any) that is listening for ipc commands.

AUTHORS

Main Author: John Ellis <[email protected]>

See README for full credits.

HomePage:: http://gqmpeg.sourceforge.net

Please send feedback to [email protected] or the author, above.