WLHEADLESS(1)

💖 WLHEADLESS(1) 💖

okay so bestie, welcome to the WLHEADLESS(1) manual page. The main character is wlheadless-run, and its whole thing is literally running a Wayland client on a dedicated headless Wayland compositor. Periodt. Let’s get into it ✨

🌸 NAME 🌸

wlheadless-run — run a Wayland client on a dedicated headless Wayland compositor. No cap, that’s the gig 💅

✨ SYNOPSIS ✨

wlheadless-run [-c compositor ] [compositor option ...] -- client [client options ...]

🦋 DESCRIPTION 🦋

So here’s the vibe: wlheadless-run is used to spawn a given Wayland client on a dedicated Wayland compositor running headless. That’s it, that’s the whole main character energy 🫶

🎀 OPTIONS 🎀

There is literally one option here, and she is iconic:

• -c COMPOSITOR — use the compositor class implementation. The currently supported compositor classes are weston, kwin, mutter, gnome-kiosk, and cage. Slay 💅

🍓 FILES 🍓

• wlheadless.conf — sets the default compositor to use.

The file is searched in wlheadless directory relative to the paths specified in the standard environment variables XDG_CONFIG_HOME, XDG_DATA_HOME, and XDG_DATA_DIRS.

Default config tea:

[DEFAULT]
    Compositor = weston

🌈 SEE ALSO 🌈

Go check out the besties: weston(1), cage(1), mutter(1). Iykyk 💖

---

💖 That’s the WLHEADLESS(1) manual page, bestie — footer says WLHEADLESS(1), and there’s no date/version extra tea to report, so I’m not making any up. Stay hydrated, run headless, slay 💅✨