Skip to content
DerekYang2Public

About

Fluent UI app for downloading lossless FLACs, metadata editing, audio format conversions, music source matching, spectral analysis, and more.

Topics

Resources

Stars

73 stars

Watchers

5 watching

Forks

Repository files navigation

FluentDL FluentDL

About • Installation • Authentication • Build • Wiki

Sample Webp

About

FluentDL is a Fluent UI desktop app for finding, matching, and downloading lossless audio (FLAC) at high speeds.

It automatically matches tracks across streaming services, gives you fine‑grained control over matches, and includes format conversion, lyrics, loudness normalization, metadata editing, and quality inspection.

FluentDL supports Deezer, Qobuz, Spotify, TIDAL, and YouTube.

Why FluentDL?

If you have your own credentials and don't need a website downloader:

  • Performance: native desktop downloader for fast, multi‑threaded saving.
  • Control: review matches, edit metadata, and inspect audio quality with spectrograms.
  • All‑in‑one workflow: search, preview, match, download, convert, and tag in one app.
Search
  • Look up songs and albums across the five online sources
  • Parse all tracks from an online link, with track/album/playlist links supported
  • Open songs/albums in preview sidebar to listen, download, or view metadata and available sample rates/bit depths
Local
  • View file metadata and technical audio specs in-depth
  • Edit file metadata, including option to change cover art
  • View file spectrogram to determine true lossless/quality
  • Convert between flac, mp3, aac, alac, vorbis, opus with specific bitrate or VBR
  • Run ReplayGain 2.0 with various settings
  • Search, preview, and download lyrics files (.lrc)
Queue
  • Matching between all possible combinations of online sources (e.g., convert Spotify and YouTube to Deezer equivalents)
  • Review matches and failures and find backups from other sources
  • Download tracks from Deezer, Qobuz, TIDAL, or YouTube at the quality available to your account
  • Create playlists or append queued tracks to owned playlists on Deezer, Qobuz, Spotify, and TIDAL
  • Inspect downloaded track spectrogram

See usage guide wiki to learn more.

Installation

Microsoft Store

You can download directly from the Microsoft Store for an easier and efficient update process.
Check out Releases to see full changelogs and sideloaded versions.

Store CLI (Windows 11 built-in)

Installation:

store install fluentdl

Update:

store update fluentdl

winget (Windows 10)

Installation:

winget install --id 9MX44KM97X7X --source msstore --accept-package-agreements --accept-source-agreements

Update:

winget upgrade --id 9MX44KM97X7X --source msstore --exact --include-unknown --accept-package-agreements --accept-source-agreements

Authentication

Note

Streaming services occasionally make changes to APIs, which may result in authentication issues. Check the Issues page for known problems and feel free to report them.

The authentication required depends on the sources and features you use.

Searching and converting

Open Settings > Authentication to configure each service. The Service Access card shows the search, playlist and download access available with the configured accounts and credentials.

Spotify catalog access can use the anonymous web player or your own developer credentials. TIDAL can use its signed-in account or catalog developer credentials, including the bundled credentials in official releases. Catalog credentials alone cannot write user playlists.

Playlist uploads

Queue > Upload creates a playlist or appends individual tracks to an owned playlist on the selected service. It skips duplicate IDs, excludes album rows and preserves the existing playlist's entries and metadata. It does not convert tracks or upload local audio files.

Sign in through Settings > Authentication before uploading. Spotify requires saved developer credentials and explicit account authorization; its refresh token is encrypted for the Windows user so sign-in can survive app restarts. See the Spotify setup notes for the callback URI and Development Mode account allowlist requirements. TIDAL reuses the account used for full downloads. Deezer and Qobuz reuse their configured account sign-ins.

Downloading

Authentication requirements for downloading varies for the sources. The type of account (free vs subscription) may also affect the audio quality available.

You do not have re-enter credentials each time because they are stored locally. They can be left alone for months or even longer, but may eventually expire or invalidate due to occasional web-player changes.

Service Downloads
Youtube No Authentication Required (128 kbps OPUS, similar to 192kbps MP3)
Deezer Free Account (128 kbps MP3), Premium Account (320 kbps MP3 and 16bit/44.1kHZ FLAC)
Qobuz Free Account (30 second preview), Premium Account (up to 24bit/192khz FLAC)
Spotify Not natively available. Use the Queue to convert song to other sources.
TIDAL Direct downloads require account sign-in and a subscription or trial with full-track access. Availability and quality depend on the account and track.

Retrieving Tokens

See the authentication wiki for a detailed guide.

Build

Only needed for developers who wish to customize source code.

To build and run the project on Visual Studio, see development wiki.

License

FluentDL is distributed under GPL-3.0 with its Spek.NET spectrogram component. See the third-party notices for the component's source and the retained MIT notice for earlier code.

About

Fluent UI app for downloading lossless FLACs, metadata editing, audio format conversions, music source matching, spectral analysis, and more.

Topics

Resources

Stars

73 stars

Watchers

5 watching

Forks

Releases

Used by

Contributors

Languages