configuring-waybar

Configure Waybar bars, modules, and CSS styling from official documentation.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/seanedwards/ai-dotfiles --skill configuring-waybar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-waybar
Source: https://github.com/seanedwards/ai-dotfiles/tree/main/waybar/skills/configuring-waybar
Command: npx skills add https://github.com/seanedwards/ai-dotfiles --skill configuring-waybar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Waybar users often struggle to configure the bar, manage configurations, and troubleshoot issues without consulting scattered docs. This Skill centralizes official Waybar references and presents guided steps.

Core Features & Use Cases

  • Official guidance across installations and configurations: from installation to module usage, CSS styling, and troubleshooting.
  • Config and style crafting: helps you write and validate config.jsonc and style.css for Waybar.
  • Troubleshooting workflows: provides step-by-step checks to resolve common problems.

Quick Start

Read the docs and compose a minimal Waybar config and style example to match your setup.

Frequently Asked Questions about configuring-waybar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Waybar modules using config.jsonc?

Waybar modules are configured by editing the config.jsonc file to define bar layout and module behavior. You can add built-in or custom modules, then validate the JSON structure to ensure the bar loads correctly on startup.

What is the best way to style Waybar with CSS?

Styling Waybar with CSS involves writing rules in the style.css file to customize module appearance, colors, and margins. The styling uses GTK CSS syntax, allowing you to target specific module classes for visual customization.

Why does my Waybar configuration not show changes after editing?

Waybar configuration changes require restarting the bar to apply. If the bar fails to reload, troubleshooting involves checking the config.jsonc syntax for errors and verifying module paths before running the restart command.

Do I need to install Waybar differently across Linux distributions?

Waybar installation varies across Linux distributions, requiring package managers like pacman or apt. After installation, the configuration process remains standard, but dependency availability and module support may differ depending on the system environment.

How does Waybar styling work with GTK CSS compared to web CSS?

Waybar styling uses GTK CSS, a subset of standard CSS, applied through the style.css file. While it supports familiar selectors and properties, it lacks web-specific features like flexbox, relying instead on GTK layout principles for bar rendering.

What's the best way to troubleshoot missing Waybar modules?

Troubleshooting missing Waybar modules requires checking the config.jsonc file for correct module names and verifying required dependencies are installed. The official documentation provides step-by-step checks to validate module configurations and resolve loading failures.