Download your Spotify playlists and songs along with album art and metadata

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for Silverarmor from gravatar.com Silverarmor Avatar for spotDL from gravatar.com spotDL Avatar for xnetcat from gravatar.com xnetcat

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: spotDL Team
  • Maintainer: xnetcat
  • Tags spotify , downloader , spotdl , music
  • Requires: Python >=3.7, <=3.11
Classifiers
Report project as malware

Project description

spotDL v4

Download your Spotify playlists and songs along with album art and metadata

MIT License PyPI version GitHub commits since latest release (by date) PyPi downloads Contributors Discord

A new and improved version of spotDL: still the fastest, easiest and most accurate command-line music downloader

Read the documentation on ReadTheDocs!

Prerequisites

YouTube Music must be available in your country for spotDL to work. This is because we use YouTube Music to filter search results. You can check if YouTube Music is available in your country, by visiting YouTube Music.

Installation

Refer to our Installation Guide for more details

  • Python (Recommended)
    • spotDL can be installed by running pip install spotdl.

    On some systems you might have to change pip to pip3.

Other options

  • Prebuilt Executable
  • On Termux
    • curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh
  • Arch
    • There is an Arch User Repository (AUR) package for spotDL.
  • Docker

    • Build image:

      docker build -t spotdl .

    • Launch container with spotDL parameters (see section below). You need to create mapped volume to access song files

      docker run --rm -v $(pwd):/music spotdl download [trackUrl]

Installing FFmpeg

If using FFmpeg only for spotDL, you can install FFmpeg to your local directory. spotdl --download-ffmpeg will download FFmpeg to your spotDL installation directory.

We recommend the above option, but if you want to install FFmpeg system-wide,

  • Windows Tutorial
  • OSX - brew install ffmpeg
  • Linux - sudo apt install ffmpeg or use your distro's package manager

Usage

To get started right away:

spotdl download [urls]

To start the Web UI:

spotdl web

You can run spotDL as a package if running it as a script doesn't work:

python -m spotdl [urls]

Further information can be found in our documentation

Read the documentation on ReadTheDocs!

Contributing

Interested in contributing? Check out our CONTRIBUTING.md to find resources around contributing along with a guide on how to set up a development environment.

License

This project is Licensed under the MIT License.

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for Silverarmor from gravatar.com Silverarmor Avatar for spotDL from gravatar.com spotDL Avatar for xnetcat from gravatar.com xnetcat

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: spotDL Team
  • Maintainer: xnetcat
  • Tags spotify , downloader , spotdl , music
  • Requires: Python >=3.7, <=3.11
Classifiers

Release history Release notifications | RSS feed

4.4.3

4.4.2

4.4.1

4.4.0

4.3.1

4.3.0

4.2.11

4.2.10

4.2.9

4.2.8

4.2.7

4.2.6

4.2.5

4.2.4

4.2.3

4.2.2

4.2.1

4.2.0

4.1.11

4.1.10

4.1.9

4.1.8

4.1.7

4.1.6

4.1.5

4.1.4

4.1.3

4.1.2

4.1.0

4.0.7

4.0.6

4.0.5

4.0.4

4.0.3

4.0.2

This version

4.0.1

4.0.0

4.0.0rc5 pre-release

4.0.0rc4 pre-release

4.0.0rc3 pre-release

4.0.0rc2 pre-release

4.0.0rc1 pre-release

3.9.6

3.9.5

3.9.4

3.9.3

3.9.2

3.9.1

3.9.0

3.8.0

3.7.2

3.7.1

3.7.0

3.6.3

3.6.2

3.6.1

3.6.0

3.5.2

3.5.1

3.5.0

3.4.2

3.4.1

3.4.0

3.3.3

3.3.2

3.3.1

3.3.0

3.2.1

3.2.0rc0 pre-release yanked

3.1.4

3.1.3 yanked

Reason this release was yanked:

Will definitely glitch

3.1.2

3.1.1 yanked

3.1.0 yanked

Reason this release was yanked:

Lack of project description

2.2.2

2.2.1

2.2.0

2.1.0

2.0.9

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.2

1.1.1

1.1.0

1.0.0

0.9.3

0.9.2

0.9.1

Download files

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

Source Distribution

spotdl-4.0.1.tar.gz (53.7 kB view details)

Uploaded Source

Built Distribution

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

spotdl-4.0.1-py3-none-any.whl (69.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: spotdl-4.0.1.tar.gz
  • Upload date:
  • Size: 53.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.8

File hashes

Hashes for spotdl-4.0.1.tar.gz
Algorithm Hash digest
SHA256 d46665b0dc735ba30db16a680e44515c6ae9861a002bfbc6a715cbbfe30a8a6b
MD5 7a637abcb1d3aa746a8473399b9717fe
BLAKE2b-256 3c53945b5329ae7489a9a71b9372e6da36eac93b6cbedbe0d669c5020839719b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: spotdl-4.0.1-py3-none-any.whl
  • Upload date:
  • Size: 69.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.8

File hashes

Hashes for spotdl-4.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1e41e1c731037408627d8771aa32c53d1fb993190102475c7b7bfa1f0cb490b6
MD5 414428d5ac5bc2384edbd633af02fc5c
BLAKE2b-256 9ed6da5c932e2e866d23dbdc94ad8f18e3f7c7864c89203cdef8c3b8197362ea

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