DiPlay
English

Prepare while parked

  1. Check the car model/year, DiLink, Android and firmware versions in the head unit’s system information.
  2. Download the official APK from the project’s GitHub releases and install it using the method supported by your car. Installation restrictions depend on the car’s firmware.
  3. Open DiPlay and allow the permissions it requests for the features you use. Bluetooth/Nearby devices and Wi-Fi/Location support connection; microphone access is for Siri and calls, and notifications provide connection controls.
  4. Close other phone-projection apps. Keep Bluetooth and Wi-Fi on your iPhone, then pair it in the car’s Bluetooth settings.

Make the first connection

Built-in car hotspot is the default. Turn it on, preferably at 5 GHz, and save its exact name and password in Settings → Connection → Connection setup. Keep Bluetooth and Wi-Fi on, pair the iPhone with the car, then tap Connect phone and accept the CarPlay prompt. If the phone does not join automatically, try joining the car hotspot manually.

Legacy Wi-Fi Direct depends on firmware and cannot verify frequency: Android 7.0–9 in 0.2.21+, 7.1–9 in 0.2.15–0.2.20, and Android 9 in 0.2.13–0.2.14. Older Android still needs vehicle testing.

Existing Wi-Fi / Same LAN: first connect the car and iPhone to the same router or portable Wi-Fi in their system settings, then save the network name and password in DiPlay. Keep Bluetooth on. Use WPA2 or WPA2/WPA3 mixed mode and disable client isolation so the devices can communicate. DiPlay does not join the network for you.

USB: use a data-capable cable and a USB data port, choose Connect with USB, and accept Android USB access and the iPhone’s Trust/CarPlay prompts. Allow the local VPN if requested; it carries the USB connection and is not an internet VPN service. Basic CarPlay does not require ADB, though your car may require it to install apps.

0.2.22 — USB voice messages, Voice Memos and dictation use smaller microphone packets; vehicle confirmation is pending. Reconnect retries when the USB network opens; late wired startup can wait up to 45 s. This is a recovery limit, not a guaranteed connection time.

Check that everything works

Start with 30 fps, HEVC off and Default icon/text size. If the picture stutters, try 80% or 60% resolution. During a connection, confirm display changes with Apply and reconnect; when disconnected, save them for the next connection.

Check picture, touch, music, navigation voice, Siri and calls separately. Seeing the CarPlay home screen does not confirm that every feature works.

If Android says “There was a problem parsing the package”, the failure happened during installation. Check Android 7.0 or later, the official APK filename, a complete download and whether the car permits APK installation. Issue #113 contains this error but no confirmed cause or fix.

If automatic startup fails, open DiPlay manually first. Check the separate settings for opening after the car starts and connecting when the app opens, plus the car’s background permissions. In #118, the Qin owner later reported that a newer version resolved the problem; the exact version and full setup were not supplied, so this does not confirm a fix for every Qin.

Updating and reporting a problem

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.

For startup problems, restart the head unit and then open DiPlay manually to export the report. Include the car/firmware, Android, iPhone/iOS, connection method, steps and failure time. Review the report before sending it and leave out the hotspot password. Nothing is uploaded automatically.

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.

Keep a simple test record

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.

  1. Start with one connection method and default settings. Record the APK filename, car firmware and iPhone model and iOS version before changing anything.
  2. Test music, a navigation prompt, Siri and a call separately while parked. Record each result; a working picture does not establish that audio or the microphone works.
  3. Return to the car’s home screen, reopen DiPlay and check reconnection. Enable optional features one at a time, noting which change first causes a problem.

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.

Related GitHub issues

Closed does not necessarily mean fixed. The source is authoritative for later updates.

Your next step

Sources

View source details (5)