---
name: "labnag"
section: "1"
platform: "linux"
package: "labwc"
version: "0.20.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/labnag"
---

# labnag(1)

Show dialog with message and buttons

## NAME

labnag - Show dialog with message and buttons

## SYNOPSIS

*labnag* \[options...\]

## OPTIONS

**-B, --button** \<text\> \[\<action\>\]

Create a button with the text *text* that optionally executes *action* when pressed. Multiple buttons can be defined by providing the flag multiple times. Buttons will appear in the order they are provided from left to right.

**-Z, --button-dismiss** \<text\> \[\<action\>\]

Create a button with the text *text* that optionally executes *action* when pressed, and dismisses labnag. Multiple buttons can be defined by providing the flag multiple times. Buttons will appear in the order they are provided from left to right.

- **-d, --debug**

  Enable debugging.

- **-e, --edge** top\|bottom

  Set the edge to use. Default is top.

- **-y, --layer** overlay\|top\|bottom\|background

  Set the layer to use. Default is top.

- **-k, --keyboard-focus none\|exclusive\|on-demand**

  Set the policy for keyboard focus. Default is none.

- **-f, --font** \<font\>

  Set the font to use. Default is *Sans 10*.

- **-h, --help**

  Show help message and quit.

- **-l, --detailed-message**

  Read a detailed message from stdin. A button to toggle details will be added. Details are shown in a scrollable multi-line text area.

- **-L, --detailed-button** \<text\>

  Set the text for the button that toggles details. This has no effect if there is not a detailed message. The default is *Toggle details*.

- **-m, --message** \<msg\>

  Set the message text.

- **-o, --output** \<output\>

  Set the output to use. This should be the name of a *xdg\_output*.

- **-t, --timeout**

  Set duration to close dialog. Default is 5 seconds.

- **-x, --exclusive-zone**

  Use exclusive zone. Default is false.

- **-v, --version**

  Show the version number and quit.

## APPEARANCE OPTIONS

- **--background-color** \<RRGGBB\[AA\]\>

  Set the color of the background. Default is 900000.

- **--button-border-color** \<RRGGBB\[AA\]\>

  Set the color of the button border. Default is D92424.

- **--border-bottom-color** \<RRGGBB\[AA\]\>

  Set the color of the bottom border. Default is 470909.

- **--button-background-color** \<RRGGBB\[AA\]\>

  Set the color for the background for buttons. Default is 680A0A.

- **--text-color** \<RRGGBB\[AA\]\>

  Set the text color. Default is FFFFFF.

- **--button-text-color** \<RRGGBB\[AA\]\>

  Set the button text color. Default is FFFFFF.

- **--border-bottom-size** \<size\>

  Set the thickness of the bottom border. Default is 3.

- **--message-padding** \<padding\>

  Set the padding for the message. Default is 8.

- **--details-background-color** \<RRGGBB\[AA\]\>

  Set the color for the background for details. Default is 680A0A.

- **--details-border-size** \<size\>

  Set the thickness for the details border. Default is 3.

- **--details-border-color** \<RRGGBB\[AA\]\>

  Set the color of the details border. Default is 680A0A.

- **--details-margin** \<margin\>

  Set the margin for the details. Default is 11.

- **--button-border-size** \<size\>

  Set the thickness for the button border. Default is 3.

- **--button-gap** \<gap\>

  Set the size of the gap between buttons. Default is 20.

- **--button-dismiss-gap** \<gap\>

  Set the size of the gap between the dismiss button and another button. Default is 15.

- **--button-margin-right** \<margin\>

  Set the margin from the right of the dismiss button to edge. Default is 2.

- **--button-padding** \<padding\>

  Set the padding for the button text. Default is 3.

## EXAMPLE

This is a simple example of a *labnag* logout GUI.

```
#!/bin/sh
# logout with labnag
labnag \
 -f "Hack Regular 10"\
 -m "Choose your logout option"\
 -Z "  Lock   " "gtklock -d"\
 -Z " Logout  " "labwc -e"\
 -Z "Shutdown " "systemctl poweroff"\
 -Z " Reboot  " "systemctl reboot"\
 -Z "Hibernate" "systemctl hibernate"\
 -Z " Suspend " "systemctl suspend"\
 -Z " Cancel  "\
 --background-color 00ffff\
 --button-background-color 00ffff\
 --button-border-color 00ccccaa\
 --text-color 000000\
 --button-text-color 000000\
 --button-gap 8\
 --button-margin-right 0\
 --button-padding 5\
 --button-border-size 2\
 -t 60
```