spotify-downloader

Download Spotify playlists with albumart and meta-tags

Github星跟踪图

Spotify-Downloader

PyPi
Build Status
Coverage Status
Docker Build Status
Code style: black
Gitter Chat

  • Downloads songs from YouTube in an MP3 format by using Spotify's HTTP link.

  • Can also download a song by entering its artist and song name (in case if you don't have the Spotify's HTTP link for some song).

  • Automatically applies metadata to the downloaded song which includes:

    • Title, Artist, Album, Album art, Lyrics (if found either on Genius or LyricsWikia), Album artist, Genre, Track number, Disc number, Release date, and more...
  • Works straight out of the box and does not require you to generate or mess with your API keys (already included).

Below is how your music library will look!

Installation

❗️ This tool works only with Python 3.

Python 2 compatibility was dropped because of the way it deals with unicode (2020 is coming soon too).
If you still need to use Python 2 - check out the (outdated)
python2 branch.

spotify-downloader works with all major distributions and even on low-powered devices such as a Raspberry Pi.

spotify-downloader can be installed via pip with:

$ pip3 install spotdl

but be sure to check out the Installation wiki
page for detailed OS-specific instructions to get it and other dependencies it relies on working on your system.

Usage

For the most basic usage, downloading tracks is as easy as

$ spotdl --song https://open.spotify.com/track/2DGa7iaidT5s0qnINlwMjJ
$ spotdl --song "ncs - spectre"

For downloading playlist and albums, you need to first load all the tracks into text file and then pass
this text file to --list argument. Here is how you would do it for a playlist

$ spotdl --playlist https://open.spotify.com/user/nocopyrightsounds/playlist/7sZbq8QGyMnhKPcLJvCUFD
INFO: Writing 62 tracks to ncs-releases.txt
$ spotdl --list ncs-releases.txt

Run spotdl --help to get a list of all available options in spotify-downloader.

Check out the Available options
wiki page for the list of currently available options with their description.

The wiki page Instructions for Downloading Songs
contains detailed information about different available ways to download tracks.

FAQ

All FAQs will be mentioned in our FAQ wiki page.

Contributing

Check out CONTRIBUTING.md for more info.

Running Tests

$ pytest

Obviously this requires the pytest module to be installed.

Disclaimer

Downloading copyright songs may be illegal in your country.
This tool is for educational purposes only and was created only to show
how Spotify's API can be exploited to download music from YouTube.
Please support the artists by buying their music.

License

License

主要指标

概览
名称与所有者seek-oss/treat
主编程语言TypeScript
编程语言Python (语言数: 2)
平台
许可证MIT License
所有者活动
创建于2019-05-14 04:08:29
推送于2024-04-09 01:36:31
最后一次提交2024-04-09 11:35:08
发布数32
最新版本名称treat@2.0.4 (发布于 2021-04-27 22:41:48)
第一版名称v1.0.0-beta.2 (发布于 2019-05-14 14:43:02)
用户参与
星数1.1k
关注者数8
派生数30
提交数133
已启用问题?
问题数65
打开的问题数0
拉请求数97
打开的拉请求数0
关闭的拉请求数48
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?