A user-friendly GUI for the ZSpotify music downloader.

Related tags

DownloaderZSpotifyGUI
Overview

Stars Forks Size

ZSpotifyGUI

A user-friendly desktop app for ZSpotify music downloader for Windows, MacOs, and Linux

Discord Server - Matrix Server - Gitea Mirror - Main Site

Take full advantage of the power of ZSpotify with this user-friendly graphical interface.

  • Find the music you want faster and easier.
  • Listen to your music directly in ZSpotify with it's fully featured music player.
  • Continue to search for music while downloading.
  • Queue up downloads so you can maximise your downloading potential.
  • Your spotify likes sync into the client, allowing you to easily download them
  • Easily change settings such as real-time-download, download format, download directory, and search results
Requirements:

Binaries

- Python 3.9 or greater
- ffmpeg*
- Git**
- vlc***

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 and placing them in your %PATH% in Windows. Mac users can install it with Homebrew by running brew install ffmpeg.

**Git can be installed via apt for Debian-based distros or by downloading the binaries from git-scm.com for Windows.

***VLC can be installed from videolan.org for all operating systems. You may need to restart your PC

Install the requirements: pip install -r requirements.txt
Run the GUI from within the zspotify directory: python appGui.py

Run from main directory: python zspotify/appGui.py

COMMAND LINE USAGE



Basic command line usage:
  python zspotify <track/album/playlist/episode/artist url>   Downloads the track, album, playlist or podcast episode specified as a command line argument. If an artist url is given, all albums by specified artist will be downloaded. Can take multiple urls.

Extra command line options:
  -p, --playlist       Downloads a saved playlist from your account
  -ls, --liked-songs   Downloads all the liked songs from your account
  -s, --search         Loads search prompt to find then download a specific track, album or playlist
  -ns, --no-splash     Suppress the splash screen when loading.

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 higher quality as it is not transcoded.

  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

Docker Usage

Pull the official docker image (automatically updates):
  docker pull cooper7692/zspotify-docker
Or build the docker image yourself from the Dockerfile:
  docker build -t zspotify .
Create and run a container from the image:
  docker run --rm -v "$PWD/ZSpotify Music:/ZSpotify Music" -v "$PWD/ZSpotify Podcasts:/ZSpotify Podcasts" -it zspotify

Google Colab

There is a community maintained repo for Google Colab at Ori5000/zspotifycolab designed to make it easier to add songs to Google Drive or orther cloud services.

Will my account get banned if I use this tool?

Currently no user has reported their account getting banned after using ZSpotify.

There have been 2-3 reports from users who received account bans from Spotify for using this tool.

We recommend using ZSpotify with a burner account. Alternatively, there is a configuration option labled DOWNLOAD_REAL_TIME, this limits the download speed to the duration of the song being downloaded thus not appearing suspicious to Spotify. This option is much slower and is only recommended for premium users who wish to download songs in 320kbps without buying premium on a burner account.

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

Changelog

Please refer to CHANGELOG

Common Errors

Please refer to COMMON_ERRORS

