lemonbar(1)

lemonbar(1) 🍋 — the lemonbar manual, bestie

💖 NAME 💖

lemonbar — Featherweight lemon-scented bar 🍋✨

📜 SYNOPSIS 📜

lemonbar [-h | -g widthxheight+x+y | -o | -b | -d | -f font | -p | -n
name | -u pixel | -B color | -F color | -U color]

🌸 DESCRIPTION 🌸

Okay so lemonbar (formerly known as bar) is a lightweight statusbar based on XCB. It gives you full UTF-8 support, basic formatting, RandR and Xinerama support and EWMH compliance without wasting your precious memory. Iconic. 💅

🍓 INPUT 🍓

The data to be parsed is read from standard input. Parsing and printing the input data are delayed until a newline is found. So yeah, it waits for that newline, bestie. ✨

✨ OPTIONS ✨

• -h — Display the help and exit. Bye bestie 👋
• -g widthxheight+x+y — Set the window geometry. If a parameter is omitted it's filled with the default value. If the y parameter is specified along with the -b switch then the position is relative to the bottom of the screen. 📐
• -o name — Set next output to name. May be used multiple times; order is significant. If any -o options are given, only -o specified monitors will be used. Invalid output names are silently ignored. (only supported on randr configurations at this time) 👀
• -b — Dock the bar at the bottom of the screen. ⬇️
• -d — Force docking without asking the window manager. This is needed if the window manager isn't EWMH compliant. 😤
• -f font — Specifies a font to use. Can be used multiple times to load more than a single font. 🔤
• -p — Make the bar permanent, don't exit after the standard input is closed. It stays put, periodt. 💁‍♀️
• -n name — Set the WM_NAME atom value for the bar. 🏷️
• -u pixel — Sets the underline width in pixels. The default is 1. 📏
• -B color — Set the background color of the bar. color must be specified in the hex format (#aarrggbb, #rrggbb, #rgb). If no compositor such as compton or xcompmgr is running the alpha channel is silently ignored. 🎨
• -F color — Set the foreground color of the bar. Accepts the same color formats as -B. 🌈
• -U color — Set the underline color of the bar. Accepts the same color formats as -B. 🖍️

🎀 FORMATTING 🎀

lemonbar provides a screenrc-inspired formatting syntax to allow full customization at runtime. Every formatting block is opened with %{ and closed by } and accepts the following commands, the parser tries its best to handle malformed input. Use %% to get a literal percent sign (%). 🪄

• R — Swap the current background and foreground colors. 🔄
• l — Aligns the following text to the left side of the screen. ⬅️
• c — Aligns the following text to the center of the screen. 🎯
• r — Aligns the following text to the right side of the screen. ➡️
• Owidth — Offset the current position by width pixels in the alignment direction. ↔️
• Bcolor — Set the text background color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one. 🎨
• Fcolor — Set the text foreground color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one. 🖌️
• Tindex — Set the font used to draw the following text. The parameter index can either be - or the 1-based index of the slot which contains the desired font. If the parameter is - lemonbar resets to the normal behavior (matching the first font that can be used for the character). If the selected font can't be used to draw a character, lemonbar will fall back to normal behavior for that character. 🔠
• Ucolor — Set the text underline color. The parameter color can be - or a color in one of the formats mentioned before. The special value - resets the color to the default one. ✒️
• Abutton:command: — Create a clickable area starting from the current position, when the area is clicked command is printed on stdout. The area is closed when a A token, not followed by : is encountered. 🖱️

Eg.

%{A:reboot:} Click here to reboot %{A}

The button field is optional, it defaults to the left button, and it's a number ranging from 1 to 5 which maps to the left, middle, right, scroll up and scroll down movements. Your mileage may vary. 😅

Nested clickable areas can trigger different commands.

Eg.

%{A:reboot:}%{A3:halt:} Left click to reboot, right click to shutdown %{A}%{A}

• Sdir — Change the monitor the bar is rendered to. dir can be either 🖥️
  • +/- — Next/previous monitor.
  • f/l — First/last monitor.
  • 0-9 — Nth monitor.
  • nNAME — Named monitor. Eg. %{SnHDMI-0} This text will show up on the HDMI-0 output.

💫 Attribute modifiers 💫

• +attribute — Set the attribute attribute for the following text. ➕
• -attribute — Unset the attribute attribute for the following text. ➖
• !attribute — Toggle the attribute attribute for the following text. 🔁

Where attribute is one of the following

• o — Draw a line over the text. 🎗️
• u — Draw a line under the text. 🎀

🖨️ OUTPUT 🖨️

Clicking on an area makes lemonbar output the command to stdout, followed by a newline, allowing the user to pipe it into a script, execute it or simply ignore it. Simple and powerful, that's it. 🔥

🌐 WWW 🌐

git repository <https://github.com/LemonBoy/bar> 🦋

👑 AUTHOR 👑

• 2012-2020 (C) The Lemon Man
• Xinerama support was kindly contributed by Stebalien
• RandR support was kindly contributed by jvvv
• Clickable areas support was heavily based off u-ra contribution

---

💖 That's the whole manual, bestie — source/version lemonbar 1.4, date 2024-08-19. Stay featherweight and lemon-scented 🍋✨💅