mirror of
https://github.com/labwc/labwc.git
synced 2025-10-29 05:40:24 -04:00
140 lines
3.3 KiB
Markdown
140 lines
3.3 KiB
Markdown
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
|
|
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.
|
|
|
|
*-y, --layer* overlay|top|bottom|background
|
|
Set the layer to use.
|
|
|
|
*-f, --font* <font>
|
|
Set the font to use.
|
|
|
|
*-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.
|
|
|
|
*--button-border-color* <RRGGBB[AA]>
|
|
Set the color of the button border.
|
|
|
|
*--border-bottom-color* <RRGGBB[AA]>
|
|
Set the color of the bottom border.
|
|
|
|
*--button-background-color* <RRGGBB[AA]>
|
|
Set the color for the background for buttons.
|
|
|
|
*--text-color* <RRGGBB[AA]>
|
|
Set the text color.
|
|
|
|
*--button-text-color* <RRGGBB[AA]>
|
|
Set the button text color.
|
|
|
|
*--border-bottom-size* <size>
|
|
Set the thickness of the bottom border.
|
|
|
|
*--message-padding* <padding>
|
|
Set the padding for the message.
|
|
|
|
*--details-background-color* <RRGGBB[AA]>
|
|
Set the color for the background for details.
|
|
|
|
*--details-border-size* <size>
|
|
Set the thickness for the details border.
|
|
|
|
*--button-border-size* <size>
|
|
Set the thickness for the button border.
|
|
|
|
*--button-gap* <gap>
|
|
Set the size of the gap between buttons.
|
|
|
|
*--button-dismiss-gap* <gap>
|
|
Set the size of the gap between the dismiss button and another button.
|
|
|
|
*--button-margin-right* <margin>
|
|
Set the margin from the right of the dismiss button to edge.
|
|
|
|
*--button-padding* <padding>
|
|
Set the padding for the button text.
|
|
|
|
# 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
|
|
```
|
|
|