skills.rest
milojarow
milojarowCOMMUNITY
Explore all skills by this author →
GitHub

sway-bar

Configure Swaybar appearance and implement the JSON status line protocol.

Updated Aug 23, 2026
Search Tags:#configuration#wayland#sway#status bar#swaybar#json protocol
One-click install
npx skills add https://github.com/milojarow/dotfiles --skill sway-bar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sway-bar
Source: https://github.com/milojarow/dotfiles/tree/main/.claude/skills/sway-bar
Command: npx skills add https://github.com/milojarow/dotfiles --skill sway-bar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill simplifies the complex task of configuring the Sway status bar (swaybar) and implementing custom status information using the JSON protocol, ensuring a visually appealing and informative desktop experience.

Core Features & Use Cases

  • Swaybar Configuration: Customize bar position, mode, fonts, colors, and workspace button appearance.
  • JSON Status Protocol: Implement dynamic status updates for time, system info, battery levels, and more, with rich text formatting and click events.
  • Use Case: You want your Sway desktop to display the current time, battery percentage, and network status in a custom color scheme at the top of your screen. This Skill provides the configuration and script examples to achieve that.

Quick Start

Configure your swaybar to display the current time and battery status using the provided examples.

Frequently Asked Questions about sway-bar

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

FAQPage Schema
How do I configure the sway status bar to display custom system information?▼

You can configure the sway status bar by defining bar position, fonts, colors, and workspace buttons, while using the JSON status line protocol to generate dynamic updates for system info like battery and time.

What is the JSON protocol used for swaybar status updates?▼

The swaybar JSON protocol is a specification for formatting dynamic status text and handling click events, allowing custom scripts to push rich text updates directly to the Sway window manager status bar.

Can I customize workspace buttons and system tray integration in Sway?▼

Yes, swaybar configuration supports customizing workspace button appearance and enables system tray integration, allowing you to modify how workspace switchers and tray icons appear on your bar.

How do I handle click events for status bar modules in Sway?▼

Click events are handled through the swaybar JSON protocol, which defines specifications for capturing user interactions with status modules and triggering corresponding dynamic updates or scripts.

Does this swaybar configuration require external dependencies to display battery and network status?▼

No external dependencies are required; the configuration uses provided script examples to implement custom status generators that query and display battery levels and network status via the JSON protocol.

Related Skills

Explore More Software Engineering Skills→
kettleofketchupkettleofketchup

sway

Configure a stable Sway Wayland compositor session on NixOS.

Community
Advanced
RuanBuitendag42RuanBuitendag42

waybar-widgets

Implement Waybar widgets and themes for Hyprland using CSS and JSON definitions.

Community
Advanced
bughqbughq
2

stacks-desktop

Configure desktop windows and system trays via Tauri integration in Stacks.

Official
Intermediate
qdoubleqdouble

antigravity-extension-install

Install Antigravity/VS Code extensions via VSIX, copy, or scripts and configure status bar buttons.

Community
Intermediate