kai_ai (can1357/kAirPods) | MoltPulse

Back to Directory

kai_ai

Native AirPods integration for KDE Plasma 6 with real-time battery monitoring, noise control, and panel widget.

can1357/kAirPods00

MoltPulse

Based on repository activity, growth velocity and community engagement.

25

Growth2/30

Activity8/25

Popularity9/25

Trust7/20

200

Stars

High

Sentiment

Votes

200

README.md

kAirPods

Native AirPods® integration for KDE Plasma 6 powered by a modern, low-latency Rust backend.

<p align="center"> <img src="screenshot.png" width="300" alt="kAirPods panel widget showing battery levels and controls"/> </p>

✨ Features

🔋 Real-time battery monitoring for AirPods, AirPods Max, case, and individual earbuds
🔇 Noise control switching between ANC, Transparency, and Off modes
👂 Ear detection status and control
⏯️ Auto play/pause - Automatically pauses media when AirPods are removed and resumes when reinserted
🎨 Native Plasma integration with theme-aware panel widget
⚡ Zero-lag Bluetooth L2CAP communication for instant updates
🔧 System-wide D-Bus service architecture (no root required)

🚀 Quick Install

One-liner install (recommended)

curl -fsSL https://raw.githubusercontent.com/can1357/kAirPods/master/scripts/get.sh | bash

# With options:
curl -fsSL https://raw.githubusercontent.com/can1357/kAirPods/master/scripts/get.sh | bash -s -- --verbose --debug

Manual install

<details> <summary><b>Debian/Ubuntu</b></summary> </details> <details> <summary><b>Fedora</b></summary> </details> <details> <summary><b>Arch Linux</b></summary> </details> <details> <summary><b>Service won't start / No devices detected</b></summary> </details> <details> <summary><b>Permission denied errors</b></summary> </details> <details> <summary><b>Widget not showing up</b></summary> </details> <details> <summary><b>Battery not showing / Debug logging</b></summary> </details> <details> <summary><b>Full API Reference</b></summary> </details>

# Clone the repository
git clone https://github.com/can1357/kAirPods.git
cd kAirPods

# Run the automated installer
./scripts/install.sh

sudo apt install build-essential pkg-config libdbus-1-dev libbluetooth-dev

sudo dnf install gcc pkg-config dbus-devel bluez-libs-devel

sudo pacman -S base-devel pkgconf dbus bluez-libs

./scripts/install.sh

Check bluetooth group (installer handles this automatically):
```
groups | grep bluetooth
```

Check service logs:

systemctl --user status kairpodsd
journalctl --user -u kairpodsd -f

Ensure AirPods are paired via KDE Bluetooth settings first

Stop the service:

systemctl --user stop kairpodsd.service

Start in debug mode:

# Shows general debug info and all Bluetooth packets
RUST_LOG=kairpodsd=debug,kairpodsd::bluetooth::l2cap=trace kairpodsd

# Or use the full path if needed
RUST_LOG=kairpodsd=debug,kairpodsd::bluetooth::l2cap=trace /usr/bin/kairpodsd

Reproduce the issue:
- Put your AirPods in your ears (or just open the case)
- Wait about 30 seconds for the handshake and first battery message
- Copy the terminal output (you can redact MAC addresses like AA:BB:CC:DD:EE:FF)

Create config file:

mkdir -p ~/.config/kairpods
echo 'log_filter = "debug"' > ~/.config/kairpods/config.toml

Restart the service:

systemctl --user restart kairpodsd.service

View logs:

journalctl --user -u kairpodsd.service -b --no-pager

                             ┌─────────────────────────┐
                             │      Plasma Widget      │
                             │  (Kirigami / QML UI)    │
                             └───────────▲─────────────┘
                                         │  D-Bus IPC
                                         │
┌───────────────────────┐   manages   ┌──▼────────────────┐
│   plasmashell (GUI)   │◀────────────│   kairpodsd       │
│  + panel & widgets    │  systemd-u  │  (Rust service)   │
└───────────────────────┘             └──┬────────────────┘
                                         │  Bluetooth L2CAP
                                         │
                                   ┌─────▼───────┐
                                   │  AirPods    │
                                   └─────────────┘

# List connected devices
busctl --user call org.kairpods /org/kairpods/manager \
    org.kairpods.manager GetDevices

# Control noise mode
busctl --user call org.kairpods /org/kairpods/manager \
    org.kairpods.manager SendCommand ssa{sv} "AA:BB:CC:DD:EE:FF" "set_noise_mode" 1 "value" s "anc"

./scripts/install.sh --uninstall

curl -fsSL https://raw.githubusercontent.com/can1357/kAirPods/master/scripts/get.sh | bash -s -- --uninstall