Usage Guide
You may either search regular queries, or put a link to the playlist/song.
For regular queries, you may select the source to search from.
If you cannot find the track with the built-in search, you can resort to URLs from online. All web players have options to copy song links. For example, in the Qobuz web player, press the three dots beside a track and then Share:
Links of albums, playlists, and single tracks can be directly entered in the search bar (even if the source dropdown does not match).
Search with filters on artists, album, and song title. Not all fields are required, you may choose which filter(s) to apply. Search filters are officially supported for Deezer and Spotify. Qobuz and YouTube are manually implemented and may have worse results.
The buttons on the top are self-explanatory. Note, there is a knob on the edge which you can hold and drag to resize the preview:
You may directly download songs from the Preview buttons, or press Add to Queue if you wish to convert it to a different source or download multiple tracks.
- Album objects, can be enabled via the search source dropdown
Album Modeand only exist in the Search page for now. - Album mode causes searches to show albums instead of single tracks. You may then select to open them in preview sidebar, similar to tracks. From there, you can download the album or add to queue. Adding an album to queue adds all the album tracks to queue.
- Clicking into an album will show its metadata and tracklist in the preview sidebar.
- Selecting a track in the preview sidebar tracklist will play the song preview.
- Downloading albums and cover art is supported. Covert art downloading only happens if Album Subfolders is enabled (
Downloads > Subfolder Options > Album Subfolder Options).
To get started, add audio files using Add folder or Add files. You may additional use the Add X to queue button.
Click on a file in the list to open the Preview sidebar. The toolbar should have an Edit button:
This opens a menu to edit different fields and even change the cover art.
Press Add cover art to browse for an image file, otherwise the image will not be changed.
For field lists such as artist or genres, ; is typically used to seperate fields.
Example below:
Finally, remember to press save to apply the changes. It will automatically reload the updated file in local explorer page. It is recommended to not have these tracks playing in an app, which could lock the files.
Spek comes bundled with FluentDL. Press the Analyze button in the Preview toolbar:
If it is hidden, you may need to press the 3 dots to see more or resize your window.
This button will open the current file in Spek:
Files can be upsampled, meaning that the listed bitrate may be inaccurate. Here is a blog I found that decently explains how to use Spek to analyze files.
TODO.
Tracks are added from the Search or Local Explorer page.
The conversion menu is for matching between different streaming services. For example, if you want to download a playlist of Spotify tracks, but currently only have Qobuz credentials, you can convert them to Qobuz equivalents, then download. The converted tracks remain in the Queue, replacing the old ones.
You may select multiple inputs and only one output. All the input types will be converted to the output source. Example (convert Qobuz/Spotify tracks in Queue to Deezer equivalents):
Note that conversions do not always work because identical tracks cannot be found. The best is ISRC matching, which is a unique identifier given to releases. If an exact ISRC match cannot be found, FluentDL will resort to attempted matching looking at metadata, such as titles/artist names/album name/etc. However, this is not perfect and mistakes can occur.
After conversion, a result may either be success, warning, or error. Press on the tabs to see the lists:
- Success: An exact match was found using ISRC.
- Warning: An attempted match was made using metadata.
- Error: Both methods above failed, thus no match is found.
The status code colors will remain as notification circles on the corner of the album art (green, yellow, and red respectively).
After using the Convert function to your desire, you may then proceed with downloading.
The download button downloads all tracks in the Queue if possible, and replaces them with the downloaded local files. This allows you to inspect and perform spectral analysis (Spek) on the downloads if needed. Similar to local explorer, run Spek by pressing Analyze in the Preview Sidebar.
Downloads may fail or only be previews if improper authentication/account type is used.
| 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 directly available. FluentDL uses automatic matching from other sources |