---
name: "xmms2-launcher"
section: "1"
platform: "linux"
package: "xmms2"
version: "0.9.7-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xmms2-launcher"
---

# xmms2-launcher(1)

XMMS2 daemon launcher

## NAME

xmms2-launcher - XMMS2 daemon launcher

## SYNOPSIS

**xmms2-launcher** \[**-l** *file*\] \[**-P** *file*\] \[**-v**\] \[**--**\] \[*XMMS2D\_OPTION*\] ...\
 **xmms2-launcher -h**

## DESCRIPTION

XMMS2 is a redesign of the XMMS (https://en.wikipedia.org/wiki/XMMS) music player. It features a client-server model, allowing multiple (even simultaneous!) user interfaces, both textual and graphical. All common audio formats are supported using plugins. On top of this, there is a flexible media library to organise your music.

**xmms2-launcher** starts [**xmms2d**(1)](/xmms2d/1.md) in the background. The main feature is that it does not exit until the IPC system of XMMS2 is available, meaning that as soon as the **xmms2-launcher** process has exited successfully [**xmms2d**(1)](/xmms2d/1.md) is ready to accept commands.

## OPTIONS

Unrecognized options and options occuring beyond pseudo-option **--** are passed to [**xmms2d**(1)](/xmms2d/1.md).

- **-l** *file***, --logfile=***file*

  Write log to *file* instead of the default log file location.

- **-P** *file***, --pidfile=***file*

  Write the pid of [**xmms2d**(1)](/xmms2d/1.md) to *file*.

- **-v, --verbose**

  Make xmms2-launcher verbose.

- **-?, -h, --help**

  Show short help information and exit.

- **--**

  Options beyond this marker are passed to [**xmms2d**(1)](/xmms2d/1.md).

- *XMMS2D\_OPTION*

  See [**xmms2d**(1)](/xmms2d/1.md) for a list of options and their effect.

## FILES

Below *CACHEDIR* is *$XDG\_CACHE\_HOME/xmms2* on UNIX if the **XDG\_CACHE\_HOME**-environment variable is set. Otherwise it is *$HOME/.cache/xmms2* (UNIX except Darwin), or *$HOME/Library/xmms2/logs* (Darwin).

- *CACHEDIR/xmms2d.log*

  The default location for storing log output of [**xmms2d**(1)](/xmms2d/1.md).

## ENVIRONMENT

- **XDG\_CACHE\_HOME**

  The location where the XMMS2 logs are located by default.

## SEE ALSO

[**xmms2d**(1)](/xmms2d/1.md), **https://github.com/xmms2**.

## HISTORY

The XMMS2 Project was started by Tobias Rundström and Anders Waldenborg. It is developed by a small group of contributers from all over the world.

## AUTHOR

This manual page was written by Alexander Botero-Lowry \<alex@foxybanana.com\>. It was reformatted by Erik Massop \<e.massop@hccnet.nl\>.