
Open-source Android Auto phone-side implementation with protocol reverse engineering, TLS mutual authentication, H.264 video projection, touch input injection, and sensor data streaming over USB AOA.
An open-source implementation of the Android Auto phone-side app. This app runs on your phone and projects to a car's head unit over USB, replacing Google's proprietary com.google.android.projection.gearhead APK.
This project is in early development. The protocol handshake, video projection, touch input and vehicle-data decoding all work against a real head unit. Connection stability is much improved (runs of 15–72 minutes recorded) but not yet proven — the head unit has been observed cutting USB power (VBUS) mid-session. See the docs below.
| Doc | Contents |
|---|---|
docs/protocol.md | AAP reference for this implementation. Framing, TLS, channel model, per-channel message catalogue, the sensor pub-sub model and its correlation hazard, video/focus/flow-control rules, and a summary of known ambiguities and traps. Start here. |
docs/connection-stability.md | Connection reliability. Protocol requirements the HU enforces; the two distinct disconnect signatures (HU VBUS cut vs. cable pull) and how to tell them apart; evidence log; ruled-out causes; reconnect/restart behaviour; instrumentation and log reference; sensors & telemetry; external research; and the prioritised TODO. |
docs/research.md | Ecosystem survey. History of Android Auto reverse-engineering, comparison of existing OSS projects (headunit-revived, aasdk, openauto, AACS…), head-unit-side vs phone-side, TLS/auth analysis, and APK reverse-engineering notes. |
AGENT.md | Guidelines for AI agents / contributors working in this repo. |
Keep these current — see AGENT.md.
"HU accepts/rejects" = this head unit's verified
SENSOR_START_RESPONSEfrom a clean 2026-10-24 run (27 requests / 27 responses, zero unmatched). An earlier 2026-10-23 table was invalid — responses were mis-correlated and shifted by three. Seedocs/connection-stability.md§5.
USE AT YOUR OWN RISK. This software is provided "as is", without warranty of any kind.