https://github.com/derekyang2/fluentdl

Fluent UI metadata searcher and editor, command line runner, music downloader
https://github.com/derekyang2/fluentdl

audio-converter command-line-runner deezer-api ffmpeg fluent fluent-design music-download music-information-retrieval music-library music-metadata qobuz-api spotify-api windows11 winui youtube-api

Last synced: 2 months ago
JSON representation

Fluent UI metadata searcher and editor, command line runner, music downloader

• Host: GitHub
• URL: https://github.com/derekyang2/fluentdl
• Owner: DerekYang2
• License: mit
• Created: 2024-07-08T17:07:36.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2024-10-26T14:42:21.000Z (over 1 year ago)
• Last Synced: 2024-10-30T09:10:35.064Z (over 1 year ago)
• Topics: audio-converter, command-line-runner, deezer-api, ffmpeg, fluent, fluent-design, music-download, music-information-retrieval, music-library, music-metadata, qobuz-api, spotify-api, windows11, winui, youtube-api
• Language: C#
• Homepage:
• Size: 75.5 MB
• Stars: 7
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          


    

         

          

          

          

        

    





  

	

		

	  

		

    





  About •

  Installation •

Authentication •

  Build





  



## About

A Fluent UI desktop application that helps you download lossless songs as FLACs, convert between audio formats, match songs between different online sources, edit song metadata, and more. FluentDL supports Deezer, Qobuz, Spotify, and YouTube.

  

    

      Search

      


        
Lookup songs/albums from any of the four 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.

      

    

  

  

    

      Local

      


        
View file metadata and technical audio specs in-depth

        
Edit file metadata live, including option to change cover art

        
View file spectrogram using Spek

        
Convert between flac, mp3, aac, alac, vorbis, opus with control over bitrate

      

    

  

  

    

      Queue

      


        
Matching between all possible combinations of online sources (e.g., convert Spotify and YouTube to Deezer equivalents)

        
Download tracks from Deezer, Qobuz, or Youtube with maximum quality

        
Inspect downloaded track spectrogram

      

    

  


## Installation



	



You can download directly from the [Microsoft Store](https://apps.microsoft.com/detail/9mx44km97x7x?referrer=appbadge&cid=Github&mode=full) for easier updates.

Alternatively, you can sideload an unsigned version from [Releases](https://github.com/DerekYang2/FluentDL/releases).

## Authentication

> [!NOTE]  

> Streaming services occasionally make changes to APIs, which may result in authentication issues.  Check the [Issues](https://github.com/DerekYang2/FluentDL/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

For all sources except for Spotify, searches and conversions do not require authentication.

For Spotify, searches require API keys, which come bundled with FluentDL. If the bundled keys are rate limited, you can generate your own as described in the [authentication wiki](https://github.com/DerekYang2/FluentDL/wiki/Authentication#spotify).

### 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.

  

### Retrieving Tokens

See the [authentication wiki](https://github.com/DerekYang2/FluentDL/wiki/Authentication) for a detailed guide. 

## Build

Only relevant for developers who wish to customize source code.

To build and run the project on Visual Studio, see [development wiki](https://github.com/DerekYang2/FluentDL/wiki/Development).