Skip to main content

Downloads Spotify music from Youtube with metadata and album art

Project description

spotDL

MIT License

⚠ Interested Contributors, please read our contributing Guidelines first.

⚠ We are dropping active development of spotDL v2. No focused efforts will be made to resolve v2 specific issues.

⚠ We are actively looking for Contributors/Organization Members for all projects under development. If interested, see #857

⚠ There are a few feature requests we'd like the community to vote on. Do voice your support for features you'd like. See #867 to vote.



What spotDL does:

  1. Downloads music from YouTube as an MP3 file
  2. Applies basic metadata like track name, track number, album, genre and more...



You need to download ffmpeg to use this tool, download it from:

  1. MacOs
  2. Windows
  3. Linux
  4. Central Release Page



Announcing spotDL v3.0.2

We have rebuilt spotDL from scratch to be much faster, simpler and better than the old spotDL. The documentation for the same is a work in progress. v3.0.2 is yet to be released to PyPi so you can't install it using pip, this is intentional. v3.0.2 is still in alpha testing. We request that you use spotDL v3 and open issues for problems that you come across.

Installation

  1. For stable version

    $pip install spotdl
    
  2. For latest version (not necessarily stable)

    $pip install https://github.com/spotDL/spotify-downloader/archive/next-rel-dev.zip
    
  3. Voila !

How to use (instructions for v3)

To download a song run,

# spotdl $trackUrl
spotdl https://open.spotify.com/track/08mG3Y1vljYA6bvDt4Wqkj?si=SxezdxmlTx-CaVoucHmrUA

To download an album run,

# spotdl $albumUrl
spotdl https://open.spotify.com/album/2YMWspDGtbDgYULXvVQFM6?si=gF5dOQm8QUSo-NdZVsFjAQ

To download a playlist run,

# spotdl $playlistUrl
spotdl https://open.spotify.com/playlist/37i9dQZF1DWXhcuQw7KIeM?si=xubKHEBESM27RqGkqoXzgQ

To search for and download a song (not very accurate) run,

# spotdl $songQuery
spotdl 'The HU - Sugaan Essenna'

To resume a failed/incomplete download run,

  • # spotdl $pathToTrackingFile
    spotdl 'Sugaan Essenna.spotdlTrackingFile'
    
  • Note, '.spotDlTrackingFiles' are automatically created during download start, they are deleted on download completion

You can chain up download tasks by seperating them with spaces:

# spotdl $songQuery1 $albumUrl $songQuery2 ... (order does not matter)
spotdl 'The Hu - Sugaan Essenna' https://open.spotify.com/playlist/37i9dQZF1DWXhcuQw7KIeM?si=xubKHEBESM27RqGkqoXzgQ ...

Spotdl downloads up to 4 songs in parallel - try to download albums and playlists instead of tracks for more speed.

Thanks for developing the v3.0.1

  1. @ritiek for creating and maintaining spotDL for 4 years
  2. @rocketinventor for figuring out the YouTube Music querying
  3. @Mikhail-Zex for, never mind...

A few interesting forks

  1. aasmpro/spotify/downloader
    • Sets metadata for songs that are already downloaded (v2 only.)

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spotdl-3.1.4.tar.gz (25.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

spotdl-3.1.4-py3-none-any.whl (62.0 kB view details)

Uploaded Python 3

File details

Details for the file spotdl-3.1.4.tar.gz.

File metadata

  • Download URL: spotdl-3.1.4.tar.gz
  • Upload date:
  • Size: 25.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for spotdl-3.1.4.tar.gz
Algorithm Hash digest
SHA256 1e9e7856b9848c3a134af9ee380887ea3cca1ed51d80da1914f9c7a29825adbd
MD5 491c2c3bdb67f2b97429137109eb8530
BLAKE2b-256 38db0778d26881b183f1a75399a328670d86856f74a1dd0edada3322b922b242

See more details on using hashes here.

File details

Details for the file spotdl-3.1.4-py3-none-any.whl.

File metadata

  • Download URL: spotdl-3.1.4-py3-none-any.whl
  • Upload date:
  • Size: 62.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for spotdl-3.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 869db2753fd57ce44748cd6626e3cd2611135308525eaee230c9cac8eb63bfc7
MD5 2fcee46f3f999797ed4ccb1d92b88aab
BLAKE2b-256 0cbb3a2ffcbcb653693515358e19c509c70c6f843be00ddd3f1097d2b952c0d3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page