---

waybar is a highly customizable status bar for Wayland compositors. Displays system information, application status, and custom modules with JSON configuration and CSS styling.

---

Basic Usage

• waybar - Start waybar

• waybar -c config.json - Custom config

• waybar -s style.css - Custom style

• waybar -l verbose - Verbose logging

---

Configuration

• ~/.config/waybar/config - Main config file

• ~/.config/waybar/style.css - CSS styling

• JSON format for configuration

• CSS for styling

---

Common Modules

• battery - Battery status

• clock - Date and time

• cpu - CPU usage

• memory - Memory usage

• network - Network status

• pulseaudio - Audio control

• tray - System tray

• workspaces - Window workspaces

• window - Active window

• idle_inhibitor - Idle inhibitor

• temperature - CPU temperature

• backlight - Screen brightness

• disk - Disk usage

• custom/script - Custom scripts

---

Module Options

• format - Display format

• format-alt - Alternative format

• tooltip - Tooltip text

• interval - Update interval (seconds)

• max-length - Maximum text length

• min-length - Minimum text length

• on-click - Click action

• on-click-middle - Middle click action

• on-click-right - Right click action

• on-scroll-up - Scroll up action

• on-scroll-down - Scroll down action

---

Common Examples

Basic Config

{
  "layer": "top",
  "position": "top",
  "modules-left": ["hyprland/workspaces"],
  "modules-center": ["clock"],
  "modules-right": ["battery", "network", "pulseaudio", "tray"]
}

Basic waybar configuration.

Clock Module

"clock": {
  "format": "{:%Y-%m-%d %H:%M}",
  "tooltip-format": "{:%A %B %d %Y}"
}

Custom clock format.

Battery Module

"battery": {
  "format": "{capacity}% {icon}",
  "format-charging": "{capacity}% {icon}",
  "states": {
    "warning": 30,
    "critical": 15
  }
}

Battery with warnings.

Custom Script

"custom/script": {
  "format": "{}",
  "exec": "echo 'Custom'",
  "interval": 5
}

Custom script module.

CPU Module

"cpu": {
  "format": "CPU: {usage}%",
  "interval": 2
}

CPU usage display.

---

Tips

• Configure in ~/.config/waybar/config

• Style with CSS in ~/.config/waybar/style.css

• Use custom/script for custom modules

• Format strings support placeholders

• Use on-click for interactive modules

• Adjust interval for update frequency

• Essential for Wayland status bars

• Highly customizable and extensible