VIVI Music maintains two separate on-device caches: a song cache (streamed audio buffered for instant replay) and an image cache (album art and artist thumbnails). Downloaded tracks are stored in a third, independent download cache that is never auto-evicted. All three can be monitored and cleared from Settings → Storage.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/vivizzz007/vivi-music/llms.txt
Use this file to discover all available pages before exploring further.
How to Access
Storage Settings Reference
Downloaded Songs
These settings manage the permanent download cache — tracks you have explicitly downloaded for offline playback. This cache is never automatically evicted regardless of how full the device storage gets.| Setting | Preference Key | Description |
|---|---|---|
| Downloaded songs size | (computed at runtime) | Displays the total disk space currently used by all downloaded tracks. Updated live every 500 ms. |
| Clear all downloads | (action) | Removes every downloaded track from the device immediately. Triggers a confirmation dialog before executing. |
Song Cache
The song cache stores streamed audio segments so tracks can resume instantly without re-buffering. VIVI Music automatically evicts the oldest segments when the cache reaches its configured limit.| Setting | Preference Key | Type | Default | Description |
|---|---|---|---|---|
| Max song cache size | maxSongCacheSize | Int (MB) | 1024 (1 GB) | Upper bound for the streamed audio cache in megabytes. Available presets: Disabled (0), 128 MB, 256 MB, 512 MB, 1 GB, 2 GB, 4 GB, 8 GB, Unlimited. |
| Clear song cache | (action) | — | — | Evicts all buffered audio from the player cache immediately. Triggers a confirmation dialog. |
342 MB / 1.0 GB — or just the current size when the limit is Unlimited.
If you reduce the max song cache size below its current usage, VIVI Music displays a warning dialog showing how much data will be evicted. You must confirm before the new limit is applied.
Image Cache
The image cache stores album artwork, artist photos, and playlist thumbnails downloaded via Coil (VIVI Music’s image loading library). Like the song cache, it is automatically managed and evicts old entries when full.| Setting | Preference Key | Type | Default | Description |
|---|---|---|---|---|
| Max image cache size | maxImageCacheSize | Int (MB) | 512 | Upper bound for the artwork disk cache in megabytes. Available presets: Disabled (0), 128 MB, 256 MB, 512 MB, 1 GB, 2 GB, 4 GB, 8 GB. |
| Clear image cache | (action) | — | — | Clears cached artwork from disk. Preserves thumbnails for downloaded songs — the clear operation checks the local database and keeps image entries associated with downloaded tracks intact. |
Unlike the song cache clear, the image cache clear is smart: it reads your list of downloaded songs from the Room database and skips deleting their thumbnail and album art entries. Only thumbnails for non-downloaded content are removed.
Smart Storage Behavior
Auto-eviction
Both the song and image caches automatically evict their oldest entries when they approach the configured size limit. You do not need to manually clear them during normal use.
Download protection
The download cache (
downloadCache) is stored separately from the streaming cache (playerCache) and is never touched by automatic eviction, ensuring your offline tracks are always available.Disable caching
Setting max size to 0 (Disabled) immediately clears the respective cache and prevents VIVI Music from writing new entries. Useful on devices with very limited storage.
Unlimited mode
The song cache supports an Unlimited option that removes the size cap entirely. Not available for the image cache. Use with caution on storage-constrained devices.