A console application for controlling AirPods and a description of the AAP protocol (Apple Audio Protocol).
If you are using MagicPodsDecky, please use the Decky branch for backward compatibility. The backend will be rewritten in Python in the master branch.
Install the required packages:
pip3 install asyncio textual
Clone the repository:
git clone https://github.com/steam3d/MagicPodsCore.git
Go to the repository directory:
cd MagicPodsCore
Run main.py and pass your AirPods' MAC address as an argument:
python3 main.py AA:BB:CC:DD:00:00
Connect your AirPods and run the Python script (see the installation section). The console application will connect to the headphones, and you're ready to go.
Interface is divided into the following parts:
The header contains information about the connected device:
- MAC address
- Noise control mode
- Battery level
Use the Tab key to select the packets tree. Select the necessary packet with the arrow keys and press Enter to send it to the AirPods.
Use the Tab key to select the logger panel. Use the arrow keys to move between log messages.
Use the Tab key to select the input field. Write the hex packet and press Enter to send it to the AirPods.
Linux only.
- AirPods 1
- AirPods 2
- AirPods 3
- AirPods 4 ANC
- AirPods Pro
- AirPods Pro 2
- AirPods Max
- AirPods Max 2024
- Beats Headphones
- Noise Control
- Noise Cancelling
- Transparency
- Off
- Accurate Battery Status
Join the MagicPods Discord server