RubinLabs26/ISpotify

iSpotify – 快速概览

它是什么 – iSpotify 是一款免费、开源的桌面客户端，可让您在 Windows 或 Linux 上搜索音乐、下载为 MP3 文件，并在本地播放。所有操作都在您的计算机上进行；没有中央 iSpotify 账户、服务器、分析或遥测。

核心功能

功能	您获得的功能
搜索与发现	查询歌曲和播放列表（通过 YouTube）并浏览结果。您可以一次选择多个项目进行批量下载。
下载管理器	排队 MP3 下载，显示速度/预计时间，失败时重试，并在重启后保留。
本地音乐库	您的下载文件存储在操作系统特定的用户数据文件夹中；您可以排序、收藏并整理成播放列表以供离线收听。
播放	简单的音频播放器，具有上一首/下一首、搜索、音量控制以及拔下耳机时自动暂停功能。
隐私优先	凭据（YouTube cookies、Discord token）存储在操作系统密钥环中；没有遥测离开您的机器。
Discord 集成（可选）	当您链接 Discord 账户时，发布“正在收听 iSpotify”状态，包含封面艺术和曲目时间。
跨平台 UI	使用 PySide6（Qt for Python）构建，因此相同的界面可在 Windows 和 Linux 上运行。
安装选项	Windows 安装程序、便携式 exe、Debian/Ubuntu .deb、通用 Linux 便携式二进制文件，或一行安装脚本，可添加签名的仓库并拉入 aria2 以实现快速可续传下载。

底层工作原理

• yt‑dlp 用于搜索 YouTube、解析视频 URL 并提取音频流。
• FFmpeg（或随附的 imageio‑ffmpeg）将流转换为高品质 MP3。
• Aria2（由 Linux 安装程序安装）处理实际文件下载并支持续传。
• Keyring 安全地将任何 cookies 或 Discord tokens 存储在操作系统保险库中。
• GUI 是一个轻量级 Qt 层，协调这些工具并呈现熟悉的音乐播放器布局。

开始使用

1. 从 下载 表格下载适当的包（例如，Windows 的 ISpotify-Setup-x86_64.exe 或 Linux 安装脚本）。
2. 运行安装程序或便携式二进制文件；应用程序会为您的音乐库创建用户数据文件夹。
3. 打开应用程序，搜索曲目，然后点击下载按钮。后台队列完成后，文件会出现在您的音乐库中。
4. （可选）在设置 → Discord 中，链接您的 Discord 账户以广播您正在收听的内容。

谁可能会喜欢 – 想要 Spotify 流媒体应用的自主托管替代方案的音乐爱好者、偏好 Python 桌面工具的开发者，或任何想要完全保持收听数据隐私的人。

贡献 – 项目使用标准 Python 虚拟环境工作流程（python -m venv .venv && pip install -r requirements.txt）。欢迎通过 pull requests 贡献；请参阅 CONTRIBUTING.md 获取指南。

---

以上所有信息直接取自仓库的 README。