MagicPodsCore for Linux

Backend service exposing a WebSocket API for managing AirPods, Beats, and Galaxy Buds.

🎨 Features

🔋Battery level
⚙️ Noise control

🔥 Exclusive to AirPods and Beats

• Conversation awareness
• Personalized volume
• Noise level adjustment in adaptive mode
• Noise cancellation with one AirPod
• Press duration adjustment
• Press and hold duration adjustment
• Customization of single and double tap for call control

🎧 Headphones supported

| Apple | Beats | Samsung | | ---------------- | ---------------------- | ----------------- | | AirPods 1 | PowerBeats Pro | Galaxy Buds | | AirPods 2 | PowerBeats Pro 2 | Galaxy Buds Plus | | AirPods 3 | PowerBeats 3 | Galaxy Buds Live | | AirPods 4 | PowerBeats 4 | Galaxy Buds Pro | | AirPods 4 (ANC) | Beats Fit Pro | Galaxy Buds 2 | | AirPods Pro | Beats Studio Buds | Galaxy Buds 2 Pro | | AirPods Pro 2 | Beats Studio Buds Plus | Galaxy Buds Fe | | AirPods Pro 3 | Beats Studio Pro | Galaxy Buds 3 | | AirPods Max | Beats Solo 3 | Galaxy Buds 3 Pro | | AirPods Max 2024 | Beats Solo Pro | | | | Beats Studio 3 | | | | Beats X | | | | Beats Flex | | | | Beats Solo Buds | |

Some of the headphones in the table do not have or do not support the noise control feature.

🚀 Getting started

For Ubuntu or Steam OS:

Build

git clone https://github.com/steam3d/MagicPodsCore.git && \
cd MagicPodsCore && \
docker build -o . . && \
chmod +x magicpodscore

Run

./magicpodscore

Connect to 172.0.1.0:2020 WebSocket and use the API reference below to communicate with MagicPodsCore.

📘 API reference

Complete reference for the MagicPodsCore WebSocket JSON API.

📄 api-reference.md

Example frontend projects using the MagicPodsCore:

• MagicPodsDecky
• MagicPodsPlasmoid

🧪 Ideas and bugs

In the Discord community you can suggest an idea or report a problem.

🩼 Known issue

Stuck when running through VirtualBox.

💰 Donate

Support the project here — every bit helps ❤️

💖 Developers

Developed by Aleksandr Maslov and Andrey Litvintsev