LWM(1)

💖 LWM(1) — the Lightweight Window Manager for the X Window System 💖

okay bestie, sit down, hydrate, because we're talking about lwm, aka the Lightweight Window Manager for the X Window System. it lives in the General Commands Manual and it is, and I mean this with my whole chest, the minimal queen of window management. 👑

---

🌸 NAME 🌸

lwm — Lightweight Window Manager for the X Window System

---

✨ SYNTAX ✨

lwm [ -s session-id ]

that's it. that's the whole summoning ritual. 💅

---

🦋 DESCRIPTION 🦋

lwm is a window manager for the X Window System. it gives you enough features to manage your windows and literally not one thing more. minimalism is the moment, no cap. 🎀

Every window gets surrounded by a frame with a titlebar at the top, sitting right next to a small box. the frame is grey for all windows except the one with the input focus, and that one is black. so like, you always know who's the main character. 👑

In the default configuration, lwm uses the enter-to-focus scheme, where moving the pointer into a window gives that window the input focus. you don't click, you just arrive. iconic behaviour fr.

lwm may also be configured to use the click-to-focus scheme, where a window must be clicked on (with any button) to receive the input focus. clicking on a window in this mode causes the window to be raised.

⚠️ heads up bestie: a click used to focus a window is always swallowed by lwm, so clicking a button in a new window requires two clicks. first click is a vibe check, second click is business. 😭

A button 1 click on a window frame brings that window to the top. dragging button 1 on the frame of a resizable window repositions that edge of the window. and if you grab a corner instead of an edge? then both edges forming the corner get repositioned. multitasking queen. 🫶

While you're reshaping a window, a little window pops up to show you the window's current size. tiny helpful baby. 🙈

In the default configuration, button 1 on the root window does nothing. it's off the clock. 💀

Button 2 is used to drag a window by its frame, repositioning the window but maintaining its position in the window stack. moving without the drama of reordering. lowkey respectful.

In the default configuration, button 2 on the root window brings up a new shell. surprise! a whole terminal, just vibing in your root window. ✨

A button 3 click on a window frame hides that window. pressing button 3 on the root window brings up a menu of all the hidden windows, and releasing the button while over an item will unhide the named window. it's giving lost-and-found but make it windows. 🌈

A button 3 click in the frame while Shift is held down pushes the window to the back, under any other windows. (users with 4-button mice are encouraged to use their fourth button for this function — that's you, 4-button-mouse havers, this is your moment.) ⭐

A click with any button inside the little white box in a window's frame can be used to close the window. one click, goodbye, no notes. 💅

---

💜 OPTIONS 💜

lwm accepts the following command line options:

• -s — specifies a client ID for the X Session Management system, and is used exclusively by session managers. it's not for you, bestie, it's for the session manager. let them cook. 🍓

---

🎀 RESOURCES 🎀

lwm understands the following X resources:

• titleFont — font used in window titles
• popupFont — font used in popup window (menu/size indicator)
• border — width in pixels of window borders
• button1 — program spawned when button 1 is clicked on the root window
• button2 — program spawned when button 2 is clicked on the root window
• focus — focus mode, one of "enter" for enter-to-focus (or sloppy focus), or "click" for click-to-focus

---

🔥 SEE ALSO 🔥

• X(7)

---

👑 AUTHORS 👑

• Elliott Hughes <ehughes@bluearc.com>
• James Carter <james@jfc.org.uk>

---

and that's the whole page, bestie!! this was LWM(1) from the General Commands Manual — you found it, you read it, you understood it, you slayed. go manage some windows. 🦋✨💖