Cache, Search, Sync
spotuify keeps Spotify metadata locally so the CLI and TUI can answer quickly. SQLite is the cache. Tantivy is the rebuildable search index.
Sync data
Section titled “Sync data”spotuify syncspotuify sync library --format jsonspotuify sync playlists --format jsonSync targets:
spotuify sync playbackspotuify sync devicesspotuify sync recentInspect cache
Section titled “Inspect cache”spotuify cache status --format jsonWhat you get: database path, index path, row counts, search result counts, lyrics cache counts, cover cache size, and last sync/search timestamps.
Rebuild the search index
Section titled “Rebuild the search index”spotuify reindex --format jsonUse this when SQLite has data but local search looks empty or stale.
Repair cache
Section titled “Repair cache”spotuify cache repair --format jsonWhat you get: schema repair plus a local index rebuild.
Reset cache
Section titled “Reset cache”This deletes local cache files. It does not delete Spotify data.
spotuify cache reset --confirmAfter reset:
spotuify sync allspotuify cache status