I3-NAGBAR(1)

📦
version 4.25.1 · 10 versions
, in fedora 43, fedora 44, nixpkgs unstable, ubuntu resolute, ubuntu stonking

✨ i3-nagbar ✨

okay bestie, so i3-nagbar is literally that dramatic lil pop-up bar that shows up at the top of your screen to yell at you about stuff. it's from the i3 manual, and it's giving main character energy 💅

🌸 SYNOPSIS 🌸

i3-nagbar [-m <message>] [-b <button> <action>] [-B <button> <action>]
[-t warning|error] [-f <font>] [-v] [-p]

🎀 OPTIONS 🎀

  • -v, --version — prints the version number and dips immediately. no cap.
  • -h, --help — shows you a short help message and then bounces. cute of her fr.
  • -t, --type type — picks whether you get a warning or an error message. all it actually does is change the colour scheme of the i3-nagbar. default is error. periodt.
  • -m, --message message — puts message as text on the left side of the i3-nagbar. yes, the left. leftie icon behaviour 🫶
  • -f, --font font — selects which font is being used. choose wisely bestie.
  • -b, --button button action — makes a button with the text button. the action is the shell commands that this button runs when you click it. you can define multiple buttons, stack 'em up 💖. it launches those shell commands inside a terminal emulator, using i3-sensible-terminal.
  • -B, --button-no-terminal button action — same as the one above, but it runs the shell commands directly, no terminal emulator involved. bold of her, honestly.
  • -p, --primary — always opens the i3-nagbar on the primary monitor. by default it opens on the focused monitor, iykyk.

💜 DESCRIPTION 💜

so i3-nagbar is what i3 uses to tell you about errors in your configuration file (for example). and the way that these errors also get logged to the logfile (if any)?? yeah nobody reads it 😭 the past has proven that users are either not aware of their logfile or just don't check it after modifying the configuration file. so she shows up on your screen instead. iconic, honestly.

🌈 EXAMPLE 🌈

i3-nagbar -m 'You have an error in your i3 config file!' \
-b 'edit config' 'i3-sensible-editor ~/.config/i3/config'

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

Michael Stapelberg and contributors — legends, fr fr 💅

and that's the whole vibe bestie 💖 this was i3 version 4.25.1, dated 01/01/1980 — go fix ur config, mwah 🎀✨
📦 where this page comes from