SpotiFLAC
v...
Fetch Spotify track metadata and retrieve matching lossless audio through configurable Tidal, Qobuz & Amazon Music provider backends.
RECENT FETCHES

Explore

Terminal Logs
--:--:-- SpotiFLAC ready.

Local Auto-Tagger

Target Directory
Drag & drop a folder or audio file here, or paste a path below

Paste (or drop) the folder or file you want to fix. Supported formats: FLAC, MP3, M4A/AAC, OGG Vorbis, Opus, WAV, AIFF, WMA, WavPack, Monkey's Audio, Musepack, TrueAudio. SpotiFLAC will scan them, find the correct Spotify metadata, and let you compare before applying changes.

Library Duplicates

Groups every copy of the same recording in the folder above — by ISRC, then by artist/title and duration for the files that have none — and keeps the best copy of each. Fast enough for a library of thousands, where the fingerprint scan is not.

Following

Follow an artist or a playlist

Paste a Spotify artist or playlist link. What already exists is recorded as seen, so the first thing downloaded is the first release — or the first track added to the playlist — after you follow, not the whole back catalogue. Use Reset on a row if you do want everything.

Pick Check every… to have it checked on its own and new items downloaded automatically, with the download settings you have when you set it (or last press Check & download).

Followed artists & playlists
Loading…

Your library

Built from what this install has actually downloaded. Genre, release year and duration are only recorded for downloads made since this feature landed, and a genre needs metadata enrichment to have been on — each section says how much of your history it could use.

Loading…

Settings

Logging
Log Level
Quality
Audio Quality
Auto quality fallback
Verify Hi-Res authenticityFlags files that declare 96 kHz but whose content stops at CD range (upsampled), and 24-bit files that are really a padded 16-bit master. Adds a few seconds of analysis per track
Appearance
Color Mode
Accent ColorDefault: Green
Preview VolumeThe 30-second clips played from the ▶ button on a track
100%
App FontDefault: JetBrains Mono
Preview: The quick brown fox jumps over the lazy dog.
Audio Sources
Source priority (drag to reorder)
Transcoding
Output formatConverted after download — requires ffmpeg
Performance
Parallel downloadsTracks fetched at the same time (CLI: --max-concurrent)
Retry & Loop
Extra retries per trackCycles through all providers
Loop failed tracks everyN minutes (0 = disabled)
Post-Download Action
Action
Auth & Custom APIs
Custom Qobuz APIOptional self-hosted Qobuz stream API
Not set
Custom Tidal APISelf-hosted hifi-api instance
Not set
AcoustID API keyOptional. Identifying untagged files uses a key shared by all users, capped at 3 lookups/second between everyone; your own key gets its own budget. Free from acoustid.org/new-application
Profiles
Save
Load
Delete
Download Location
~/Music/SpotiFLAC
Filename Format
{title} {artist} {album} {album_artist} {year} {track} {disc} {isrc} {position}
Add track number to filename
Folder Organization
Artist subfolders
Album subfolders
Playlist subfolders
First artist only in tags & filename
Artist Separator(e.g. ", " or " / ")
Lyrics
Embed synced lyrics (LRC)
Lyrics Providers
Apple: word-by-word sync(off = line-by-line sync)
Metadata Enrichment
Enrich metadata (genre, BPM, HD cover…)
Enrichment Providers
SpotiFLAC

Check endpoint reachability for each SpotiFLAC provider.

No checks yet
Extensions Centralized service used by SpotiFLAC extensions.
Extension Health

How each provider has actually behaved on this machine — attempts, how often they worked, how long they took, and what the last failure said. Worst first. An extension listed as never tried is not broken; nothing has reached it yet, usually because another provider earlier in your service order keeps succeeding first.

Loading extension health…
Signed Sessions

The verified sessions extensions use to talk to their gateway, and when each one expires. An expired session is renewed with a new verification the next time it is needed. Orphaned ones were left behind by an extension update and are never used again.

Loading signed sessions…
Extension Registries

Registry URLs tell SpotiFLAC where to look for installable extensions. Sources can come from a terminal export, from a .env file, or be added here. You can remove any of them, including ones set outside the app.

Loading registries…
Discover Registries

A directory lists registries (not extensions directly) for you to review. Nothing here is bundled either — add a directory URL someone shared with you, then click Discover to probe each registry it lists for reachability before deciding whether to add it above.

Loading directories…
Trusted Signing Keys

A registry's sha256 checksum proves a package wasn't corrupted in transit — it says nothing about who published it. Trust a maintainer's public key here to verify their signed entries too; unsigned entries are exactly as trusted as they are today.

Loading trusted keys…
0.00 MB
Idle