Note
iSpotify is local-first. It has no iSpotify account, project-operated server, analytics, or telemetry. Your library, playlists, cookies, and credentials stay in your operating system's user-data storage.
| Search and discovery Search for songs and playlists, explore playlist tracks, and select multiple items for download. |
Playback Play local MP3 files sequentially from your library with previous/next, seek, volume, and automatic pause when headphones disconnect. |
| Downloads and library Queue MP3 downloads across restarts with speed, ETA, and retry guidance; search and sort your library, favorite songs, and organize playlists for offline listening. |
Privacy and integrations Use optional local YouTube cookies and Discord listening activity with cover art, playback time, and listening/download links. Credentials stay in the operating system vault. |
| Desktop experience Keep favorites and recently played at hand, with quiet background update checks. |
Flexible installation Choose a Windows installer, portable executable, Debian package, Linux repository, or universal installer. Supported builds can install updates in-app and prompt for restart. |
The current stable release is v19.5.0. Checksums are published beside the standalone executables.
| Platform | Package | Download |
|---|---|---|
| Windows 10/11 | Installer | ISpotify-Setup-x86_64.exe |
| Windows 10/11 | Portable | ISpotify-windows-x86_64.exe |
| Debian / Ubuntu | DEB package | ispotify_19.5.0_amd64.deb |
| Linux x86-64 | Portable | ISpotify-linux-x86_64 |
| All packages | Release page | Latest release |
curl -fsSL https://raw.githubusercontent.com/RubinLabs26/ISpotify/main/packaging/install-linux.sh | bashThe installer checks your system, detects apt, dnf, yum, pacman,
zypper, apk, xbps, or emerge, and installs aria2 for fast resumable
downloads with live progress and speed. It can add the signed APT or pacman
repository where supported and falls back to a portable user installation on
other compatible glibc systems.
Run it with --check to inspect compatibility without installing. Other useful
options include --repo, --standalone, --force, --yes, and --uninstall.
The portable Linux build requires x86-64 and glibc 2.36 or newer.
Discord integration is optional. If the Discord desktop app is running, iSpotify can publish Listening to iSpotify and the current track. Browser users can choose Connect Discord account in Settings and authorize through Discord's official login page. The authorization link can be opened again or copied when a browser cannot be launched automatically. iSpotify never asks for a password, bot token, or raw user token.
The official release packages include the Discord Social SDK runtime. Discord's distribution terms do not permit publishing its raw proprietary library in this source repository, so source checkouts run without account login unless an authorized SDK runtime is supplied locally.
Python 3.10 or newer is required.
git clone https://github.com/RubinLabs26/ISpotify.git
cd ISpotify
python -m venv .venv
python -m pip install -r requirements.txt
python main.pyFFmpeg is used from PATH when available; imageio-ffmpeg provides a fallback.
Deno or Node.js is recommended for YouTube JavaScript challenges.
Do I need an account?
No iSpotify account is required. Discord authorization is optional and only enables listening activity.
Why can a download ask for YouTube cookies?
YouTube sometimes requires sign-in or bot verification. In Settings, you can import a Netscape cookie file or paste a Cookie-Editor JSON export. Treat an exported cookie file like a password and never share or commit it.
Where is my data stored?
iSpotify keeps downloads and application data in your operating system's user
data folders. The Linux installer keeps interrupted package downloads in
~/.cache/ispotify/downloads so aria2 can resume them.
Does iSpotify use a download server?
No. Search, extraction, downloading, playback, and library management run on your computer.
| Project | Purpose |
|---|---|
| PySide6 | Cross-platform desktop interface |
| yt-dlp | Media discovery and extraction |
| FFmpeg | Audio conversion |
| Discord Social SDK | Optional browser account authorization and activity |
| keyring | Operating-system credential storage |
Bug reports, documentation fixes, and code contributions are welcome. Read CONTRIBUTING.md before opening a pull request, and report sensitive security issues using SECURITY.md.
Project contributor: @rubinbastakoti
Licensed under the MIT License.
iSpotify is an independent project from Lumi Labs and its contributors.
It is not affiliated with or endorsed by Spotify AB, YouTube, Google, or Discord. Product names and trademarks belong to their respective owners.