XMMS2-LAUNCHER(1)

💅 XMMS2-LAUNCHER 💅

okay so this is the xmms2-launcher page from the General Commands Manual — yes that's the manual section, we're fancy like that — and it's literally the lil matchmaker that gets xmms2d up and running for you. stay with me bestie, it's cute and it's short.

---

✨ NAME ✨

xmms2-launcher — the XMMS2 daemon launcher. that's it, that's the job. it launches the daemon. icon behavior honestly. 👑

---

🌸 SYNOPSIS 🌸

xmms2-launcher [-l file] [-P file] [-v] [--] [XMMS2D_OPTION] ...
xmms2-launcher -h

like, two modes: launch it with vibes and options, or just ask for -h help. pick your main character moment. 🦋

---

💖 DESCRIPTION 💖

XMMS2 is a glow-up of the XMMS music player (yes, the one at https://en.wikipedia.org/wiki/XMMS). it's got a client-server model, which is the whole slay — it lets you run multiple user interfaces at the same time, and they can be textual or graphical, your choice, no gatekeeping. 💅 all the common audio formats are supported using plugins, and on top of that there's a flexible media library to organise your music. it's giving organized.

so what does xmms2-launcher actually do? it starts xmms2d(1) in the background. and here's the iconic part: it does not exit until the IPC system of XMMS2 is available. so the second the xmms2-launcher process has exited successfully, you know xmms2d(1) is ready to accept commands. no guessing, no "is it up yet", no refreshing like a maniac. it's a built-in vibe check. ✅

---

🎀 OPTIONS 🎀

heads up bestie: unrecognized options, and any options that show up beyond the pseudo-option --, get passed straight to xmms2d(1). so if something isn't listed here, it's not lost, it's just going to the daemon. 🫶

• -l file, --logfile=file — write the log to file instead of the default log file location. keep your receipts somewhere specific. 📝
• -P file, --pidfile=file — write the pid of xmms2d(1) to file. so you always know who's running the show. 👑
• -v, --verbose — make xmms2-launcher verbose. it will talk. a lot. we love a chatty icon. 💬
• -?, -h, --help — show short help information and exit. yes, -? is real, it's quirky like that. 🙈
• -- — the pseudo-option marker; anything beyond this gets passed to xmms2d(1). it's the "everything after this line is not my business" line. 🚧
• XMMS2D_OPTION — see xmms2d(1) for a list of options and their effect. go read that one, fr fr. 📖

---

🦋 FILES 🦋

okay so first, what even is CACHEDIR? let me break it down:

• on UNIX, if the XDG_CACHE_HOME environment variable is set, CACHEDIR is $XDG_CACHE_HOME/xmms2.
• otherwise it's $HOME/.cache/xmms2 — that's UNIX except Darwin.
• on Darwin it's $HOME/Library/xmms2/logs.

cool? cool. now the file:

• CACHEDIR/xmms2d.log — the default location for storing log output of xmms2d(1). that's where the lore lives. 📚

---

🌈 ENVIRONMENT 🌈

• XDG_CACHE_HOME — the location where the XMMS2 logs are located by default. set it, and CACHEDIR follows you there. ✨

---

🔥 SEE ALSO 🔥

xmms2d(1), and https://github.com/xmms2. go click, go read, go be informed. 💜

---

⭐ HISTORY ⭐

the XMMS2 Project was started by Tobias Rundström and Anders Waldenborg. it's developed by a small group of contributers from all over the world. small group, global reach, big slay. 🌍💫

---

🍓 AUTHOR 🍓

this manual page was written by Alexander Botero-Lowry <alex@foxybanana.com>. it was reformatted by Erik Massop <e.massop@hccnet.nl>. credit where credit is due, always. 🎀

---

okay that's the whole page!! and a lil sign-off for the footer bestie: this was XMMS2-LAUNCHER(1) from the General Commands Manual — that's the source/version bit, and it's timeless, so no date needed. now go launch a daemon and be iconic 💅✨🦋