Silverquark

Silverquark / waybar-airpods-module

Public

A simple waybar module to quickly connect airpods and see battery info

18
2
100% credibility
Found Feb 18, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A Waybar module that displays real-time AirPods battery levels for left, right, and case, with click-to-connect functionality over Bluetooth.

How It Works

1
🔍 Discover AirPods battery display

You want to see your AirPods battery levels right on your desktop status bar and find this handy free add-on.

2
📱 Pair your AirPods

Connect your AirPods to your computer through Bluetooth settings so they can talk to each other.

3
📝 Note your AirPods identifier

Find the unique code for your AirPods by checking your Bluetooth list, like their special name tag.

4
🛠️ Add it to your status bar

Place the add-on in your bar's personal folder, include it in your bar setup with the code, and choose how it looks.

5
🔄 Refresh your bar

Restart your desktop status bar with a quick close and reopen so the new feature loads up.

🎉 See live battery and connect easily

Now enjoy real-time battery levels for left bud, right bud, and case on your bar, plus click to connect or disconnect anytime.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is waybar-airpods-module?

This Python module adds a custom Waybar widget for AirPods battery monitoring, displaying left bud, right bud, and case levels with charging indicators in real-time—no polling required. It solves the hassle of checking AirPods status via Bluetooth menus by integrating directly into your Waybar status bar, complete with click-to-connect/disconnect and visual states like disconnected or connecting. Setup is straightforward: grab your AirPods MAC from bluetoothctl, drop it into a simple Waybar config file, and restart—works on Arch, Debian, or Fedora with BlueZ and PyGObject.

Why is it gaining traction?

Unlike generic Bluetooth modules, it taps Apple's Accessory Protocol for push notifications and precise battery data, plus smart features like auto-reconnect and duplicate-click prevention. Developers dig the simple Waybar config examples, easy Hyprland integration, and tooltip details that make it feel native. It's a simple GitHub repo that punches above its weight for AirPods users tired of clunky alternatives.

Who should use this?

Waybar users on Linux desktops running Hyprland or similar, especially Arch tinkerers with AirPods who want battery info at a glance without extra apps. Ideal for dotfiles enthusiasts customizing simple Waybar setups or students building simple GitHub projects around desktop configs. Skip if you're not on BlueZ-heavy distros or lack Python-GObject.

Verdict

Grab it if you match the profile—solid docs and simple Waybar theme integration make it a quick win despite 17 stars and 1.0% credibility score signaling early maturity. Tested mainly on AirPods 2nd Gen, so expect tweaks for broader use; treat as a simple GitHub workflow example to fork and improve.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.