mirror of
https://github.com/THIS-IS-NOT-A-BACKUP/zspotify.git
synced 2024-11-26 09:53:17 +01:00
66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
|
|
|
|
|
|
# ZSpotify
|
|
|
|
### A Spotify downloader needing only a python interpreter and ffmpeg.
|
|
<p align="center">
|
|
<img src="https://user-images.githubusercontent.com/12180913/138040605-c9d46e45-3830-4a4b-a7ac-c56bb0d76335.png">
|
|
</p>
|
|
|
|
[Discord Server](https://discord.gg/skVNQKtyFq) - [Matrix Server](https://matrix.to/#/#zspotify:matrix.org) - [Gitea Mirror](https://git.robinsmediateam.dev/Footsiefat/zspotify) - [Main Site](https://footsiefat.github.io/)
|
|
```
|
|
Requirements:
|
|
|
|
Binaries
|
|
|
|
- Python 3.9 or greater
|
|
- ffmpeg*
|
|
- Git**
|
|
|
|
Python packages:
|
|
|
|
- pip install -r requirements.txt
|
|
|
|
```
|
|
|
|
\*ffmpeg can be installed via apt for Debian-based distros or by downloading the binaries from [ffmpeg.org](https://ffmpeg.org) and placing them in your %PATH% in Windows.
|
|
|
|
\*\*Git can be installed via apt for Debian-based distros or by downloading the binaries from [git-scm.com](https://git-scm.com/download/win) for Windows.
|
|
```
|
|
Command line usage:
|
|
python app.py Loads search prompt to find then download a specific track, album or playlist
|
|
python app.py <track/album/playlist/episode url> Downloads the track, album, playlist or podcast episode specified as a command line argument
|
|
python app.py <artist url> Downloads all albums by specified artist
|
|
|
|
Extra command line options:
|
|
-p, --playlist Downloads a saved playlist from your account
|
|
-ls, --liked-songs Downloads all the liked songs from your account
|
|
|
|
Options that can be configured in zs_config.json:
|
|
ROOT_PATH Change this path if you don't like the default directory where ZSpotify saves the music
|
|
ROOT_PODCAST_PATH Change this path if you don't like the default directory where ZSpotify saves the podcasts
|
|
|
|
SKIP_EXISTING_FILES Set this to false if you want ZSpotify to overwrite files with the same name rather than skipping the song
|
|
|
|
MUSIC_FORMAT Can be "mp3" or "ogg", mp3 is required for track metadata however ogg is slightly higer quality as it is not trsnacoded.
|
|
|
|
FORCE_PREMIUM Set this to true if ZSpotify isn't automatically detecting that you are using a premium account
|
|
|
|
ANTI_BAN_WAIT_TIME Change this setting if the time waited between bulk downloads is too high or low
|
|
OVERRIDE_AUTO_WAIT Change this to true if you want to completely disable the wait between songs for faster downloads with the risk of instability
|
|
```
|
|
### Will my account get banned if I use this tool?
|
|
Currently no user has reported their account getting banned after using ZSpotify.
|
|
This isn't to say _you_ won't get banned as it is technically against Spotify's TOS.
|
|
**Use ZSpotify at your own risk**, the developers of ZSpotify are not responsible if your account gets banned.
|
|
|
|
### What do I do if I see "Your session has been terminated"?
|
|
If you see this, don't worry! Just try logging back in. If you see the incorrect username or password error, reset your password and you should be able to log back in and continue using Spotify.
|
|
|
|
### Contributing
|
|
Please refer to [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
|
|
### Changelog
|
|
Please refer to [CHANGELOG](CHANGELOG.md)
|