ISpotify README

The project's README from github.com/RubinLabs26/ISpotify. As one markdown file: README.md.

iSpotify logo

iSpotify

Search, download, and play your music on Windows and Linux

Latest release Downloads GitHub stars License Checks

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

iSpotify home and local library iSpotify music search
iSpotify settings and Discord integration

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.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

Linux installer

curl -fsSL https://raw.githubusercontent.com/RubinLabs26/ISpotify/main/packaging/install-linux.sh | bash

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 library in this source repository, so source checkouts run without account login unless an authorized SDK runtime is supplied locally.

Build from source

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.py

FFmpeg is used from PATH when available; imageio-ffmpeg provides a fallback. Deno or Node.js is recommended for YouTube JavaScript challenges.

FAQ

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.

Built with

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

Contributing

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.

Contributors

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.

ISpotify (RubinLabs26/ISpotify)

Searching Database…

1.9K ·GitHub
ISpotify
Что это?iSpotify — это десктопное приложение с подходом local-first для Windows и Linux: оно позволяет искать песни и плейлисты, скачивать их в MP3 и слушать свою медиатеку офлайн.
Это сервис на сервере или всё работает на моём компьютере?Всё выполняется локально на вашем компьютере через десктопный GUI на PySide6; никаких серверов от iSpotify, аккаунтов или облачной синхронизации нет.
Статус «Listening to» в Discord работает сразу?Только в официальных пакетах релиза, куда входит проприетарный рантайм Discord Social SDK; при самостоятельной сборке из исходников функции входа в Discord отключены, если вы не предоставите этот рантайм локально.
Установщик для Linux работает на любом дистрибутиве?Он сам определяет apt, dnf, yum, pacman, zypper, apk, xbps или emerge и устанавливает aria2 для них, а на других совместимых glibc-системах откатывается к портативной установке; портативная сборка сама требует x86-64 и glibc 2.36+.
Могу ли я слушать скачанные треки без интернета?Да, скачанные MP3 раскладываются по вашей медиатеке и плейлистам специально для того, чтобы слушать офлайн.
Почему при скачивании у меня могут запросить cookies от YouTube?YouTube иногда требует вход в аккаунт или проверку на бота, прежде чем разрешить получение видео, поэтому iSpotify позволяет импортировать cookie-файл в формате Netscape или вставить JSON-экспорт из Cookie-Editor в настройках, чтобы обойти это.
Как работает необязательная интеграция с Discord?Если запущено десктопное приложение Discord, iSpotify может публиковать статус «Listening to iSpotify» с обложкой и информацией о треке; авторизация проходит через официальную страницу входа Discord, и iSpotify никогда не запрашивает ваш пароль или токен.
На чём построен iSpotify внутри?Он использует PySide6 для кроссплатформенного GUI, yt-dlp для поиска и извлечения медиа, FFmpeg для конвертации аудио и системное хранилище ключей (keyring) для безопасного хранения учётных данных.
Нужен ли аккаунт Spotify или iSpotify для использования?Аккаунт не нужен вообще; приложение полностью автономно, и даже опциональная функция активности в Discord требует лишь однократной авторизации через браузер.
What are similar projects?stemkit, ytDownloader, vdl, Levyra-deepsound, ytdlnis, SimpMusic, openspot-music-app, spotify-downloader
Which topics is it in?yt-dlp, video-downloader, linux-app, music-player, discord, youtube, downloader, offline-first, installer, music, ffmpeg, windows-app
Creator
RubinLabs26
Size
1.4 MB
Stars
1.9K
Updated
CommitOct 12Releasev19.5.1Oct 12
Age
28d
Commits · 90 Days