https://github.com/devlocalhost/pyspodl
pyspodl - a spotify downloader using librespot
https://github.com/devlocalhost/pyspodl
librespot librespot-python music music-downloader playlist-downloader playlists python python3 songs spotify spotify-api spotify-premium
Last synced: 6 months ago
JSON representation
pyspodl - a spotify downloader using librespot
- Host: GitHub
- URL: https://github.com/devlocalhost/pyspodl
- Owner: devlocalhost
- License: mit
- Created: 2022-03-19T12:29:43.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-24T09:44:45.000Z (over 1 year ago)
- Last Synced: 2025-03-27T18:52:46.672Z (7 months ago)
- Topics: librespot, librespot-python, music, music-downloader, playlist-downloader, playlists, python, python3, songs, spotify, spotify-api, spotify-premium
- Language: Python
- Homepage:
- Size: 2.45 MB
- Stars: 16
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pyspodl - a spotify downloader using librespot
using the module [librespot-python by kokarare1212](https://github.com/kokarare1212/librespot-python)
# important
I may not work on pyspodl anymore. I dont want to work on this program anymore, im just tired of it. So please do not expect any new features. I will of course update the program if a bug or problem is found, I just will not add any features. [Feel free to fork and add your own features](#helping)
# What is different from other downloaders?
Well, maybe nothing. pyspodl can only do these things: download tracks, albums and playlists in "high" (non-premium) and "very high" (premium account required) quality. It downloads them from Spotify, it does not use another source like some other programs do.
# how to use
Requirements: python3, git. Make sure you have those and a linux PC/environment, then
+ Create an application from [spotify dashboard](https://developer.spotify.com/dashboard/applications), and copy the client ID and secret
+
+ Run this command: `git clone https://github.com/devlocalhost/pyspodl`
+ Paste the client id and secret into the config file, inside the "pyspodl" directory.
+ Run `pip3 install git+https://github.com/kokarare1212/librespot-python`.
+ You will also need Pillow for the album cover, mutagen for tags, and toml to read the config file: `pip3 install Pillow mutagen toml`.
+ Now you can use pyspodl like this: `python3 pyspodl`
## examples
`python pyspodl -l LINK`
`python pyspodl -l "LINK1 LINK2 LINK3"`
`python pyspodl -l ... -c /path/to/config.file`
Or, check `python -h`
## updating pyspodl
When there's a new update, you can simply run `git pull` in the directory where you cloned pyspodl.
# the config file
Before you start using pyspodl, you need to fill out the config file.
## config entries
+ `email`: your account email
+ `password`: your accounts password
+ `token`: used to send request to spotify api. you do not need to touch this.
+ `client_id`: used to get the token
+ `client_secret`: used to get the token
+ `timeout`: tells the program to wait x seconds before downloading the next song from a playlist or album (to avoid account bans, but I never had an account get banned by using my program).
+ `premium_downloads`: download tracks in higher quality. only for premium accounts.
+ `download_path`: the path to download the tracks
+ `set_metadata`: set tags for the tracks
+ `track_format`: the format the tracks will be saved in. check the config file for possible entries
## config example
```
[account]
email = "" # your accounts email
password = "" # the password
token = "" # used to communicate with spotify api
client_id = "" # used to get the token
client_secret = "" # same thing as above
[downloading]
timeout = 2 # in seconds
premium_downloads = false # can be false or true
download_path = "" # download path for the tracks
set_metadata = true # can be false or true
track_format = "{artist}/{album}/{title}" # can be: artist, album, title, tracknumber, year
# the above format will save a song like this: download_path/Nas/Illmatic/The World Is Yours.ogg
# artist album title
```
# help
Feel free to fork or make PR's (pull requests). If you're forking, please leave [this repos link](https://github.com/devlocalhost/pyspodl) in your readme and [kokarare1212's module repo link](https://github.com/kokarare1212/librespot-python).
If you have any problems/want to report a bug or request a feature, open an issue