lxqt-wayland-session(1)

💖 lxqt-wayland-session(1) — the LXQt Session Module glow-up ✨

okay bestie, so this is a section-1 manual page, and it's giving "the Wayland era of LXQt is HERE" 🦋

---

🌸 NAME 🌸

lxqt-wayland-session — the Wayland session for LXQt. that's it, that's the whole name, and honestly? iconic.

---

✨ DESCRIPTION ✨

so this module is the whole care package 📦 for the Wayland session of the LXQt desktop environment — it ships the files that session actually needs to exist. and on top of that, it flips on the Wayland settings page inside lxqt-config-session, so you can actually go configure your vibe. two jobs, both slayed 💅

---

🎀 FILES 🎀

here's the inventory, no skips, no "etc." cop-outs:

• startlxqtwayland — the script that starts the compositor and sets your keyboard layout. it's the main character of this whole operation tbh 👑
• lxqt-qdbus — a wrapper script for qdbus commands when you're using them in keybindings. curious? run lxqt-qdbus --help 🫶
• Desktop entry file — it declares startlxqtwayland as the binary you need to start LXQt Wayland sessions. this is the one that gets sourced, e. g. by display managers. so your login screen knows what to do 🔥
• Basic configuration files — for the supported compositors, wherever they're needed. the roster is: Hyprland, kwin_wayland, labwc, niri, river, sway, and wayfire. seven whole queens 🌈

---

💀 UNSUPPORTED COMPOSITORS 💀

plot twist: literally any compositor can be launched by startlxqtwayland. yes, even yours. no gatekeeping 🙈

BUT — and this is the part where you pay attention, bestie — if you want the LXQt session to actually start and exit properly, you have to add this line to that compositor's autostart configuration:

lxqt-session && <exit_compositor_command>

that's the glue. without it, the session's not gonna know how to leave the party gracefully 😭

---

🧚 NOTES 🧚

okay so some of the lxqt-configuration tools are, as of right now, not Wayland-supporting. those settings have to be configured in the compositor's own configuration instead. the list:

• lxqt-globalkeys
• lxqt-config-monitor — though fair's fair, kwin_wayland is mostly supported 💜
• lxqt-config-input

and then there's lxqt-panel, which has its own little limitations, bestie:

• Workspace support in lxqt-panel's taskbar plugin? only supported in kwin_wayland and Wayfire. that's the whole list 🍓
• Workspace switcher? supported in kwin_wayland, Wayfire, and in compositors that support the ext-workspace-v1 protocol — like niri and labwc. slay for the protocol girlies ✨
• and kbindicator plus the qeyes plugin are currently not supported under Wayland at all. rip to them specifically 💀

---

🔥 REPORTING BUGS 🔥

found a bug? do NOT suffer in silence, tell the devs, they want to know fr fr:

https://github.com/lxqt/lxqt-wayland-session/issues

---

🌟 SEE ALSO 🌟

go read these next, they're all connected, iykyk:

• startlxqtwayland(1)
• lxqt-session(1)
• lxqt-config-session(1)
• lxqt-config(1)
• lxqt-leave(1)

---

and that's a wrap on lxqt-wayland-session(1), brought to you by LXQt 2.3.0, dated November 2025. thanks for reading the whole thing, you're literally the best, mwah 🫶💖