Find the failure stage
| Symptom | Start here |
|---|---|
| Never enters CarPlay | Cannot connect → permissions, selected method, pairing |
| Works briefly, then restarts | Disconnecting → timing, handoff, overlays |
| All sound stays on phone / no guidance | No sound → media versus navigation routing |
| Music skips or cuts out | Audio stutter → video load, link comparison, diagnostics |
| Charging but no session | USB not working → data path, prompts, reported iOS combination |
| Fails creating wireless group | Wi-Fi Direct → Android version, API error, firmware radio support |
Save a useful report
Signing matches 0.2.21; update com.shihab.diplay in place to keep settings and pairing. Reproduce on 0.2.22, then Settings → Diagnostics → Save diagnostic report or Get the report on a phone. Android 7.0–9 requests storage access; Android 10+ normally saves to Downloads/DiPlay. Review before sharing; no automatic upload. View report and Share remain available if saving fails.
Record exact app version, car/year, head unit/firmware, Android, iPhone/iOS, wired/wireless and hotspot/P2P method, plus time to failure. Review the log for identifiers before posting publicly.
A closed issue, a proposed PR, or a request to test an update does not prove the problem is fixed on your vehicle.
0.2.22 — Improves launcher-bubble bounds, Han music rhythm, settings backup/search and diagnostics. Korean and Turkish bring the app to eleven languages. Reports show connection causes, microphone sources and log drops; review full saved reports before sharing.
Common questions: first actions
Consider 0.2.22 for 0.2.21 hotspot connection failures or fast/stuttering music, USB voice recordings and reconnects. Test the exact APK and firmware while parked; individual contributor results do not validate the complete release.
Settings → Diagnostics → Get the report on a phone offers Download report through a QR code or an address and six-digit code. Five wrong codes block typed entry until the page is reopened; QR access continues. Review the report before sharing; no automatic upload.
| Question | Try first |
|---|---|
| APK parsing fails: what should I check? | Compare the actual Android/API and CPU ABI with this APK’s requirements. A 32-bit ARM system cannot use an arm64-only package. If they match, check the actual APK, full error and installer. Stop trying random packages; signature checks are not a required beginner step. |
| Stuck preparing CarPlay: which connection checks apply? | Enable iPhone Bluetooth, Wi-Fi and Siri; allow CarPlay and select the correct paired phone. Car hotspot needs its actual name/password; Wi-Fi Direct needs working head-unit P2P and permissions; only existing Wi-Fi needs both devices on a reachable LAN. Then try re-pairing, normal restarts or USB. Start the hotspot manually if needed; try an English name if a non-English name stalls. |
| Dragging feels slow: try 60 fps? | If DiPlay is set to 30 fps and dragging feels choppy, try 60 fps, apply and reconnect, then compare dragging a map or list. A user reported noticeably better response after changing from 30 to 60; the exact car/firmware is unknown. This changes DiPlay video frame rate, not the head unit screen refresh rate. If 60 fps causes dropped frames or excessive load, return to 30 fps, disable HEVC and reduce resolution as needed. Diagnose music dropouts separately. |
| New car icon blocks connecting, or an edge is blank? | Restore the default icon if connecting stopped after changing it; 0.2.18 resizes large images. Its Square corners, no safe area option can test edge gaps; Physical length affects iOS icon layout. Save and reconnect. For black video first disable HEVC/enabled video experiments, then follow the matching device issue. |
| How do I handle periodic music dropouts? | Compare Wi-Fi Direct with the car hotspot, then USB; prefer stable supported 5 GHz. More buffering adds delay and cannot replace lost packets. 0.2.18 fixes a separate AAC dropout case; retest the matching symptom, without assuming it fixes Wi-Fi firmware. |
| USB disconnects or shows no permission prompt? | Use a data port and short data cable, unlock iPhone and accept the actual USB/CarPlay/local VPN prompts. If charging or permissions restart, try Reduced/Low charging when available and reconnect. Idle read timeouts alone are normal; 0.2.18 fixes specific errors including USBMUX cancellation failure. |
| No music, Siri or sound after a call? | Test music, navigation, Siri, calls and post-call recovery separately. Check actual output, car source/volume and microphone permission. Audio-channel advice is firmware-specific. Try the hotspot for broken Wi-Fi Direct microphone audio; note call time if media does not recover so audio focus can be checked. |
| Wheel-key service stays “starting”? | Bring DiPlay to the foreground and check service status. 0.2.18 adds boot/foreground retries and foreground track controls on some units; working ADB does not prove service binding. #606 still reports failure on that version. Test foreground keys and background service separately. |
| HUD arrows work, but the cluster has no map? | HUD metadata and cluster video are separate features. Check exact DiLink/controller/firmware. Disable the cluster map if it hides vehicle speed or triggers reboots. The 0.2.18 speed overlay and FCE guidance experiments still have validation limits; do not assume all cars support them. |
| No boot launch, or reconnect needed after returning home? | First verify a manual launch connects. Separate boot launch, connect-on-open, USB launch and background allowlisting. Automatic hotspot startup depends on firmware. Disable an already-enabled fast mode for comparison; do not default to uninstalling, factory resets or promises to bypass background limits. |
Version notes for this guide
Full updates, older version details and their validation limits are now collected in the version history. Follow the links below for the complete notes.
- 0.2.22 · Full version details
- 0.2.21 · Full version details
- 0.2.20 · Full version details
- 0.2.19 · Full version details
- 0.2.18 · Full version details
- 0.2.17 · Full version details
- 0.2.16 · Full version details
- 0.2.15 · Full version details
- 0.2.14 · Full version details
- 0.2.13 · Full version details
- 0.2.12 · Full version details
- 0.2.11 · Full version details
- 0.2.10 · Full version details