Package Health Score

93 / 100

security
No known security issues
popularity
Popular
maintenance
Healthy
community
Active

Explore Similar Packages

floodlight
67

Popularity

Popular

GitHub Stars: 17.56K
Forks: 1.61K
Contributors: 160

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package spotdl, we found that it has been starred 17,558 times.

Security

No known security issues

Security and license risk for latest version

Release Date: Nov 15, 2024
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
0
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

MIT

Security Policy

We found a way for you to contribute to the project! Looks like spotdl is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Healthy

Commit Frequency

Open Issues: 30
Open PR: 2
Last Release: 3 days ago
Last Commit: 3 days ago

Further analysis of the maintenance status of spotdl based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that spotdl demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Community

Active

Readme: Yes
Contributing.md: Yes
Code of Conduct: Yes
Contributors: 160
Funding: No

A good and healthy external contribution signal for spotdl project, which invites more than one hundred open source maintainers to collaborate on the repository.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: <3.14,>=3.8

Age: 7 years
Latest Release: 3 days ago
Dependencies: 0 Direct
Versions: 94
Maintainers: 2
Wheels: OS Independent

Not sure how to use spotdl?

To help you get started, we've collected the most common ways that spotdl is being used within popular public projects.

ritiek / spotify-downloader / test / test_list.py View on Github

def test_m3u(tmpdir):
    expect_m3u = (
        "#EXTM3U\n\n"
        "#EXTINF:31,Eminem - 01 - Eminem - Curtains Up (Skit)\n"
        "http://www.youtube.com/watch?v=qk13SFlwG9A\n"
        "#EXTINF:226,Alan Walker - Spectre [NCS Release]\n"
        "http://www.youtube.com/watch?v=AOeY-nDp7hI\n"
    )
    m3u_track_file = os.path.join(str(tmpdir), "m3u_test.txt")
    with open(m3u_track_file, "w") as track_file:
        track_file.write("\nhttps://open.spotify.com/track/2nT5m433s95hvYJH4S7ont")
        track_file.write("\nhttp://www.youtube.com/watch?v=AOeY-nDp7hI")
    youtube_tools.generate_m3u(m3u_track_file)
    m3u_file = "{}.m3u".format(m3u_track_file.split(".")[0])
    with open(m3u_file, "r") as m3u_in:
        m3u = m3u_in.readlines()
    assert "".join(m3u) == expect_m3u

View more ways to use spotdl

spotDL v4

spotDL finds songs from Spotify playlists on YouTube and downloads them - along with album art, lyrics and metadata.

Contributors

> spotDL: The fastest, easiest and most accurate command-line music downloader.

Read the documentation on ReadTheDocs!

Installation

Refer to our Installation Guide for more details.

Python (Recommended Method)

spotDL can be installed by running pip install spotdl.
To update spotDL run pip install --upgrade spotdl

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

Other options

Prebuilt executable
- You can download the latest version from the Releases Tab
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]
```

Build from source

git clone https://github.com/spotDL/spotify-downloader &amp;&amp; cd spotify-downloader
pip install poetry
poetry install
poetry run python3 scripts/build.py

An executable is created in spotify-downloader/dist/.

Installing FFmpeg

FFmpeg is required for spotDL. If using FFmpeg only for spotDL, you can simply install FFmpeg to your spotDL installation directory: spotdl --download-ffmpeg

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

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

Usage

Using SpotDL without options::

spotdl [urls]

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

python -m spotdl [urls]

General usage:

spotdl [operation] [options] QUERY

There are different operations spotDL can perform. The default is download, which simply downloads the songs from YouTube and embeds metadata.

The query for spotDL is usually a list of Spotify URLs, but for some operations like sync, only a single link or file is required. For a list of all options use spotdl -h

Supported operations

save: Saves only the metadata from Spotify without downloading anything.
- Usage: spotdl save [query] --save-file {filename}.spotdl
web: Starts a web interface instead of using the command line. However, it has limited features and only supports downloading single songs.
url: Get direct download link for each song from the query.
- Usage: spotdl url [query]
sync: Updates directories. Compares the directory with the current state of the playlist. Newly added songs will be downloaded and removed songs will be deleted. No other songs will be downloaded and no other files will be deleted.
- Usage: spotdl sync [query] --save-file {filename}.spotdl
  
  This create a new sync file, to update the directory in the future, use:
  
  spotdl sync {filename}.spotdl
meta: Updates metadata for the provided song files.

Music Sourcing and Audio Quality

spotDL uses YouTube as a source for music downloads. This method is used to avoid any issues related to downloading music from Spotify.

> Note > Users are responsible for their actions and potential legal consequences. We do not support unauthorized downloading of copyrighted material and take no responsibility for user actions.

Audio Quality

spotDL downloads music from YouTube and is designed to always download the highest possible bitrate; which is 128 kbps for regular users and 256 kbps for YouTube Music premium users.

Check the Audio Formats page for more info.

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.

Join our amazing community as a code contributor, and help accelerate

Donate

help support the development and maintenance of the software ❤️

License

This project is Licensed under the MIT License.

FAQs

What is spotdl?

Download your Spotify playlists and songs along with album art and metadata. Visit Snyk Advisor to see a full health score report for spotdl, including popularity, security, maintenance & community analysis.

Is spotdl popular?

The python package spotdl receives a total of 12,863 weekly downloads. As such, spotdl popularity was classified as a popular. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is spotdl well maintained?

We found that spotdl demonstrated a healthy version release cadence and project activity. It has a community of 160 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is spotdl safe to use?

The python package spotdl was scanned for known vulnerabilities and missing license, and no issues were found. Thus the package was deemed as safe to use. See the full health analysis review.

Last updated on 18 November-2024, at 14:14 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

spotdl

Download your Spotify playlists and songs along with album art and metadata For more information about how to use this package see README

Ensure you're using the healthiest python packages

Package Health Score

Explore Similar Packages

Popularity

Direct Usage Popularity

Security

Security and license risk for latest version

Maintenance

Commit Frequency

Community

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Package

Not sure how to use spotdl?

spotDL v4

Installation

Python (Recommended Method)

Installing FFmpeg

Usage

Music Sourcing and Audio Quality

Audio Quality

Contributing

Join our amazing community as a code contributor, and help accelerate

Donate

License

FAQs

What is spotdl?

Is spotdl popular?

Is spotdl well maintained?

Is spotdl safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Fix identified vulnerabilities

Monitor for new issues

Package Health Score

Explore Similar Packages

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Not sure how to use spotdl?

spotDL v4

Installation

Python (Recommended Method)

Installing FFmpeg

Usage

Music Sourcing and Audio Quality

Audio Quality

Contributing

Join our amazing community as a code contributor, and help accelerate

Donate

License

FAQs

What is spotdl?

Is spotdl popular?

Is spotdl well maintained?

Is spotdl safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues