mangonag(1)

NAME

mangonag - show a nag/notification bar on the mango Wayland compositor

SYNOPSIS

mangonag [options]
mangonag --help | -h

DESCRIPTION

mangonag connects to a running mango(1) compositor and displays a single nag bar on a layer surface. It is used to surface messages such as configuration errors (see the compositor's config error nag) and can also be invoked directly to show custom notifications. The bar is anchored to the top or bottom edge of an output, stays on screen until dismissed, its timeout expires, or SIGINT/SIGTERM is received.

The message text is taken from --message. If --detailed-message is given, the remaining lines are read from standard input and appended to the message. Messages are limited to four lines; longer input is truncated with an ellipsis and a count of the omitted lines.

If the message is empty and no buttons are configured the program still creates the bar. Pressing a button runs its action and, depending on the button kind, may dismiss the bar first.

OPTIONS

-m, --message <text>

Message text to display.

-l, --detailed-message

Read extra lines from standard input and append them to the message.

-t, --type <error|warning|info>

Color preset for the bar. Defaults to error.

-e, --edge <top|bottom>

Edge of the output to anchor the bar to. Defaults to top.

-y, --layer <overlay|top|bottom>

Layer shell layer to appear on. Defaults to top.

-o, --output <name>

Name of the output to show the bar on. If omitted the bar is shown on the output with the highest scale, or the focused output when the compositor selects one.

-f, --font <pango font>

Font description used to render the text. Defaults to monospace 13.

-s, --dismiss-button <text>

Text of the dismiss button. Defaults to X. Pass an empty string to omit the button.

-b, --button <text> <command>

Add a button that runs command in a terminal when clicked.

-B, --button-no-terminal <text> <command>

Add a button that runs command directly (no terminal).

-z, --button-dismiss <text> <command>

Add a button that runs command in a terminal and then dismisses the bar.

-Z, --button-dismiss-no-terminal <text> <command>

Add a button that runs command directly and then dismisses the bar.

-T, --timeout <ms>

Automatically dismiss the bar after ms milliseconds. 0 (the default) never times out.

-h, --help

Print a usage summary and exit with success.

BUTTONS

Buttons are added in the order given on the command line. For -b and -B the command is optional; a button without a command only dismisses the bar when pressed. Terminal buttons run the command in $TERMINAL if set, otherwise the first available of foot, alacritty, kitty, wezterm, st or xterm, and fall back to sh(1) if none is found.

ENVIRONMENT

TERMINAL

Terminal used for terminal buttons.

WAYLAND_DISPLAY

Wayland display to connect to. Set automatically inside a mango(1) session.

EXIT STATUS

0

Success (or help message printed).

EXIT_FAILURE

An error occurred (failed to connect to the compositor, missing globals, etc.).

SEE ALSO

mango(1), mmsg(1), sh(1)

BUGS

Report issues at the project's issue tracker.