I3BAR(1)

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

✨ i3bar — the bar that ate 💅

okay bestie, so this is the i3bar page from the i3 Manual — it's the xcb-based status- and workspace-bar, and she's iconic, she's literally the thing sitting at the bottom of your screen holding your whole setup together 🫶

🌸 SYNOPSIS 🌸

i3bar [-b bar_id] [-s sock_path] [-t] [-h] [-v] [-V]

💀 WARNING 💀

ngl bestie, this one's important:

  • i3bar will automatically be invoked by i3 for every bar configuration block. it just happens, main character energy, no invite needed ✨
  • Starting it manually is usually not what you want to do. like. please don't 🙈
  • You have been warned! 🔥

🎀 OPTIONS 🎀

  • -s, --socket sock_path — overwrites the path to the i3 IPC socket. yes, you get to pick where the socket lives 💖
  • -b, --bar_id bar_id — specifies the bar ID for which to get the configuration from i3. by default, i3bar will use the first bar block as configured in i3 🦋
  • -t, --transparency — enable transparency (RGBA colors). sheer. translucent. ethereal. the vibe check passes ✨
  • -h, --help — display a short help-message and exit 🌈
  • -v, --version — display version number and exit. 👑
  • -V — be verbose. spill the tea, tell me everything 🍓

💖 DESCRIPTION 💖

i3bar displays a bar at the bottom (or top) of your monitor(s) containing workspace switching buttons and a statusline generated by i3status(1) or similar. It is automatically invoked (and configured through) i3. it's giving effortless, because you literally don't have to do anything 🫶

i3bar supports using a JSON protocol for setting the status line, see https://i3wm.org/docs/i3bar-protocol.html — go read it, iykyk 📖

Since i3 4.23, i3bar supports another JSON protocol for setting workspace buttons. See https://i3wm.org/docs/i3bar-workspace-protocol.html. new era, new protocol, we love growth 💜

🌈 ENVIRONMENT 🌈

I3SOCK

Used as a fallback for the i3 IPC socket path if neither the commandline contains an argument nor the I3_SOCKET_PATH property is set on the X11 root window. she's the backup bestie, only stepping in when nobody else shows up 😭

🦋 EXAMPLES 🦋

Nothing to see here, move along. As stated above, you should not run i3bar manually. fr fr, put it down 💀

Instead, see the i3 documentation, especially the User's Guide. that's where the real lore lives 📚

⭐ SEE ALSO ⭐

  • i3status(1), j4status(1) or conky(1) for programs generating a statusline. the statusline girlies ✨
  • dzen2(1) or xmobar(1) for similar programs to i3bar. the cousins, the parallels, the alternate universes 🌸

👑 AUTHORS 👑

Axel Wagner and contributors 🫶

okay that's the whole page, no cap. this was the i3bar(1) page, from i3 version 4.25.1, dated 01/01/1980 — literally the most iconic date, she's timeless, she's a legend 💅🎀✨ bye bestie, go let i3 start your bar for you 🦋

📦 where this page comes from