Skip to main content

Spotify-DLX

   ███████╗██████╗  ██████╗ ████████╗██╗███████╗██╗   ██╗    ██████╗ ██╗     ██╗  ██╗
   ██╔════╝██╔══██╗██╔═══██╗╚══██╔══╝██║██╔════╝╚██╗ ██╔╝    ██╔══██╗██║     ╚██╗██╔╝
   ███████╗██████╔╝██║   ██║   ██║   ██║█████╗   ╚████╔╝     ██║  ██║██║      ╚███╔╝
   ╚════██║██╔═══╝ ██║   ██║   ██║   ██║██╔══╝    ╚██╔╝      ██║  ██║██║      ██╔██╗
   ███████║██║     ╚██████╔╝   ██║   ██║██║        ██║       ██████╔╝███████╗██╔╝ ██╗
   ╚══════╝╚═╝      ╚═════╝    ╚═╝   ╚═╝╚═╝        ╚═╝       ╚═════╝ ╚══════╝╚═╝  ╚═╝

Downloads songs and podcasts from any Spotify playlist, album or track easily.

The purpose of this project is to provide simple and easy Spotify CLI/client to downloads songs and podcasts with beautiful terminal UI.

Usage

CLI

$ python -m spotify_dlx

Then cool UI will appear.

Options

--root         : Root path to download songs. Default is $HOME/spotify_dlx/songs/.
--root-podcast : Root path to download songs. Default is $HOME/spotify_dlx/podcasts/.
--url          : Specific url for track, album, playlist or episode. Optional.
--liked        : If specified, download all liked songs.
--playlist     : If specified, download songs from user's playlist.
--disable-skip : If specified, disable to skip already downloaded audio.
--format       : wav or mp3.
--limit        :  Search limits.

Client

>>> from spotify_dlx import SpotifyDLXClient
>>> client = SpotifyDLXClient()
>>> client.login(usename="USERNAME", password="PASSWORD")
>>> client.search("Billie Eilish")

Installation

requirements

ffmpeg and librespot are required.

Run following commands.

$ pip install git+https://github.com/kokarare1212/librespot-python

$ brew install ffmpeg # Mac

pip

$ pip install spotify_dlx

Manual

$ git clone git@github.com:ozora-ogino/spotify_dlx.git
$ cd  spotify_dlx
$ pip install -e .

Frequently Asked QUestion

What's the difference between spotify_dl?

As you know, spotify_dl is awesome and high quality library.

But I want to download spotify songs by cli and make the process simpler and this is it.

Contribution

This is still personal toy project, however Contribution is welcome.

I recommend to understand following topics.

Release files for spotify-dlx 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spotify-dlx 0.2.0
File Size Uploaded
spotify_dlx-0.2.0.tar.gz 10.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for spotify-dlx 0.2.0
File Interpreter ABI Platform
spotify_dlx-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size:22.3 kB

Release files / spotify_dlx-0.2.0.tar.gz

Download URL spotify_dlx-0.2.0.tar.gz
Size 10.7 kB
Tags Source
SHA-256 checksum
How to use checksums
b6a167c747c6bf2aa41d8957a871cac00a0ed85f55aa75754f807c2fee996313
BLAKE2b-256 checksum
How to use checksums
369af8fe702b38edd7a3cb49551a0b0a1ed539099454d54bfcb64a2db6dfa3bf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.0

Release files / spotify_dlx-0.2.0-py3-none-any.whl

Download URL spotify_dlx-0.2.0-py3-none-any.whl
Size 11.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ffa65cad9f50f8f4952cb382a34210eeea8a519d6c35da2adb19c5316632bf8
BLAKE2b-256 checksum
How to use checksums
d21b7f621c597c7801abcf67c5286c8a48f095add61bbf9c0ee2a7810ef7b3b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.0

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page