KuroPlayer guide

How to use it

KuroPlayer plays and organizes your selected videos and music. Add media, customize covers and tags, and enjoy your collection.

1. Getting started

Open the library and tap “Add media from this device” at the top right. In the OS file picker, choose one or more video or audio files. What you add is recorded in an SQLite index on the device.

2. The library and search

The library can be shown as shelves or as a list. Video in a work folder, sharing a common file name, or numbered like “Episode 01” is treated as episodes of the same work. Cover art and synopses can be freely customized.

The search box at the top searches work names, folder names, episode numbers, track titles, tags, and synopses. Results come straight from the SQLite index, with background refresh if connected sources are stale.

3. Playing

Tap a work or a file to open the player. Use the seek bar to move, skip back 10 seconds or forward 30, and play or pause. Your position is saved per work, so next time you carry on from where you left off.

The in-playback menu

• Switch audio and subtitle tracks
• Add external subtitles, and adjust their position, size and timing offset
• Aspect ratio, zoom, rotation and playback speed
• Show media information and the decoder in use

4. Background play and PiP

Audio keeps playing when the app goes to the background. For video you can choose to continue with audio only, or use picture-in-picture. PiP is available on supported iOS and Android devices.

5. Clouds, SMB and the cache

Connected clouds and SMB shares do not have to be downloaded in full first. Only the range needed for playback is fetched as it plays, and what has been fetched stays as a cache. The storage limit and clearing the cache are managed in settings.

6. Supported formats

Settings > Supported formats shows what your particular device supports. H.264/HEVC and MP3/FLAC/AAC/WAV/ALAC are required. OS-native decoding comes first, and only the formats that need it are covered by a licensed software path.

7. If something goes wrong

If something will not play, check that device’s state under Settings > Supported formats. For files on a connected source, also check the network, whether the source is still signed in, and free storage. If the problem persists, tell support the file name, its format and your device information.