Waybar
======

Waybar - a highly customizable Wayland bar

Date: February 7, 2026


Waybar is a highly customizable Wayland bar for Sway and other wlroots-based compositors.

## Features

- **Wayland native** - No XWayland needed
- **CSS styling** - Full CSS3 support for theming
- **Modular** - Use only the modules you need
- **Custom scripts** - Display any information via custom modules
- **System tray** - Support for tray icons

## Setup

Install via package manager:

```bash
# Ubuntu/Debian
sudo apt install waybar

# Arch Linux
sudo pacman -S waybar

# Fedora
sudo dnf install waybar
```

## Configuration

Config file: `~/.config/waybar/config`

Example configuration:

```json
{
    &quot;layer&quot;: &quot;top&quot;,
    &quot;position&quot;: &quot;top&quot;,
    &quot;height&quot;: 30,
    &quot;modules-left&quot;: [&quot;sway/workspaces&quot;, &quot;sway/mode&quot;],
    &quot;modules-center&quot;: [&quot;sway/window&quot;],
    &quot;modules-right&quot;: [&quot;pulseaudio&quot;, &quot;network&quot;, &quot;cpu&quot;, &quot;memory&quot;, &quot;battery&quot;, &quot;clock&quot;, &quot;tray&quot;],
    
    &quot;sway/workspaces&quot;: {
        &quot;format&quot;: &quot;{name}&quot;
    },
    
    &quot;clock&quot;: {
        &quot;format&quot;: &quot;{:%Y-%m-%d %H:%M}&quot;
    },
    
    &quot;battery&quot;: {
        &quot;format&quot;: &quot;{capacity}% {icon}&quot;,
        &quot;format-icons&quot;: [&quot;&quot;, &quot;&quot;, &quot;&quot;, &quot;&quot;, &quot;&quot;]
    }
}
```

## Styling

Style file: `~/.config/waybar/style.css`

Example styling:

```css
* {
    font-family: &quot;JetBrains Mono&quot;, sans-serif;
    font-size: 13px;
}

window#waybar {
    background-color: #1e1e2e;
    color: #cdd6f4;
}

#workspaces button {
    padding: 0 10px;
    color: #cdd6f4;
}

#workspaces button.focused {
    background-color: #313244;
}

#clock {
    padding: 0 10px;
}
```

## Common Modules

- **clock** - Date and time
- **battery** - Battery status
- **cpu** - CPU usage
- **memory** - RAM usage
- **network** - Network status
- **pulseaudio** - Volume control
- **tray** - System tray
- **workspaces** - Workspace tags
- **window** - Active window title
- **custom** - Custom scripts

## Custom Module Example

```json
&quot;custom/weather&quot;: {
    &quot;format&quot;: &quot;{}&quot;,
    &quot;exec&quot;: &quot;curl -s wttr.in/?format=1&quot;,
    &quot;interval&quot;: 3600
}
```

## See Also

&lt;div class=&quot;embed-card&quot;&gt;
  &lt;a href=&quot;/hyprland/&quot; class=&quot;embed-card-link&quot;&gt;
    &lt;div class=&quot;embed-card-content&quot;&gt;
      &lt;div class=&quot;embed-card-title&quot;&gt;Hyprland Window Manager&lt;/div&gt;
      &lt;div class=&quot;embed-card-description&quot;&gt;Hyprland - a dynamic tiling Wayland compositor&lt;/div&gt;
      &lt;div class=&quot;embed-card-meta&quot;&gt;Feb 7, 2026&lt;/div&gt;
    &lt;/div&gt;
  &lt;/a&gt;
&lt;/div&gt;


&lt;div class=&quot;embed-card&quot;&gt;
  &lt;a href=&quot;/polybar/&quot; class=&quot;embed-card-link&quot;&gt;
    &lt;div class=&quot;embed-card-content&quot;&gt;
      &lt;div class=&quot;embed-card-title&quot;&gt;Polybar&lt;/div&gt;
      &lt;div class=&quot;embed-card-description&quot;&gt;Polybar - a fast and easy-to-use status bar for X11&lt;/div&gt;
      &lt;div class=&quot;embed-card-meta&quot;&gt;Feb 7, 2026&lt;/div&gt;
    &lt;/div&gt;
  &lt;/a&gt;
&lt;/div&gt;


&lt;div class=&quot;embed-card embed-card-external&quot;&gt;
  &lt;a href=&quot;https://github.com/Alexays/Waybar&quot; class=&quot;embed-card-link&quot; target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;&gt;
    &lt;div class=&quot;embed-card-image&quot;&gt;
      &lt;img src=&quot;https://opengraph.githubassets.com/2f72d8ff8e79b72c9177bb65cd265b57145ced504d5310b2e47d16119349b8ef/Alexays/Waybar&quot; alt=&quot;&quot; loading=&quot;lazy&quot;&gt;
    &lt;/div&gt;
    &lt;div class=&quot;embed-card-content&quot;&gt;
      &lt;div class=&quot;embed-card-title&quot;&gt;GitHub - Alexays/Waybar: Highly customizable Wayland bar for Sway and Wlroots based compositors. :tada:&lt;/div&gt;
      &lt;div class=&quot;embed-card-description&quot;&gt;Highly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada: - GitHub - Alexays/Waybar: Highly customizable Wayland bar for Sway and Wlroots based compositors. :tada:&lt;/div&gt;
      &lt;div class=&quot;embed-card-meta&quot;&gt;GitHub &amp;middot; github.com&lt;/div&gt;
    &lt;/div&gt;
  &lt;/a&gt;
&lt;/div&gt;