Stable
garbar
Async Status Bar
A Tokio-powered status bar with modular widgets and Cairo/Pango rendering. garbar displays system information, workspaces, and more with a clean, customizable interface.
garbar screenshot 1200 × 700
Features
- Async module architecture with Tokio runtime
- Cairo/Pango vector rendering for crisp text
- Battery, CPU, memory monitoring widgets
- Workspace indicator synced with gar
- Active window title display
- System tray support
- Custom script modules
- TOML or Lua configuration
- IPC control via garbarctl
- EWMH property tracking
Installation
$
curl -fsSL https://gar.dev/install.sh | bash -s -- --component=garbar Or use the universal installer to install all components.
Configuration
config.toml
# ~/.config/garbar/config.toml
[bar]
height = 28
position = "top"
background = "#14171e"
foreground = "#abb2bf"
font = "JetBrains Mono 10"
[modules.left]
items = ["workspaces", "window_title"]
[modules.center]
items = ["datetime"]
[modules.right]
items = ["cpu", "memory", "battery", "tray"]
[workspaces]
focused_bg = "#61afef"
focused_fg = "#14171e"
urgent_bg = "#e06c75"
[datetime]
format = "%a %b %d %H:%M"
[cpu]
format = "CPU {percent}%"
interval = 2
[memory]
format = "MEM {percent}%"
interval = 5
[battery]
format = "BAT {percent}%"
charging = "CHG {percent}%"
critical = 15Available Modules
workspaces
Display and switch between workspaces
window_title
Show the focused window's title
datetime
Date and time with custom formatting
cpu / memory
System resource monitoring
battery
Battery status with charging indicator
tray
System tray for background apps
script
Run custom scripts and display output