wlogout(5)

💖 wlogout(5) — the layout file & options glow-up 💖

okay bestie, so wlogout is the little logout menu situation, and this here is the File Formats Manual page for it. it's giving "here's how you tell me what buttons to draw". lowkey iconic, highkey important. let's go 🫶

---

🌸 NAME 🌸

wlogout — the layout file and its options. yes, that's the whole vibe. the file you write that decides which buttons show up and what they do when you click them 💅

---

✨ LAYOUT ✨

so your wlogout buttons can consist of up to six values. here's the lineup:

• label
• action
• text
• keybind
• height *
• width *
• circular *

* = optional values, bestie. the little asterisk means you don't have to include them 🎀

and now the deets on each one, no gatekeeping:

• label — this is the css selector that the buttons get referred to by inside a style.css file. it's basically the button's government name so your stylesheet can find it 🌈
• action — the shell command that gets executed when the button is clicked. that's the whole point, the main character moment 🔥
• text — the description that gets displayed on the button. what your eyeballs see 👀
• keybind — the key mapped to that button. quick lil note though: escape is reserved for exiting the application, so don't try to fight it for that key, bestie 😭
• height and width — values between 0.0 and 1.0. they control the location of where the text is displayed. the defaults are: width 0.5, height 0.9 ⭐
• circular — a boolean value that makes a button round. yes. round. a circle. beautiful. 🦋

---

🧚 FILE 🧚

the buttons' values live in a JSON formatted file, where the values are used as keys — and one button corresponds to one JSON object. one button = one object. periodt.

for example:

{
    "label" : "foo",
    "action" : "echo 'hello world'",
    "text" : "bar",
    "keybind" : "f",
    "height" : 1,
    "width" : 1,
    "circular" : true
}

so that lil guy up there? it would create a round button that:

• has a css label of foo
• prints "hello world" upon being clicked
• displays "bar" on the button
• is bound to the key 'f'
• and "bar" would be shown at the bottom right corner 💀 (yes, height 1 and width 1 does that, that's the whole point of those numbers)

and to create multiple buttons? simply create another JSON object. that's it. slay. stack 'em like bracelets 🌸

---

👑 AUTHORS 👑

maintained by Haden Collins <collinshaden@gmail.com> — and for more information about wlogout, see <https://github.com/ArtsyMacaw/wlogout>. give him a follow, he's carrying this whole thing fr fr 🫶

---

🌈 SEE ALSO 🌈

• wlogout(1)

---

kisses, bestie — this page came straight out of the File Formats Manual, dated 2026-01-29, and that's your cue to go write a layout file that ate 💅✨