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.

SEE ALSO
mpg123(1), ogg123(1), xmp(1), v4l(4)

AUTHORS

Main Author
    John Ellis <johne@verizon.net>

See README for full credits.

HomePage:
    http://gqmpeg.sourceforge.net

Please send feedback to gqview@users.sourceforge.net or the author, above.