airpods-emulator
Ingeniería inversa del protocolo Continuity de Apple sobre BLE (C + Rust) y baliza Find My/OpenHaystack para Linux.
Ingeniería inversa del protocolo Apple Continuity (los paquetes BLE de proximidad que hacen aparecer los modales de emparejamiento de AirPods, AirTag, Apple TV, etc. en un iPhone cercano) y del formato de baliza Find My / OpenHaystack. Tres implementaciones, del mismo problema:
| Componente | Qué es |
|---|---|
airpods_max.c |
Prueba de concepto original en C: un solo perfil (AirPods Max), socket HCI raw sobre hci0. |
airpods_rust/ |
Reescritura más completa: 8 perfiles de dispositivo (AirPods Max/Pro/3.ª gen, AirTag, Transferir número, Apple TV, Vision Pro), rotación de MAC entre anuncios, modo carrusel. |
openhaystack/ |
Baliza OpenHaystack nativa para Linux: genera un par de claves EC (secp224r1), calcula la clave de anuncio derivada y emite el paquete BLE que hace que dispositivos Apple cercanos reporten la ubicación de "la baliza" a la red Find My — o simplemente dispara el modal de "nuevo AirTag detectado" sin emitir de verdad. |
⚠️ Uso responsable
Esto emite paquetes BLE reales que cualquier iPhone en alcance recibirá — no hay forma de dirigirlo a un solo dispositivo por consentimiento, solo por proximidad física. Es una herramienta de investigación del protocolo, probada en el propio dispositivo del autor a pocos centímetros de la antena:
- No lo uses en espacios públicos ni para molestar a terceros — un iPhone ajeno recibe el mismo paquete que el tuyo.
- La baliza de
openhaystack/genera y usa su propia clave privada local (openhaystack/airtag_key.json, no versionada — se regenera con--new-key); esa clave no debe compartirse, porque quien la tenga puede descifrar los reportes de ubicación de esa baliza.
Requisitos
- Linux con adaptador Bluetooth accesible por HCI raw (
hci0) — probado sobre MediaTek MT7925 / Mercusys MA37BE. - Root (
sudo) — el socketAF_BLUETOOTH/BTPROTO_HCIen modo raw lo exige. - Rust estable, o
gcc, según qué implementación uses.
Compilar y ejecutar
C (perfil único, AirPods Max):
gcc -O2 -o airpods_max_c airpods_max.c
sudo ./airpods_max_c
Rust (todos los perfiles):
cd airpods_rust
cargo build --release
sudo ./target/release/airpods_rust # menú interactivo
sudo ./target/release/airpods_rust --max # directo a AirPods Max
sudo ./target/release/airpods_rust --airtag # modal de AirTag
sudo ./target/release/airpods_rust --setup # "Transferir número / Configurar iPhone"
sudo ./target/release/airpods_rust --carousel # alterna entre perfiles
OpenHaystack (baliza Find My):
cd openhaystack
python3 openhaystack_airtag.py --new-key # genera tu propio par de claves (no se versiona)
python3 openhaystack_airtag.py --info # ver clave pública / MAC derivada
python3 openhaystack_airtag.py --popup # solo el modal de "nuevo AirTag", sin baliza real
python3 openhaystack_airtag.py --beacon # baliza real, reporta a la red Find My
Cómo funciona
Los tres programas abren un socket AF_BLUETOOTH / BTPROTO_HCI en modo raw sobre el
controlador Bluetooth local y envían comandos HCI de publicidad BLE (LE Set Advertising Data /
LE Set Advertising Enable) con los bytes exactos que Apple usa en sus paquetes de proximidad —
el mismo mecanismo por el que un iPhone real detecta unos AirPods reales al abrir la tapa cerca.
La baliza Find My sigue además el formato público que documentó el proyecto académico
OpenHaystack (SEEMOO, TU Darmstadt) para calcular la
clave de anuncio a partir del par de claves EC.
Licencia
MIT © 2026 macorredor270. Úsalo solo con tus propios dispositivos: ver la sección Uso responsable.