🍏 Unofficial Apple Ecosystem 🍏

A curated list of reverse-engineered Apple apps, protocols, libraries, and research projects.

---

📋 Disclaimer

This repository is dedicated to collecting and organizing high-quality, open-source projects that interact with Apple's proprietary Walled Garden. These projects are unofficial and not endorsed by or affiliated with Apple Inc. Use them at your own risk.

🚦 Status Indicators

Status	Description
🟢	Active / Stable: Ready for use or in active development.
🟡	Work in Progress: Functional but expect bugs, missing features, or slow updates.
🟠	Not supported: Functional but not supported anymore.
🔴	Archived / Patched: Abandoned, deprecated, or patched by Apple. Good for historical research.

🏷️ Tags

Projects are additionally tagged by their architecture.

Tag	Description
DC	Direct Connection: Native protocol implementation. Connects directly to Apple's servers without needing Apple hardware.
Cloud	Cloud Connection: Essentially a Relay running on someone elses devices.
Relay	Relay: Requires an intermediate Apple device (usually a Mac) running server software to bridge the connection to apple servers.
Bridge	Bridge: Connects Apple protocols to third-party platforms (e.g., Matrix, non-Apple smart home networks).
App	Application: A ready-to-use application.
Lib	Library: A framework or API wrappermeant for developers.
PoC	Proof of Concept: Research-grade tools and academic demonstrations.
FOSS	Free & Open Source Software.

---

📜 Table Of Contents

• 💬 iMessage & APNs
• 📍 AirTags & Find My
• 💨 AirDrop & AWDL
• 🤝 Continuity & Handoff
• 📺 AirPlay
• 🎧 AirPods & Peripherals
• 💡 HomeKit
• ☁️ iCloud

---

💬 iMessage & APNs

• 🟢 BlueBubbles Relay App FOSS - Highly polished cross-platform client and server (Android, Windows, Web) using private macOS API hooks for features like typing indicators, tapbacks, and effects.
• 🟢 OpenBubbles Relay DC App FOSS - A cross-platform messaging ecosystem aimed at bringing Apple platform services to Android and Desktop (Relay required for registering phone number)
• 🟡 Sunbird Cloud App - Brings iMessage to Android - similar to Beeper with imeessage-rustpush (you're probably better off with that route, it's more stable, has more features, and free)
• 🔴 AirMessage Relay App FOSS - Old Android and Web client. Less reliant on private APIs than BlueBubbles, resulted in high stability but fewer bleeding-edge features.
• 🟢 mautrix-imessage-rustpush DC Bridge FOSS - Fork of the Matrix-iMessage bridge that uses RustPush so it works without a relay.
• 🟢 mautrix-imessage Relay Bridge FOSS - A Matrix-iMessage puppeting bridge. Originally powered Beeper; bridges standard Mac Messages app databases into the federated Matrix protocol.
• 🟡 RustPush DC Lib FOSS - A memory-safe Rust implementation of the APNs and iMessage protocols.
• 🟡 PyPush DC Lib FOSS - The original implementation of the APNs and iMessage protocols built by JJTech.

📍 AirTags & Find My

• 🟠 OpenHaystack DC App FOSS - Framework for creating custom Bluetooth tracking beacons (ESP32/nRF5x) that utilize Apple's crowdsourced Find My network without official hardware.
• 🟢 AirGuard DC App FOSS - Privacy-focused Android app by SEEMOO Lab that reverse-engineers AirTag payloads to provide anti-stalking alerts on non-Apple devices.
• 🟠 FindMyHistory DC App FOSS - Extracts and locally visualizes location data retrieved from the Find My network.

💨 AirDrop & AWDL

• 🟠 OWL (Open Wireless Link) DC Lib FOSS - Open-source C implementation of Apple Wireless Direct Link (AWDL), integrating with the Linux networking stack.
• 🟠 OpenDrop DC PoC FOSS - Fully functional AirDrop implementation in Python. Allows peer-to-peer file sharing between standard iOS/macOS devices and Linux.

🤝 Continuity & Handoff

📺 AirPlay

• 🟢 Shairport Sync DC App FOSS - Highly reliable AirPlay audio receiver that syncs perfectly with Apple's multi-room audio protocols.
• 🟢 UXPlay DC App FOSS - Open-source AirPlay Mirroring server for Linux/BSD. Replicates the AirPlay video protocol to cast an iPhone screen to a Linux desktop.
• 🟢 pyatv DC Lib FOSS - Massive Python library that fully implements the Media Remote Protocol (MRP) and Companion Link, allowing Linux to pair with and control Apple TVs/HomePods.

🎧 AirPods & Peripherals

• 🟡 LibrePods DC App FOSS - Unlocks AirPods features (noise control toggling, ear detection, battery readouts) for Android and Linux by interpreting custom BLE payloads.

💡 HomeKit

• 🟢 Scrypted Relay Bridge App FOSS - High-performance video integration platform. The absolute gold standard for bridging non-Apple security cameras (Ring, UniFi, RTSP) into HomeKit Secure Video (HKSV) with native latency.
• 🟢 Homebridge Relay Bridge App FOSS - Extremely popular Node.js server that emulates the HomeKit Accessory Protocol (HAP) to bridge non-Apple smart devices into the iOS Home app.
• 🟢 HAP-python DC Lib FOSS - Complete implementation of HAP in Python, frequently used for creating virtual accessories on Linux servers.
• 🟠 esp-homekit DC Lib FOSS - Native, lightweight C implementation of HAP for ESP8266/ESP32 chips, allowing cheap microcontrollers to act as native HomeKit accessories.

☁️ iCloud

• 🟢 icloud-photos-downloader DC App FOSS - Mimics the Photos app to perform bulk, authenticated synchronizations of iCloud Photo Libraries.
• 🟢 pyicloud DC Lib FOSS - Updated fork of the Python wrapper for iCloud web service APIs.

---

🤝 Contributing

Contributions are welcome! If you find a new tool, or an existing project's status has changed, please open an issue or PR.