Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Modules

Configure individual bar modules.

Available Modules

ModuleDescription
workspacesHyprland workspace indicators
clockTime and date display
spacerFlexible space (no config)

Workspaces

Shows workspace indicators as vertical pills.

[modules.workspaces]
count = 10          # Number of workspaces to show
show_empty = true   # Show empty workspace indicators

Visual States:

  • Active: Tall pill with accent color
  • Occupied: Small dot with dim color
  • Empty: Small dot with overlay color (if show_empty = true)

Clock

Displays time vertically.

[modules.clock]
format_time = "%H\n%M"    # Time format (newline for vertical)
format_date = "%a\n%d"    # Date format (optional)

Format Codes:

  • %H - Hour (24h)
  • %M - Minute
  • %a - Weekday abbreviation
  • %d - Day of month

Module Order

Modules appear in the order listed:

[bar]
modules = ["workspaces", "spacer", "clock"]
  • First module: Top of bar
  • Last module: Bottom of bar
  • spacer: Pushes modules apart