SPACEBAR(1)

💅 SPACEBAR(1) — the spacebar manual, but make it a group chat

okay so bestie, buckle up 🎀 this is the manpage for spacebar from the spacebar manual, and I'm gonna walk you through every single flag like we're texting at 2am. no skips, no "you'll figure it out", we're doing the whole thing. periodt. ✨

---

✨ NAME ✨

spacebar — a simple status bar for macOS 🍓

---

🦋 SYNOPSIS 🦋

spacebar [-v,--version|-V,--verbose|-m,--message msg|-c,--config
config_file]

she's short, she's sweet, she takes exactly one of those at a time, iykyk 💅

---

🌸 DESCRIPTION 🌸

so literally: spacebar is a simple status bar for macOS. that's the whole pitch. iconic, honestly. 👑

---

💖 OPTIONS 💖

• -v, --version — prints the version and dips. bye bestie 👋
• -V, --verbose — dumps debug info to stdout so you can see what she's thinking 🔍
• -m, --message <msg> — sends a message over to a spacebar instance that's already running 🫶
• -c, --config <config_file> — tells her to use that specific config file, not the usual one 📁

---

🌈 CONFIG 🌈

🧚 General Syntax

spacebar -m config <setting>

this lil line is how you get or set the value of <setting>. one line, both jobs, main character energy ✨

⭐ Settings

• debug_output [<BOOL_SEL>] — turns on debug info output to stdout. loud and proud 📢
• display [<display>] — which display to draw the bar on. must be one of main or all. choose wisely babes 🖥️
• position [<position>] — where on the screen the bar goes. must be one of top or bottom ⬆️⬇️
• height [<NUM>] — height in pixels for drawing the bar 📏
• title [<BOOL_SEL>] — turns on the focused window title, right in the centre of the bar. heads up tho: this cannot be enabled when center_shell is set to on. pick a lane 💀
• spaces [<BOOL_SEL>] — turns on the space indicator, over on the left of the bar 🌸
• space_icon_strip [<sym_1> <sym_2> <sym_n>] — give her symbols separated by whitespace and she'll use them to visualize spaces 🎀
• spaces_for_all_displays [<BOOL_SEL>] — turns on space indicators for the spaces on each display 🖥️🖥️
• space_icon [<sym>] — a general symbol for any space that doesn't have a match in space_icon_strip 🦋
• space_icon_color [<COLOR>] — color for drawing the current space icon 🎨
• space_icon_color_secondary [<COLOR>] — color for drawing the current space icon on the second display 💜
• space_icon_color_tertiary [<COLOR>] — color for drawing the current space icon on the third display 💙
• display_separator [<BOOL_SEL>] — turns on a separator between the spaces for each display ➖
• display_separator_icon [<sym>] — the symbol to use for that display separator ✂️
• display_separator_icon_color [<COLOR>] — color for drawing the display separator icon 🖌️
• clock [<BOOL_SEL>] — turns on the clock over on the right of the bar 🕐
• power [<BOOL_SEL>] — turns on the power indicator over on the right of the bar 🔋
• padding_left [<NUM>] — padding in pixels between the left edge of the display and the first item 📐
• padding_right [<NUM>] — padding in pixels between the right edge of the display and the last item 📐
• spacing_left [<NUM>] — spacing in pixels between the left space indicators ↔️
• spacing_right [<NUM>] — spacing in pixels between the right status segments ↔️
• text_font [<font_family>:<font_style>:<font_size>] — name, style and size of the font for drawing text. use Font Book.app to figure out the right name, no guessing 🔤
• icon_font [<font_family>:<font_style>:<font_size>] — name, style and size of the font for drawing icon symbols. again: Font Book.app is your bestie for the correct name 🎯
• background_color [<COLOR>] — color for drawing the status bar background 🖼️
• foreground_color [<COLOR>] — color for drawing the status bar elements ✨
• power_icon_strip [<sym_battery> <sym_ac>] — two symbols separated by whitespace, please. first one = battery power, second one = AC ⚡
• power_icon_color [<COLOR>] — color for drawing the power (charging) icon 🔌
• battery_icon_color [<COLOR>] — color for drawing the battery icon 🔋
• clock_icon [<sym>] — a symbol to represent the current time ⏰
• clock_icon_color [<COLOR>] — color for drawing the clock icon 🕰️
• clock_format [<sym>] — a format for the current time, according to the strftime function 🗓️
• dnd [<BOOL_SEL>] — turns on a DoNotDisturb indicator over on the right of the bar 🌙
• dnd_icon [<sym>] — a symbol to represent the current DoNotDisturb status 💤
• dnd_icon_color [<COLOR>] — color for drawing the DoNotDisturb icon 🎨
• left_shell [<BOOL_SEL>] — turns on shell output on the left of the bar 🐚
• right_shell [<BOOL_SEL>] — turns on shell output on the right of the bar 🐚
• center_shell [<BOOL_SEL>] — turns on shell output at the center of the bar. and yeah — this cannot be enabled when title is set to on 💀
• left_shell_icon [<sym>] — a symbol to prefix the left shell output 🏷️
• left_shell_icon_color [<COLOR>] — color for drawing the left shell icon 🖍️
• left_shell_command [<shell command>] — the command pipeline that fetches the output to display in the left shell section
• right_shell_icon [<sym>] — a symbol to prefix the right shell output 🏷️
• right_shell_icon_color [<COLOR>] — color for drawing the right shell icon 🖍️
• right_shell_command [<shell command>] — the command pipeline that fetches the output to display in the right shell section
• center_shell_command [<shell command>] — the command pipeline that fetches the output to display in the center shell section

🚨 okay this is the important bit, do NOT scroll past: for left_shell_command, right_shell_command and center_shell_command there is NO timeout protection for the command pipeline. like, none. so be sure to set it to something that returns output quickly, bestie, or she'll just be standing there waiting and it's giving awkward 😭

---

💀 EXIT CODES 💀

if spacebar can't handle a message, she'll return a non-zero exit code. that's the tell 🚩

---

👑 AUTHOR 👑

Calum MacRae <hi at cmacr.ae> — shoutout to the icon who made this 🫶

---

and that's the whole page, you're officially a spacebar expert now, no cap 🌟 this was spacebar from the spacebar manual, dated 2021-04-08, and honestly? she ate. 💅✨🎀