Comments
  • the program has stopped working!

    the program has stopped working!

    Hello, I used this great program for half a year and everything was fine, but for the last few days it stopped working correctly, the download process of the track stops at 88%! as it turned out, not only me, help fix this error

    opened by RPGW1ZARD 2
  • GUI hangs after incorrect credential submission

    GUI hangs after incorrect credential submission

    Every time, after incorrect credentials entered, the GUI hangs. However, this is a problem with the base zspotify app, but it would be nice if there was a way to restart the GUI, or at least the zspotify backend when the librespot incorrect credentials exception is thrown.

    opened by PhlegethonAcheron 1
  • [FEATURE]

    [FEATURE]

    Is your feature request related to a problem? Please describe. A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] Theres no m1 chip support image

    Describe the solution you'd like A clear and concise description of what you want to happen.

    Additional context Add any other context or screenshots about the feature request here.

    enhancement 
    opened by Xbz-24 0
  • [BUG] Can't download my playlist

    [BUG] Can't download my playlist

    Describe the bug Can't download created playlist

    To Reproduce Steps to reproduce the behavior:

    1. Find playlist through search
    2. Press Download
    3. Check CMD

    System Info:

    • OS: Win 10
    • Version 10.0.19044 Build 19044

    image

    Link for the playlist:

    https://open.spotify.com/playlist/0q1K3cH1ZDeXHDM10Savy4?si=9a94a085bae643a8

    bug 
    opened by ataraxia1337 0
  • Add media keys, GUI changes

    Add media keys, GUI changes

    Mute button functionality, minor GUI changes, display cover art of downloaded files, global media key listening for play/pause, next, prev. Resolves #12.

    opened by otta8634 1
  • [FEATURE] Lyrics integration

    [FEATURE] Lyrics integration

    Is your feature request related to a problem? Please describe. None, just a feature in Spotify not yet in ZSpotifyGUI.

    Describe the solution you'd like Integration from some lyrics API to fetch lyrics for current playing song and display.

    Additional context None.

    enhancement 
    opened by otta8634 0
  • [FEATURE] Discord RPC

    [FEATURE] Discord RPC

    Is your feature request related to a problem? Please describe. Just a feature on Spotify but not ZSpotifyGUI.

    Describe the solution you'd like A Rich presence client similar to the one Spotify provides for Discord. However having the album art display would require it to be uploaded to the bot's Discord applications site, so that would have to be skipped for the project to be feasible.

    Additional context None.

    enhancement 
    opened by otta8634 0
Releases(0.2.0)
  • 0.2.0(Nov 28, 2021)

    ZSpotifyGUI 0.1.1 This release brings some major improvements to stability, as well as some QoL changes.

    Release Notes:

    • Bug fix to librespot preventing reconnection to Spotify API
    • Added API reconnection logic after full internet disconnect or failed API calls
    • Downloaded tracks now correctly display their cover art
    • Playback and volume slider now move to clicked position correctly on Windows
    • Moved default path for ZSpotify Music, zs_config.json to the root folder
    • Reworked how spotify metadata is stored in track files
    • Now installs all python dependencies in a virtual environment
    Source code(tar.gz)
    Source code(zip)
    ZSpotifyGUI-Updater.exe(21.25 MB)
    ZSpotifyMacOs.zip(55.35 MB)
  • 0.1.0(Nov 18, 2021)

    This first pre-release introduces a far more streamlined installation and launch process to the ZSpotifyGUI for Windows and MacOs. The windows version has no more prerequisites, and can be fully installed with our installer. The MacOs version only requires XCode, and can be installed with a single line in the terminal. The app can be launched from the launch icon created during installation. This release also features various improvements to the music player.

    Source code(tar.gz)
    Source code(zip)
    ZSpotify-Win-0.1.0.exe(204.70 MB)
    ZSpotifyMacOs.zip(54.81 MB)
Python based Telegram bot. Search and download YouTube video or audio.

Python-Telegram-Youtube-Media-Bot Python based Telegram bot. Search and download YouTube video or audio. Just change settings.py and start TelegramBot

Ahmet Bohur 2 Oct 02, 2022
Python youtube playlist downloader

Youtube-Playlist-Downloader-python 👍 This program is a simple Youtube playlist downloader where you input the playlist link, and then the desired pat

Pepczenko 2 Dec 25, 2021
Download India Stocks Historical Data

Kite Helper - Download Stock Market Data 🌎 Website Simple Application to Download any stock market data in .csv format using Kite 🏃‍♂️ Running Serve

Pishang Ujeniya 12 Dec 06, 2022
Youtube Video Downloader Using Python Gui Appliction with progress Bar

Youtube-Video-Downloader Youtube Video Downloader Using Python Gui Appliction with progress Bar Module Used Pytube Tkinter Pil Urllib Bytes Io LICENSE

