RubinLabs26/ISpotify

选用指南

AI 根据 README 整理 · 2026/10/16 21:26:32

适用场景

适合在 Windows 或 Linux 上搜索、下载并离线播放音乐，支持本地库管理和播放列表。

查看 README 依据

<img src="assets/screenshots/settings.png" alt="iSpotify settings and Discord integration" width="74%"> </div> ## Features | | | |---|---| | **Search and discovery**<br>Search for songs and playlists, explore playlist tracks, and select multiple items for download. | **Playback**<br>Play local MP3 files sequentially from your library with previous/next, seek, volume, and automatic pause when headphones disconnect. |

| **Downloads and library**<br>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**<br>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. |

使用方式

提供图形界面，可通过安装包或便携版运行，也支持从源码构建。

查看 README 依据

| **Desktop experience**<br>Keep favorites and recently played at hand, with quiet background update checks. | **Flexible installation**<br>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](https://github.com/RubinLabs26/ISpotify/releases/latest/download/ISpotify-Setup-x86_64.exe) | | Windows 10/11 | Portable | [ISpotify-windows-x86_64.exe](https://github.com/RubinLabs26/ISpotify/releases/latest/download/ISpotify-windows-x86_64.exe) | | Debian / Ubuntu | DEB package | [ispotify_19.5.1_amd64.deb](https://github.com/RubinLabs26/ISpotify/releases/download/v19.5.1/ispotify_19.5.1_amd64.deb) |

Python 3.10 or newer is required. ```bash 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 <details> <summary><strong>Do I need an account?</strong></summary> No iSpotify account is required. Discord authorization is optional and only enables listening activity. </details> <details>

部署要求

Windows 10/11 或 Linux x86-64（glibc 2.36+），从源码构建需 Python 3.10+，可选 FFmpeg 和 Deno/Node.js。

查看 README 依据

| Windows 10/11 | Installer | [ISpotify-Setup-x86_64.exe](https://github.com/RubinLabs26/ISpotify/releases/latest/download/ISpotify-Setup-x86_64.exe) | | Windows 10/11 | Portable | [ISpotify-windows-x86_64.exe](https://github.com/RubinLabs26/ISpotify/releases/latest/download/ISpotify-windows-x86_64.exe) | | Debian / Ubuntu | DEB package | [ispotify_19.5.1_amd64.deb](https://github.com/RubinLabs26/ISpotify/releases/download/v19.5.1/ispotify_19.5.1_amd64.deb) |

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

Python 3.10 or newer is required. ```bash 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 <details> <summary><strong>Do I need an account?</strong></summary> No iSpotify account is required. Discord authorization is optional and only enables listening activity. </details> <details>

已知限制

下载可能需要 YouTube cookies 以通过验证；源码版本不含 Discord SDK，需自行提供。

查看 README 依据

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

<summary><strong>Why can a download ask for YouTube cookies?</strong></summary> 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. </details> <details> <summary><strong>Where is my data stored?</strong></summary> 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.