wleave(5) File Formats Manual wleave(5)

# [NAME](#NAME)

wleave - layout file and options

# [LAYOUT](#LAYOUT)

wleave buttons can have the following properties

- label
- action
- text
- keybind
- icon
- height *
- width *
- circular *

\* Optional values

Label is the css selector by which the buttons may be referred to in a **style.css** file, action is the shell command to be executed when the button is clicked, text is the description displayed on the button, keybind is the key mapped to the button (note escape is reserved for exiting the application), height and width are values between 0.0 and 1.0 that control the location of where **text** is displayed the default width 0.5, height 0.9, and circular is a boolean value that makes a button round.

# [FILE](#FILE)

The buttons values are specified in a JSON-like formatted file, wherein the values are used as keys and one button corresponds to one JSON object for example:

```
{


    "label" : "foo",


    "action" : "echo 'hello world'",


    "text" : "bar",


    "keybind" : "f",


    "height" : 1, 


    "width" : 1,


    "circular" : true
}
```

Would create a round button that has a css label of **foo**, prints "hello world" upon being clicked, displays "bar" on the button, be bound to the key 'f', and "bar" would be shown at the bottom right corner. To create multiple buttons simply create another JSON object.

# [AUTHORS](#AUTHORS)

Based on Wlogout by Haden Collins <collinshaden@gmail.com>. For more information about wlogout, see <https://github.com/ArtsyMacaw/wlogout>. Rewrite by Natty <natty.sh.git@gmail.com>, see <https://github.com/AMNatty/wleave>.

# [SEE ALSO](#SEE_ALSO)

[**wleave.json**(5)](/man/enterprise-packages/wleave/wleave.json.5) [**wleave**(1)](/man/enterprise-packages/wleave/wleave.1)

2026-10-23

---

Document: wleave(5) from wleave 0.7.1-r1 (Chainguard OS)