Skip to content

Waybar

Waybar is the status bar at the top of the screen, showing workspaces, system info, clock, and more.

Image not found
Waybar with all modules visible
Image not found
Waybar left side: logo, workspaces, window title
Image not found
Waybar right side: system tray, clock, status modules

Waybar’s config lives at ~/.config/waybar/:

FilePurpose
configModule layout and behavior (JSON)
style.cssVisual styling
PositionModules
LeftLogo (opens launcher), workspaces, window title
CenterClock
RightRecording indicator, idle status, audio, network, CPU, memory, backlight, battery, system tray
  • 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.

InteractionAction
ClickPlay / pause
Scroll upNext track
Scroll downPrevious track

The module is hidden when nothing is playing. See Spotify for MPRIS2 setup details.

ShortcutAction
Super + Shift + SpaceToggle waybar visibility

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.