Releases: zyw0815/Qrip
Release list
Qrip v0.4.0
v0.4.0 — Download Verification & Auto-Repair
🛡️ Every download is now verified
- FLAC integrity check: every frame's CRC-8 + CRC-16 is verified against the FLAC spec, plus a completeness check against the stream's total sample count — truncated or corrupted files are detected reliably. Runs in the background, ~20s for a 220MB hi-res track.
- Duration vs official: each track's playtime is compared with Qobuz's official metadata (±2s tolerance), catching wrong or incomplete content.
🔁 Broken tracks repair themselves
A track that fails verification is deleted and re-downloaded individually — it lands back in its original folder with its original name, up to 2 attempts. If it still fails, the task appears in the Failed section listing exactly which tracks are broken (good files are kept), with the usual Retry button.
🧹 Clearable completed list
The Completed section now has a ✕ Clear button with a "Delete files too" checkbox — clear the session history, optionally freeing disk space. (Guardrails: only files inside your download folder are ever touched.)
⬇️ Downloads
- macOS (Apple Silicon): Qrip-0.4.0-arm64.dmg
- Windows (x64): Qrip Setup 0.4.0.exe
v0.4.0 — 下载校验与自动修复（中文）
🛡️ 每个下载都经过验证
- FLAC 完整性校验：逐帧验证 CRC-8 + CRC-16 错误检测码，并与流总采样数核对——截断、损坏的文件可靠检出。后台运行，一首 220MB 无损约 20 秒。
- 时长比对官方：每首曲目的播放时长与 Qobuz 官方元数据比对（±2 秒容差），识别内容错误或不完整。
🔁 坏轨自动修复
校验失败的曲目会被删除并单独重新下载——自动落回原文件夹、原名，最多尝试 2 次。仍然失败的任务会进入失败区，明确列出坏掉的曲目（好文件保留），并可照常重试。
🧹 完成记录可清空
完成区新增「✕ 清空」按钮和「同时删除文件」复选框——可清理本次会话的完成记录，可选释放磁盘空间。（安全保证：只会删除下载目录内的文件。）
⬇️ 下载
- macOS（Apple Silicon）：Qrip-0.4.0-arm64.dmg
- Windows（x64）：Qrip Setup 0.4.0.exe
Qrip v0.3.3
v0.3.3 — Crash Fix & Diagnostics
For Windows users: the crash-after-login issue is fixed. The most common cause was Windows Defender quarantining the backend (qrip-server.exe) — unsigned apps are frequently false-flagged. Now:
- A failed backend start no longer crashes the app with a "JavaScript error" popup — it shows a clear dialog explaining the antivirus cause, with restore/whitelist steps (bilingual).
- All backend output is logged to
%APPDATA%\Qrip\backend.log(macOS:~/Library/Application Support/Qrip/backend.log, rolled at 1MB) — attach it when reporting issues. - If the Qobuz login page can't be opened (network / region), the app now says so instead of leaving a blank window.
Troubleshooting guide added to the README (EN + 中文): Windows Defender quarantine recovery and proxy/VPN notes (the backend needs to reach play.qobuz.com directly — TUN/virtual-adapter mode required if you use a system-proxy-only VPN).
⬇️ Downloads
- macOS (Apple Silicon): Qrip-0.3.3-arm64.dmg
- Windows (x64): Qrip Setup 0.3.3.exe
v0.3.3 — 闪退修复 + 故障诊断（中文）
Windows 用户请注意：登录后闪退的问题已修复。最常见原因是 Windows Defender 隔离了后端程序（qrip-server.exe）——未签名应用经常被误报。现在：
- 后端启动失败不再弹「JavaScript error」崩溃窗口——会显示明确的双语错误提示，说明杀软隔离原因，并给出恢复文件、添加白名单的步骤。
- 后端全部运行日志写入
%APPDATA%\Qrip\backend.log（macOS 为~/Library/Application Support/Qrip/backend.log，超 1MB 自动滚动）——反馈问题时请附上该文件。 - Qobuz 登录页打不开（网络/地区原因）时，应用会明确提示，不再留一个空白窗口。
README（中英双语）新增「常见问题」小节：Windows Defender 误杀恢复步骤，以及代理/VPN 说明（后端需要直连 play.qobuz.com，仅系统代理模式的 VPN 需切换到 TUN/虚拟网卡模式）。
⬇️ 下载
- macOS（Apple Silicon）：Qrip-0.3.3-arm64.dmg
- Windows（x64）：Qrip Setup 0.3.3.exe
Qrip v0.3.2
v0.3.2 — Hotfix + Faster Startup
Fixes:
- Search / resolve "Internal Server Error": on machines that also have a streamrip source checkout (e.g. developer machines), the packaged backend wrongly loaded that unmodified streamrip instead of the vendored one embedded in the app. The packaged backend now always uses the embedded version.
- Much faster startup: the backend is now bundled as a directory (onedir) instead of a single compressed file, so there's no more per-launch extraction. Cold start went from ~20s to ~2s (app ready in ~9s).
Upgrade: Install over v0.3.0 — no need to log in again (credentials are kept).
⬇️ Downloads
- macOS (Apple Silicon): Qrip-0.3.2-arm64.dmg
- Windows (x64): Qrip Setup 0.3.2.exe
v0.3.2 — 紧急修复 + 启动提速（中文）
修复内容：
- 搜索/解析报「Internal Server Error」：如果电脑上同时存在 streamrip 源码仓库（比如开发者机器），打包版后端会错误加载未修改的官方 streamrip 而不是应用内嵌的修改版。现在打包版始终使用内嵌版本。
- 启动大幅提速：后端改为目录模式打包（onedir），不再每次启动解压 27.9MB 单文件。冷启动从约 20 秒降到约 2 秒（应用 9 秒左右可用）。
升级方式：直接覆盖安装 v0.3.0 即可，无需重新登录（凭据保留）。
⬇️ 下载
- macOS（Apple Silicon）：Qrip-0.3.2-arm64.dmg
- Windows（x64）：Qrip Setup 0.3.2.exe
Qrip v0.3.0
What's New in v0.3.0
🔧 Fixes that matter
- Settings are now saved — download folder, audio quality, file/folder templates and artwork options survive restarts. (Previously every launch silently reset them.)
- Audio quality fixed — the app showed 24-bit/192 kHz while actually downloading 24/96, and selecting MP3 320 broke downloads entirely. Quality now maps correctly end-to-end.
- Cover options actually work — embedded cover size and saved-cover max width were silently ignored; they're now applied and persisted.
- Failed downloads are visible — failed tasks show the error reason and a Retry button instead of vanishing. Completed tasks are listed too.
- Accurate progress & speed — the progress bar no longer counts your previously downloaded albums into the current task.
- Login survives restarts — the app no longer gives up waiting for the backend and drops you to the login screen.
- Faster, deeper search — "Load more" fetches only the next page and works past 500 results.
- Playlists start instantly — removed a multi-minute size estimate on big playlists (rate-limited API calls).
- About shows the real version — now read from the app instead of hardcoded.
- macOS signing — CI builds are ad-hoc signed, so the app no longer shows the "damaged" error (Gatekeeper will still ask you to right-click → Open, since there's no Apple Developer certificate).
⬇️ Downloads
- macOS (Apple Silicon): Qrip-0.3.0-arm64.dmg
- Windows (x64): Qrip-0.3.0.exe
v0.3.0 更新内容（中文）
🔧 重要修复
- 设置终于会保存了 — 下载目录、音质、文件/文件夹模板、封面选项重启后不再丢失（之前每次启动都被悄悄重置）。
- 修复音质错位 — 之前界面显示 24-bit/192 kHz，实际下载的是 24/96；选 MP3 320 会直接下载失败。现在音质端到端正确映射。
- 封面选项真正生效 — 内嵌封面尺寸和保存封面最大宽度之前被静默忽略，现在会正确应用并保存。
- 失败的下载不再消失 — 显示错误原因和重试按钮；已完成的任务也会列出。
- 进度和速度准确 — 进度条不再把以前下载好的专辑算进当前任务。
- 登录状态跨重启保留 — 不再因为等待后端超时而把你踢回登录页。
- 搜索翻页更快更深 — 「加载更多」只拉取下一页，超过 500 条结果也能继续加载。
- 歌单点击即开始下载 — 去掉了大歌单下载前数分钟的预估等待（受 API 限速影响）。
- 关于页显示真实版本号 — 从应用读取，不再硬编码。
- macOS 签名 — CI 构建的包已做 ad-hoc 签名，不再报「已损坏」（因为没有 Apple 开发者证书，仍会提示「无法验证开发者」，右键 → 打开即可）。
⬇️ 下载
- macOS（Apple Silicon）：Qrip-0.3.0-arm64.dmg
- Windows（x64）：Qrip-0.3.0.exe
Qrip v0.2.0
English | 中文
Qrip v0.2.0
What's New
🌐 Language support (English / 中文)
- New Language setting under Settings → General — switch between English and Chinese instantly, applies to the entire UI
- Language toggle also available on the login page, so first-time users can pick their language before signing in
- Choice is saved and restored on restart
- Template tokens are localized too (e.g.
{artist}shows as{歌手}in Chinese mode) — the actual config format stays in English, so downloads are unaffected
🛠 Template editor rework
+ Customnow opens with a blank template — build from scratch⌫ Delete Lastremoves a whole token or separator instead of one character✕ Closediscards the edit and restores the previous template;✓ Savecommits it- Saving rejects empty or token-less templates with an error message
📦 Packaging & CI
- CI builds only on version tags (no more builds on every push)
- Release flow: merge to main → tag
v*→ auto-build both platforms
⚖️ Licensing
- License changed from MIT to GPL-3.0 (Qrip vendors the GPL-3.0 streamrip library, so the combined work must be GPL-3.0)
- README now carries a Disclaimer; docs available in English and Chinese
Downloads
| Platform | File |
|---|---|
| macOS (Apple Silicon, 11+) | Qrip-0.2.0-arm64.dmg |
| Windows (10+) | Qrip Setup 0.2.0.exe |
No Python install needed — the backend ships as a standalone binary inside the app.
The installers are unsigned: macOS shows an 'unidentified developer' warning (right-click → Open), Windows SmartScreen asks for confirmation.
中文
Qrip v0.2.0
更新内容
🌐 语言支持（English / 中文）
- 设置 → 通用 新增语言选项，中英文即时切换，覆盖整个界面
- 登录页也提供语言切换，首次使用的用户登录前即可选择语言
- 选择会保存并在重启后恢复
- 模板占位符同步本地化（中文模式显示
{歌手}，实际配置仍是英文格式，下载不受影响）
🛠 模板编辑器重构
+ 自定义现在以空白模板打开，从零搭建⌫ 删除末位一次删除整个占位符或分隔符，不再逐字符删✕ 关闭= 放弃编辑并恢复原模板；✓ 保存= 提交生效- 保存时拒绝空模板或没有占位符的模板并提示错误
📦 打包与 CI
- CI 只在版本标签时构建（不再每次 push 都打包）
- 发布流程：合并 main → 打
v*标签 → 自动构建双平台安装包
⚖️ 许可证
- 许可证由 MIT 改为 GPL-3.0（Qrip 内置了 GPL-3.0 的 streamrip 库，组合作品必须同为 GPL-3.0）
- README 增加免责声明，文档提供中英双语
下载
| 平台 | 文件 |
|---|---|
| macOS（Apple 芯片，11+） | Qrip-0.2.0-arm64.dmg |
| Windows（10+） | Qrip Setup 0.2.0.exe |
无需安装 Python——后端已编译为独立二进制内置在应用中。
安装包未签名：macOS 会有「无法验证开发者」提示（右键 → 打开），Windows SmartScreen 会询问确认。
See README for details.
Qrip v0.1.0
English | 中文
Qrip v0.1.0 — First Public Release
A desktop GUI for downloading hi-res music from Qobuz — Electron + React + FastAPI on top of streamrip.
What's New
- Sign in with Qobuz: popup login captures the auth token automatically (Google / Apple / email all work); token paste as fallback. Fresh session every login — easy account switching.
- Search & browse: keyword search for albums / tracks / playlists with covers, quality tags, year and duration; load-more pagination.
- Paste a link: Qobuz track / album / playlist URLs download directly.
- High-res downloads: up to 24-bit / 192 kHz FLAC, configurable quality.
- Downloads tab: live progress bars, speed, queue — pause / resume / delete with partial-file cleanup on cancel.
- Naming templates: presets + custom tokens with live preview; cover embed options.
- Settings: download folder picker, quality tiers, artwork options, sign out.
Downloads
| Platform | File |
|---|---|
| macOS (Apple Silicon, 11+) | Qrip-0.1.0-arm64.dmg |
| Windows (10+) | Qrip Setup 0.1.0.exe |
No Python install needed — the backend ships as a standalone binary inside the app.
The installers are unsigned: macOS shows an 'unidentified developer' warning (right-click → Open), Windows SmartScreen asks for confirmation.
中文
Qrip v0.1.0 — 首个公开发布
基于 streamrip 的 Qobuz 高解析度音乐下载桌面 GUI——Electron + React + FastAPI。
更新内容
- 登录 Qobuz：弹窗登录自动抓取 auth token（Google / Apple / 邮箱均可）；支持粘贴 token 备用。每次登录都是全新会话，换账号方便。
- 搜索浏览：按关键词搜索专辑 / 曲目 / 歌单，展示封面、音质标签、年份、时长；支持加载更多翻页。
- 粘贴链接：Qobuz 曲目 / 专辑 / 歌单链接直接下载。
- 高解析度下载：最高 24-bit / 192 kHz FLAC，音质可调。
- 下载页：实时进度条、速度、队列——支持暂停 / 恢复 / 删除，取消时自动清理半成品文件。
- 命名模板：预设 + 自定义 token 带实时预览；封面内嵌选项。
- 设置：下载目录选择、音质档位、封面选项、退出登录。
下载
| 平台 | 文件 |
|---|---|
| macOS（Apple 芯片，11+） | Qrip-0.1.0-arm64.dmg |
| Windows（10+） | Qrip Setup 0.1.0.exe |
无需安装 Python——后端已编译为独立二进制内置在应用中。
安装包未签名：macOS 会有「无法验证开发者」提示（右键 → 打开），Windows SmartScreen 会询问确认。
See README for details.