Support
Most problems have one of a handful of causes. Start here before writing to us.
Playback
A file shows a black screen but sound plays
This usually means hardware decoding failed on that codec. Open the player's menu → More and switch the decoder to software, or set Settings → Playback → Hardware decoding to Software only. If the file is HDR and the device lacks HDR support, colours may also look wrong; try software decoding first.
The app says the file cannot be played
Check the container and codecs with a tool like ffprobe. PurePlay supports the
formats listed on the features page. Files with unusual or broken
headers (partially downloaded, corrupt index) may still fail; re-download or repair the file.
Video stutters or drops frames
4K HEVC on a mid-range device is the usual cause. Try: Settings → Playback → Hardware decoding = Automatic, close other apps, and make sure the file is on internal storage rather than a slow SD card. If it still stutters, software decoding is doing the work — an older 4K file may simply be beyond the device.
Audio and video are out of sync
Use the player's audio-delay control: menu → Audio delay, then nudge in 0.5-second steps. See the sync guide for the full procedure.
Subtitles
How do I load an external subtitle file?
While playing, open the subtitle menu and choose Load subtitle, then pick the SRT, ASS/SSA or VTT file. Matching file names (video name + language code) are picked up automatically when they sit in the same folder.
Subtitles are out of sync
Open the subtitle category in the player and use the delay control — 0.5 seconds per tap, positive or negative, with a reset option. Details in the subtitle sync guide.
Music
The Music tab is empty although I have songs
Two causes: the audio permission was not granted, or the files are not indexed as music by Android. Grant access from Settings → Permission in the app, then reopen the tab. Files that are not flagged as music (ringtones, notification sounds) are intentionally hidden.
Album art is missing for some tracks
On-device artwork comes from the file's embedded picture. Tracks without an embedded image show a placeholder. Embedded art can be added with most tag editors without re-encoding the audio.
Permissions & privacy
Why does PurePlay need access to my media?
Android only exposes a device's videos and music to apps that hold the media read permission. PurePlay never asks for all-files access and never uploads your files; see the privacy policy.
I denied the permission and now see nothing
Open Android Settings → Apps → PurePlay → Permissions and allow Photos/Videos and Music/Audio. The permission dialog inside the app can only be shown once or twice before Android stops offering it.
Background & battery
Music stops when I lock the screen
Some manufacturers (Xiaomi, OPPO, vivo, Samsung) aggressively kill background apps. Allow PurePlay to run in the background in the system settings and disable battery optimisation for it. Playback is also kept alive by a visible notification — block that notification and the system may stop the service.
Updates
How do I update a side-loaded APK?
Download the new APK and install it over the existing app; data and history are preserved because every release uses the same signing key. If Android refuses, uninstall the old app — but note that uninstalling also removes local history.