/spotify-dl

Downloads songs from your Spotify Playlist

Primary LanguagePythonMIT LicenseMIT

spotify_dl

Downloads songs from any Spotify playlist, album or track.

PRs Welcome PyPI download month PyPI license PyPI pyversions GitHub release GitHub stars GitHub contributors

Awesome Badges

Tell me more!

I wanted an easy way to grab the songs present in my library so I can download it & use it offline. spotify_to_mp3 worked well but it relied on grooveshark, which unfortunately is no more. So I wrote this script which mimics that library, but instead of downloading from grooveshark, it searches YouTube and downloads the song using yt-dlp.

How do I get this thing running?

Install using pip

pip3 install spotify_dl

Run the program

spotify_dl -l spotify_playlist_link/s -o download_directory

For running in verbose mode, append -V

spotify_dl -V -l spotify_playlist_link -o download_directory

For more details and other arguments, issue -h

spotify_dl -h

See the getting started guide for more details.

Contributing and Local development

Pull requests and any contributions are always welcome. Please open an issue with your proposal before you start with something.

Running tests

At the moment, there are barely any tests but PRs always welcome to improve this. Tests are setup and run with pytest, run

make tests

to run the tests with Make

Thanks and Credits

Take a look at CONTRIBUTORS for a list of all people who have helped and contributed to the project.

Issues, Feedback, Contact details

Feel free to raise any bugs/issues under Github issues. Pull requests are also more than welcome.