Community Programmer 6 Dec 19, 2022
lo2: Simple youtube-dl web frontend

Simple youtube-dl web frontend

Denis Volk 22 Jun 03, 2022
Userscript qutebrowser for downloading audio / video from youtube using aria2

Yt-Downloader Userscript qutebrowser for downloading video / audio from youtube using aria2 by hint links. Requirements Rofi youtube-dl aria2 dunst In

Ara 0 Dec 11, 2021
A bot to download songs from YouTube to telegram.

Song-Downloader-Bot A BOT TO DOWNLOAD SONGS FROM YOUTUBE. Mandatory variables API_ID - Get It From my.telegram.org API_HASH - Get It From my.telegram.

Ashik Muhammed 38 Dec 11, 2022
Download all your URI Online Judge source codes and upload to GitHub with simple steps.

URI-Code-Downloader Download all your URI Online Judge source codes and upload to GitHub with simple steps. Prerequisites Python 3.x Installing Downlo

Luan Simões 9 Mar 23, 2022
Python script designed to search and fetch direct download links from nxbrew.com

SwitchGamesDownloader Only for windows nxbrew.com is a website, accessible only using a proxy, where the majority of games for the Nintendo Switch are

Backend 91 Dec 28, 2022
Python Youtube Video-Playlist Downloader

Youtube-Video-Playlist-Downloader-PyQt5 You can download videos and playlists on YouTube with this script. Script has GUI. Enjoy. Setup git clone http

Yunus Emre Öztürk 2 Jun 06, 2022
Newsemble is an API that provides easy access to the current news for programmatic analysis

Newsemble is an API that provides easy access to the current news for programmatic analysis. It has been built using Python, BeautifulSoup and MongoDB.

Rishabh 43 Dec 16, 2022
A Udemy downloader that can download DRM protected videos and non-DRM protected videos.

Udemy Downloader with DRM support NOTE This program is WIP, the code is provided as-is and i am not held resposible for any legal repercussions result

Puyodead1 468 Dec 29, 2022
Youtube-downloader-using-Python - Youtube downloader using Python

Youtube-downloader-using-Python Hii guys !! Fancy to see here Welcome! built by

Lakshmi Deepak 2 Jun 09, 2022
YouTube Video Search Engine For Python

YouTube-Video-Search-Engine Introduction With the increasing demand for electronic devices, it is hard for people to choose the best products from mul

1 Dec 21, 2021
Download Youtube videos in mp4 format in a fast, easy, convenient way made with Python!

yt_downloader Download Youtube videos in mp4 format in a fast, easy, convenient way made with Python! Required Modules pytube os time colorama Errors

3 Jul 02, 2022
Download all games from a public Itch.io Game Jam

Itch Jam Downloader Downloads all games from a public Itch.io Game Jam. What you'll need: Python 3.8+ pip install -r requirements.txt For site mirrori

Dragoon Aethis 19 Dec 07, 2022
Simple package for Sublime Text 4; download URL's for local viewing and editing

URLDownloader This is a simple example package that allows you to easily download the contents of any web URL to edit locally. Given a URL, the packag

Terence Martin 3 Mar 05, 2022
A program that can download animations from myself website

MYD A program that can download animations from myself website 一個可以用來下載Myself網站上動漫的程式 Quick Start [無GUI版本] 確定電腦內包含 ffmpeg 並設為環境變數 (Environment Variabl

Patrick_star 1 Nov 07, 2021
VD Song Bot - A telegram bot that can download songs

VD Song Bot A telegram bot that can download songs Reach me on Telegram @MusicVNDbot Deploy to Heroku The easiest way to deploy this Song Bot Mandator

Venuja Thilakarathna 2 Feb 19, 2022
pubmex.py - a script to get a fancy paper title based on given DOI or PMID

pubmex.py is a script to get a fancy paper title based on given DOI or PMID (can be also combined with macOS Finder)

Marcin Magnus 13 Nov 20, 2022