andreknieriem /open-headunit
Headunit App for displaying Android Auto
★ 3,383⑂ 331👁 33⑃ 463● 720▤ 115
+35
日增长
3,383
stars
331
forks
33
watchers
463
prs
720
issues
115
releases
README
Open Headunit
Open Headunit is an Android app that allows you to turn your Android tablet or phone into an Android Auto receiver. This project is a revived version of the original headunit project by the great Michael Reid. The original project can be found here:
https://github.com/mikereidis/headunit
It runs on Android 4.1 and newer (Android 5.0 and newer for the Play Store build). Besides the stores above, you can download APKs from the Releases page.
Contents: How to use · Known Issues · Planned · Changelog · Contributing
NOTE!
Android Auto 17.4 and newer can prevent legacy wireless triggers from launching projection, including Self-Mode and automated startup via Wireless Helper. Rooted devices have a workaround: re-enable Android Auto's wireless startup receiver.
Use a USB wireless dongle, Native Mode or the Headunit Server instead. Wireless Helper works up to Android Auto 17.3, or on 17.4+ with the root workaround. See Wireless Connection Options.
Screenshots
How to use
Check out the Wiki for detailed documentation, setup guides and troubleshooting!
Wired USB Connection
- Connect your Android device (phone) to the tablet running Open Headunit via USB cable.
- Make sure that Android Auto is installed on your phone.
- Set your phone to Host-Mode if necessary and select Android Auto
- Click the USB Button in Open Headunit, find your phone and click the right button to allow connection
- Click on your phone in the list and wait for Android Auto to start
Once a phone is set up, plugging it in connects by itself. You can change this in the Auto-start settings with Connect when plugged in.
Wireless Connection Options
Choose from the five options below depending on your Android Auto version and setup:
1. USB Wireless Android Auto Dongle (Most Reliable)
- A standard hardware USB Wireless Android Auto Dongle (plugged into the headunit) handles the entire wireless negotiation independently.
- Provides seamless plug-and-play connection regardless of phone Android Auto version.
2. Native Mode (Wi-Fi Direct / Headunit Hotspot)
- Directly communicates with Android Auto's native wireless protocol without helper apps.
- Supports Wi-Fi Direct (P2P) or the Headunit Hotspot transport.
- Configure under Open Headunit Settings - Wireless Connection - Wireless Mode - Native.
- Native Mode starts over Bluetooth, then moves to WiFi. Detect automatically fits most units. Units that keep Bluetooth on a separate module, or that use a relay, take one of these routes:
- ZLink module (experimental): units with a ZJ/ZLink Bluetooth service on port 3152.
- ZJ socket: Unisoc units whose module uses /dev/socket/zj_bt_socket.
- FYT BLINK module (experimental): FYT units with a separate module, such as DUDUAUTO on DUDUOS.
- HCT service: units with a verified HCT Bluetooth service, without root. The app detects it by itself.
- ESP32 relay: an original ESP32 relays the handshake. Firmware: aa-native-bt-broker-for-openheadunit.
3. HeaduTop issues
#1136New home screen: launcher mode in the wizard, shortcuts and widgets in the favorites row, a shorter exit menu in launcher mode25 comments · 2026-10-19#1099Audio Issues on Mgear Mstick422 comments · 2026-10-11#585Navigation stream on a virtual display?20 comments · 2026-06-06#1122Auto-start, next step: optional root tools so the head unit stops killing the app19 comments · 2026-10-15#1085Need to forget car every connection13 comments · 2026-10-09#1278Weird display resolution difference between wired and wireless (headunit server) connections11 comments · 2026-11-12#1194USB permission popup keeps appearing – Open Headunit 4.0 Alpha11 comments · 2026-10-26#1059Headunit Revived Log Analysis: Spotify audio stuttering and transport link drops (v3.5.0-beta2)11 comments · 2026-10-05
Discussions
#1271Hybrid mode?1 comments · 2026-11-10#1268Open headunit wifi mode working after the Android Auto update version 180 comments · 2026-11-07#1264Bluetooth connectivity1 comments · 2026-11-07#1225THANKS A LOT2 comments · 2026-10-29#1202AARE - Anyone tested this Android Auto clone?1 comments · 2026-10-27#1201Feature: Speed Adjusted Volume0 comments · 2026-10-27#1161What is native android auto? how does it work vs headunit server or wireless helper?1 comments · 2026-10-22#1125Hacks for specific HU1 comments · 2026-10-17
Latest release
4.0.0 v.4.0.0 2026-11-10- New Homescreen, favorites under the card on 16:9 units, and drawer tabs for shortcuts, thanks to @andrecuellar - Home: a separate switch for the widgets, and a panel opacity slider - Settings: redesign the screen in Material 3 and make the accent blue, thanks to @andrecuellar - Settings: a help button on every setting, sections ordered by use, a rail that folds to its icons, and one Bluetooth choice for Native AA - Settings: remove the Fake Speed switch that did nothing, thanks to @teodortomas - Wizard: test the decoder before recommending settings, thanks to @andrecuellar - Status pil