A powerful Bluetooth backend with a simple WebSocket API for AirPods, Beats, Galaxy Buds, and Pixel Buds.
Build your own apps without dealing with complex Bluetooth protocols, or get started instantly with our ready-to-use apps below.
- MagicPods for Linux - Desktop application with battery monitoring, case-opening animations, noise control, and advanced headphone settings.
- MagicPods for Decky Loader - Plugin for controlling headphones directly from Steam Gaming Mode.
- Battery levels and charging status
- Noise control
- Bluetooth adapter management
- Headphone connection and disconnection
- Bluetooth audio profiles and codecs
- Device information and capabilities
- WebSocket JSON API with commands and events
- HD Microphone
- Conversation Awareness
- Personalized Volume
- Adaptive Audio
- Custom Equalizer
- Noise Cancellation with One AirPod
- Earbud Noise Control Modes
- Off Listening Mode
- Press-and-hold actions
- Press speed and press-and-hold duration
- Volume swipe gestures
- Call controls
- Digital Crown direction
- Stem press events
- Case-opening events
- Ear detection
- Audio output switching
- Headphone tone volume
- Sleep detection
- Optimized charging
- Hearing protection
- Firmware information
Feature availability depends on the headphone model and firmware.
| Apple | Beats | Samsung | |
|---|---|---|---|
| AirPods 1 | PowerBeats Pro | Galaxy Buds | Pixel Buds A-Series |
| AirPods 2 | PowerBeats Pro 2 | Galaxy Buds Plus | Pixel Buds Pro |
| AirPods 3 | PowerBeats 3 | Galaxy Buds Live | Pixel Buds Pro 2 |
| AirPods 4 | PowerBeats 4 | Galaxy Buds Pro | Pixel Buds 2a |
| AirPods 4 (ANC) | Beats Fit Pro | Galaxy Buds 2 | |
| AirPods 5 | Beats Studio Buds | Galaxy Buds 2 Pro | |
| AirPods 5 (WCC) | Beats Studio Buds Plus | Galaxy Buds FE | |
| AirPods Pro | Beats Studio Pro | Galaxy Buds 3 | |
| AirPods Pro 2 | Beats Solo 3 | Galaxy Buds 3 Pro | |
| AirPods Pro 3 | Beats Solo Pro | Galaxy Buds Core | |
| AirPods Max | Beats Studio 3 | Galaxy Buds 3 FE | |
| AirPods Max 2024 | Beats X | Galaxy Buds 4 | |
| AirPods Max 2 | Beats Flex | Galaxy Buds 4 Pro | |
| Beats Solo Buds | |||
| Beats Solo 4 | |||
| Beats 360 | |||
| Powerbeats Fit |
Some headphones support only basic features, such as battery monitoring and audio profile selection.
Build
git clone https://github.com/steam3d/MagicPodsCore.git && \
cd MagicPodsCore && \
docker build -o . . && \
chmod +x magicpodscoreRun
./magicpodscoreConnect to the WebSocket server at 127.0.0.1:2020 to send commands and receive events.
Explore the WebSocket API, available commands, events, and JSON examples.
MagicPodsCore may become unresponsive when running inside VirtualBox.
Developed by Aleksandr Maslov and Andrey Litvintsev.