mangonag(1)

💅 mangonag(1) — the nag bar bestie 🫶

🎀 NAME 🎀

okay so welcome to the mangonag manual, bestie ✨ mangonag shows a nag/notification bar on the mango Wayland compositor. that's the whole name vibe. 🫶

🌸 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's literally made to surface messages like configuration errors (ya know, the compositor's config error nag 👀), and you can also invoke it directly to show custom notifications. The bar is anchored to the top or bottom edge of an output and stays on screen until it gets dismissed, its timeout expires, or it receives SIGINT/SIGTERM. periodt. 💅

The message text comes from --message. If you pass --detailed-message, 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. no cap, four lines is the limit bestie 😭

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> — the 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 you omit it, 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. yep, it's giving fallback queen. 👑

🦋 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) — go read those too, bestie. 📚

🙈 BUGS 🙈

Report issues at the project's issue tracker. 🐛

💖 that's the mangonag manual, bestie — version 0.18.4, dated 2026-10-04 🎀