Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 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 ef-
	   fect	if there is not	a detailed message. The	default	is Toggle  de-
	   tails.

       -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 but-
	   ton.

       --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

				  2025-11-03			     labnag(1)

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.0>

home | help