---
name: "gqmpeg"
section: "1"
platform: "linux"
package: "gqmpeg"
version: "0.90.0-2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/gqmpeg"
---

# gqmpeg(1)

A frontend to mpg123.

## 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)](/mpg123/1.md), [ogg123(1)](/ogg123/1.md), [xmp(1)](/xmp/1.md), [v4l(4)](/v4l/4.md)**

## 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.**