Symptom
Music skips words, breaks up or cuts out even while CarPlay remains connected.
Possible causes
Interference, radio firmware behavior and decoder stalls can all contribute according to upstream compatibility notes. High resolution, 60 fps or HEVC can add device-specific demands.
Quick checks
- Set 30 fps, turn Efficient video / HEVC off and keep Default icon/text size. Apply and reconnect.
- Try 80% resolution, then 60% if necessary, keeping other settings fixed.
- Use the car’s 5 GHz hotspot when available and compare USB. A supported frequency is useful to test, not a guaranteed cure.
- Save diagnostics after a repeatable sample, noting whether music alone or navigation/music together triggers it.
Reported results & workarounds
Keep the same phone, build and audio sample. Change only one setting or connection method per run, then record the result and duration. An improvement narrows the investigation; it does not prove the root cause.
| Reported setups | Reviewed build | Limits and open questions |
|---|---|---|
| BYD Seal 06 DM-i · #53 DiLink 5.0 · Android ? iPhone XS Max / iOS 18.7.1 | 0.2.7 Last verified: 2026-10-01 | Music stutters and skips words. Wireless method was not specified. Maintainer requested a 0.2.8 retest; no result in the captured thread. |
| BYD Song Plus DM-i · #131 DiLink 4.0 · Android 10 iPhone 14 Pro / iOS 27.0.1 | 0.2.9 Last verified: 2026-10-02 | The reporter describes music and navigation stutter over Wi-Fi Direct, but no noticeable stutter through the built-in car hotspot on the same setup. Calls, Siri and long-drive stability were not assessed; the cause and buffer retest remain unconfirmed. |
Version status
0.2.7 includes audio-reliability changes, while the current README still acknowledges occasional cutouts. Open PR #6 proposes buffer changes and is not included in the reviewed release.
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.
0.2.22 — Fixes 0.2.21 car-hotspot interface selection on DiLink 3.0/4.0 and fast/stuttering Wi-Fi music. Clear an old Hotspot interface workaround if no longer needed. Music clock checks on a test head unit do not validate every firmware.
Compare one change at a time
Calls, Siri and navigation use the correct 16 kHz playback clock. Failed initial call-microphone reads retry up to three times; background music uses a 0.1 s decoder wait. First setup chooses navigation stream 14 for DiLink 3/4 and 15 for DiLink 5, preserving saved choices.
- Separate music dropouts, choppy video and slow touch response. Play the same audio with the same phone and APK so the comparison addresses one symptom.
- Compare the car hotspot with Wi-Fi Direct, or USB with wireless. Record which connection stutters; smoother playback on one route does not establish a universal fix.
- For choppy video, turn off any enabled experimental decoder/display options and compare lower resolution or frame rate. Record touch response separately, and restore a setting if it does not help.
Version notes for this guide
0.2.18 — Music waits up to 0.5 s instead of discarding AAC after 10 ms. Default-off experiments offer clearer USB navigation voice (calls unchanged), disabling media-key audio focus (wheel keys may stop), and car phone audio for CarPlay/VoIP calls (not validated with a real CarPlay call).
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
Reported setups
The following are source reports, not a universal affected-car list. Unknown fields remain unknown.
iPhone XS Max / iOS 18.7.1 · DiPlay 0.2.7
Works with known issues
Music stutters and skips words. Wireless method was not specified. Maintainer requested a 0.2.8 retest; no result in the captured thread.
View original reportiPhone 14 Pro / iOS 27.0.1 · DiPlay 0.2.8
Works with known issues
The reporter describes music and navigation stutter over Wi-Fi Direct, but no noticeable stutter through the built-in car hotspot on the same setup. Calls, Siri and long-drive stability were not assessed; the cause and buffer retest remain unconfirmed.
View original reportiPhone 14 Pro / iOS 27.0.1 · DiPlay 0.2.8
Limited evidence
The reporter describes music and navigation stutter over Wi-Fi Direct, but no noticeable stutter through the built-in car hotspot on the same setup. Calls, Siri and long-drive stability were not assessed; the cause and buffer retest remain unconfirmed.
View original reportiPhone 14 Pro / iOS 27.0.1 · DiPlay 0.2.9
Works with known issues
The reporter describes music and navigation stutter over Wi-Fi Direct, but no noticeable stutter through the built-in car hotspot on the same setup. Calls, Siri and long-drive stability were not assessed; the cause and buffer retest remain unconfirmed.
View original reportiPhone 14 Pro / iOS 27.0.1 · DiPlay 0.2.9
Limited evidence
The reporter describes music and navigation stutter over Wi-Fi Direct, but no noticeable stutter through the built-in car hotspot on the same setup. Calls, Siri and long-drive stability were not assessed; the cause and buffer retest remain unconfirmed.
View original reportRelated GitHub issues
Closed does not necessarily mean fixed. The source is authoritative for later updates.