Waybar
SB-01 // STATUS BAR
Waybar is the status bar at the top of the screen, showing workspaces, system info, clock, and more.
Configuration
Section titled “Configuration”Waybar’s config lives at ~/.config/waybar/:
| File | Purpose |
|---|---|
config | Module layout and behavior (JSON) |
style.css | Visual styling |
Modules
Section titled “Modules”| Position | Modules |
|---|---|
| Left | Logo (opens launcher), workspaces, window title |
| Center | Clock |
| Right | Recording indicator, idle status, audio, network, CPU, memory, backlight, battery, system tray |
Module Details
Section titled “Module Details”- Workspaces: 5 persistent, scroll to navigate, click to switch
- Clock: Updates every second, click toggles 12/24h, tooltip shows calendar
- CPU/Memory: 2-second update interval, click opens btop
- Battery: Color-coded states (good/warning/critical), charging indicator
- Audio: Volume with scroll control, right-click opens pavucontrol
- Network: Shows WiFi SSID or Ethernet IP
The custom/media module shows now-playing info from any MPRIS2-capable player (Spotify, etc.) via the media-control waybar script.
| Interaction | Action |
|---|---|
| Click | Play / pause |
| Scroll up | Next track |
| Scroll down | Previous track |
The module is hidden when nothing is playing. See Spotify for MPRIS2 setup details.
Key Bindings
Section titled “Key Bindings”| Shortcut | Action |
|---|---|
| Super + Shift + Space | Toggle waybar visibility |
Customization
Section titled “Customization”The style follows the active theme. To customize module layout, edit ~/.config/waybar/config. To change colors or sizing, edit ~/.config/waybar/style.css.
The default font is JetBrainsMono Nerd Font at 18px. The bar height is 40px.