-
-
Notifications
You must be signed in to change notification settings - Fork 160
Troubleshooting
ars edited this page Feb 9, 2026
·
13 revisions
If you encounter issues while using HeadUnit Revived, try the solutions below.
The connection is established (audio works), but the screen remains black.
- Cause: Your device's hardware video decoder might be incompatible or failing to initialize correctly.
- Solution 1: Enable Force Software Decoding in Settings -> Video.
- Solution 2: Try changing the Video Codec setting from "Auto" to "H.264".
- Solution 1: Change the View Mode in Settings -> Graphic to GLES20.
- Solution 2: Change the Resolution in Settings -> Graphic.
- Improvement in 1.12.0: We implemented a new handshake logic with Socket Reuse. This should eliminate most "Broken Pipe" errors during startup.
- Solution: Ensure Battery Optimizations are disabled for both HeadUnit Revived (Tablet) and Wireless Helper (Phone).
- Note: If you are using a Phone Hotspot (10.x.x.x networks), manual connection (Port 5277) often fails due to phone-side routing bugs.
- Solution: Switch to Wireless Mode: Helper Mode in the tablet settings and use the Wireless Helper app on your phone.
The video is projected, but the music plays through the phone speakers.
- Solution 1: In Headunit Revived Settings, try toggling Use AAC Audio (OFF is usually more stable).
- Solution 2: Check your music app (e.g., Spotify) on the phone. Ensure the output device is set to "This Phone" or "Android Auto" and not redirected to another Bluetooth device.
- Solution 3: Ensure Enable Audio Sink is turned ON in Settings.
- Solution: Enable Use Native SSL in Settings -> Debug. This is significantly faster on older devices. Version 1.12.0 now uses 16KB page-aligned libraries for maximum compatibility.
- Solution: Try changing the DPI in Settings -> Graphic. Setting it to 0 (Auto) usually works best.