Skip to content

Troubleshooting

Jump to bottom
ars edited this page Mar 13, 2026 · 8 revisions

Troubleshooting

If you encounter issues while using HeadUnit Revived, try the solutions below.

Video / Screen Issues

Black Screen / No Video

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".

Distorted Video / Green Artifacts / Pixelation

  • Solution 1: Change the View Mode in Settings -> Graphic to GLES20.
  • Solution 2: Change the Resolution in Settings -> Graphic.

Connection Issues

Connection Drops Immediately / Broken Pipe

  • 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).

Wireless Connection Fails (Manual Mode)

  • 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.

Wireless Connection Drops Frequently

If your wireless connection is established but drops after a few seconds or minutes, it is likely caused by a battery-saving or "smart" network feature on your phone.

  • Cause: Modern phones have features like "WiFi Assistant," "Switch to mobile data," or "Network acceleration." Since the WiFi network created by your headunit (or the hotspot) often doesn't provide internet access, the phone OS might decide to kill the WiFi connection to "help" you stay online.
  • Solution: Go to your phone's WiFi Settings -> Advanced/Additional Settings and disable features like:
    • "Switch between networks"
    • "WiFi Assistant"
    • "Network acceleration"
    • "Avoid poor connections"

Audio Issues

Audio stays on the Phone

The video is projected, but the music plays through the phone speakers.

  • Improvement in 1.14.1: We implemented MediaSession support and proactive audio focus requests. This ensures that HURev has higher priority and prevents other apps on the tablet from blocking the audio stream.
  • Solution 1: In Headunit Revived Settings, try toggling Use AAC Audio (OFF is usually more stable).
  • Solution 2: Clear any other music or radio apps from the background on your tablet/headunit device.
  • Solution 3: 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 4: Ensure Enable Audio Sink is turned ON in Settings.

Audio Stuttering

  • 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.

Touch / Input

Touch Not Working

  • Solution: Try changing the DPI in Settings -> Graphic. Setting it to 0 (Auto) usually works best.

Clone this wiki locally