
Polybar is a fast and easy-to-use status bar for X11 window managers.

## Features

- **Lightweight** - Minimal resource usage
- **Modular** - Enable only what you need
- **Themable** - Extensive customization options
- **Multi-monitor** - Support for multiple displays
- **Font icons** - Support for Nerd Fonts and icons

## Setup

Install via package manager:

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

# Arch Linux
sudo pacman -S polybar

# Fedora
sudo dnf install polybar

# Build from source
# See GitHub releases for latest version
```

## Configuration

Config file: `~/.config/polybar/config.ini`

Structure:

```ini
[bar/main]
width = 100%
height = 24
background = #1e1e2e
foreground = #cdd6f4

font-0 = "JetBrains Mono:size=10;2"
font-1 = "Font Awesome 6 Free:size=10;2"

modules-left = bspwm xwindow
modules-center = date
modules-right = volume network battery

[module/date]
type = internal/date
interval = 1
date = %Y-%m-%d
time = %H:%M
label = %date% %time%

[module/volume]
type = internal/pulseaudio
label-volume = VOL %percentage%%
```

## Launching

Add to your window manager startup:

```bash
# Kill existing
killall -q polybar

# Launch
polybar main &
```

## Common Modules

- **i3** - i3 workspace integration
- **bspwm** - BSPWM workspace integration
- **xwindow** - Active window title
- **xworkspaces** - EWMH workspace support
- **date** - Clock and calendar
- **alsa** / **pulseaudio** - Volume control
- **battery** - Battery status
- **cpu** - CPU usage
- **memory** - RAM usage
- **network** - Network status
- **temperature** - System temperature

## Custom Script Module

```ini
[module/custom-script]
type = custom/script
exec = ~/.config/polybar/scripts/custom.sh
interval = 5
label = %output%
```

## See Also

<div class="embed-card">
  <a href="/awesome/" class="embed-card-link">
    <div class="embed-card-content">
      <div class="embed-card-title">Awesome Window Manager</div>
      <div class="embed-card-description">Awesome WM - a highly configurable X11 window manager</div>
      <div class="embed-card-meta">Feb 7, 2026</div>
    </div>
  </a>
</div>


<div class="embed-card">
  <a href="/waybar/" class="embed-card-link">
    <div class="embed-card-content">
      <div class="embed-card-title">Waybar</div>
      <div class="embed-card-description">Waybar - a highly customizable Wayland bar</div>
      <div class="embed-card-meta">Feb 7, 2026</div>
    </div>
  </a>
</div>


<div class="embed-card embed-card-external">
  <a href="https://github.com/polybar/polybar" class="embed-card-link" target="_blank" rel="noopener noreferrer">
    <div class="embed-card-image">
      <img src="https://opengraph.githubassets.com/8279456c4727fd40b640f9a3531e8ad2416da1bf633589302f6bfb6d3e13f4fc/polybar/polybar" alt="" loading="lazy">
    </div>
    <div class="embed-card-content">
      <div class="embed-card-title">GitHub - polybar/polybar: A fast and easy-to-use status bar</div>
      <div class="embed-card-description">A fast and easy-to-use status bar. Contribute to polybar/polybar development by creating an account on GitHub.</div>
      <div class="embed-card-meta">GitHub &middot; github.com</div>
    </div>
  </a>
</div>

