RubinLabs26 / ISpotify
git clone https://github.com/RubinLabs26/ISpotify.git
v19.5.1 · 8d ago
Local-first desktop music search, playlist, download, and playback app for Windows and Linux
—
stars, 24h
—
stars, 7 days
+1.9k
stars, 30 days · #166
1.9k
★ total
2
forks · 3 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguagePython
LicenseMIT
Created2026-09-20 (1mo ago)
Last push8d ago
Watchers0
OwnerOrganization
GitHub topics
Links
README excerpt
# iSpotify ### Search, download, and play your music on Windows and Linux Download · Features · Build from source · Contribute > [!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. ## Screenshots ## Features | | | |---|---| | **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. | ## Download The current stable release is **v19.5.1**. 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.1_amd64.deb | | Linux x86-64 | Portable | ISpotify-linux-x86_64 | | All packages | Release page | Latest release | ### Linux installer [code] The 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 activity 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