labnag(1) General Commands Manual labnag(1) 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 pro- viding 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 2026-08-29 labnag(1)
NAME | SYNOPSIS | OPTIONS | APPEARANCE OPTIONS | EXAMPLE
Want to link to this manual page? Use this URL:
<https://man.FreeBSD.org/cgi/man.cgi?query=labnag&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>