open-headunit

# Open Headunit

<a href='https://play.google.com/store/apps/details?id=com.andrerinas.headunitrevived'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width="200"/></a>
<a href='http://www.amazon.com/gp/mas/dl/android?p=com.andrerinas.headunitrevived'><img alt='Available at Amazon Appstore' src='https://images-na.ssl-images-amazon.com/images/G/01/mobile-apps/devportal2/res/images/amazon-appstore-badge-english-black.png' width="200"/></a>

<p align="center">
    <img src="https://github.com/user-attachments/assets/579b7b03-23e0-4eda-a05d-c51d28a72113"
    alt="Headunit Logo"
    height="200">
</p>

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](https://github.com/andreknieriem/open-headunit/releases).

**Contents:** [How to use](#how-to-use) · [Known Issues](#known-issues) · [Planned](#planned) · [Changelog](#changelog) · [Contributing](#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](#wireless-connection-options).

## Screenshots
<img width="1280" height="800" alt="image" src="https://github.com/user-attachments/assets/6ed31626-480e-404f-ba7a-753b14230a02" />
<img width="1280" height="800" alt="image" src="https://github.com/user-attachments/assets/ce67584e-fcf6-4308-b11a-116780df47f7" />
<img width="1280" height="800" alt="image" src="https://github.com/user-attachments/assets/fc2870be-a173-4113-8187-4835bd564842" />


## How to use
**Check out the [Wiki](https://github.com/andreknieriem/open-headunit/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
Cho