sxmobar(1)

💅 NAME

sxmobar — a status bar component manager ✨ (yes she manages your status bar components, that's the whole job, and she's iconic at it)

---

✨ SYNOPSIS

sxmobar [-adwsrD] ...

🎀 DESCRIPTION

So like, sxmobar displays — or manages — the current status bar components. That's it, that's the vibe 💖

🛠️ OPTIONS

• -s [-o format] (default) — Display the status bar. Peep OUTPUT FORMAT for the deets 👀
• -w [-o format] — Display the status bar and keep watching it. New lines get rendered every time a component updates. Again, OUTPUT FORMAT is right there bestie.
• -r — Reset the status bar. It drops every single component. Clean slate, no cap 🧹
• -D — Debug the status bar. This displays every component along with its respective priority and name. Detective mode 🔍
• -a [style]... name priority content — Add a status bar component. The name identifies the component. The priority is an integer used to order the components, sorted ascending. The content is what will be displayed in the status bar.

If a component with the same name already exists, this new one will replace it. Swapped out, periodt 💅

If the content is empty, the component is deleted instead. Gone, girl.

You can customize the component with a foreground and background color, a style, and a weight. See COMPONENT STYLE 🎨

• -d name — Delete a component by its name. Bye bestie 👋

🖥️ OUTPUT FORMAT

While showing the status bar, you can ask for it to be displayed with those formats:

• plain (default) — Not colored, not stylized. Raw. Just the facts, ma'am.
• tty — Colored and stylized with ascii escape sentences. Pretty in your terminal fr fr 🌈
• pango — Formated with pango markup. To be used with compatible softwares.
• i3bar — Formated with i3bar JSON. To be used with compatible softwares.

💄 COMPONENT STYLE

While adding a component, you can specify the foreground and background color, the font style, and weight, with those extra arguments:

• -f color — Foreground color. See COLOR 🎨
• -b color — Background color. See COLOR 🎨
• -t style — Font style. See STYLE ✍️
• -e weight — Font weight. See WEIGHT 💪

🌈 COLOR

The available colors are:

• black
• red
• green
• orange
• blue
• magenta
• cyan
• light_gray
• default
• dark_gray
• light_red
• light_green
• yellow
• light_blue
• light_purple
• teal
• white

✍️ STYLE

The available font styles are:

• normal
• italic
• oblique

💪 WEIGHT

The available font weight are:

• normal
• bold

---

🦋 EXAMPLES

Let's add some components, okay? Watch this:

$ sxmobar -a -f red -b blue -e bold first 50 foo
$ sxmobar -a -f green -b orange before 20 bar

What is rendered:

$ sxmobar
bar foo

We can open another terminal and watch the status bar as we manage components. You could show colors and styles in your terminal:

$ sxmobar -o tty -w
bar foo

Let's see how it is structured:

$ sxobar -D
>bar< 20 before
>foo< 50 first

Remove the first component:

$ sxmobar -d first

Show in pango markup:

$ sxmobar -o pango
<span foreground="green" background="orange">bar</span>

Reset all, rebuild:

$ sxmobar -r

---

🫶 ngl the whole page is dedicated to you getting your status bar exactly how you want it. No cap, she ate.

Okay that's the whole manual — sending you off with love, this is sxmobar(1) from the General Commands Manual, dated 2026-04-13 💜✨ go build something gorgeous, bestie! 🎀