refryt：Rust 原生 YouTube

18次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 refryt

refryt 中文版下载|Windows+macOS+Linux（Rust 原生 YouTube Music 桌面客户端）

30 秒速读：听 YouTube Music 不想开浏览器标签页？refryt 是用 Rust 写的原生桌面客户端，背后没有浏览器引擎，播放直接走 mpv，和 YouTube 网站用同一套内部 API 通信。它有首页、探索、搜索、媒体库、同步歌词、可编辑播放队列和音乐视频，23 套主题可换，还支持窗口透明和背景模糊。内存占用通常只有 100–300MB，比浏览器标签页省得多。本篇讲清各平台发行包怎么选、登录的三种方式、安装卡点和装完必调的 5 个设置。注意 README 的原话：Windows 和 macOS 构建的测试远少于 Linux，macOS 只支持 Apple Silicon。

软件信息表

软件名称	refryt（原生 YouTube Music 桌面客户端）
开发语言	Rust；界面用 egui，无浏览器引擎
播放链路	mpv 负责音频播放；部分包内置 yt-dlp
数据源	YouTube 内部 API（与网站同源）；同步歌词走 LRCLIB
核心功能	首页/探索/搜索/媒体库、同步歌词、可编辑队列、音乐视频、播放列表管理、本地文件浏览、离线下载
外观	23 套主题（纯 CSS 文件，可手改）；可选窗口透明与背景模糊；专辑页头可取色随封面
内存占用	通常 100–300MB，视会话而定
发行格式	Linux：AppImage / Flatpak / AUR（非官方）；Windows：安装包 / MSI / Zip，另有 ARM64 构建；macOS：Apple Silicon DMG
数据位置	Linux：~/.config/refryt；macOS：~/Library/Application Support/refryt；下载：~/Music/refryt
开源协议	GPL-3.0-or-later
更新机制	启动时向 GitHub 查询最新 release，有更新则提示，可在”设置→关于”关闭

各平台发行包怎么选：结论先行

平台	推荐	说明
Linux（日常主力）	AppImage	作者日常使用的构建，测试最充分；下载后 chmod +x 直接跑，附带脚本可装/卸启动器
Linux（沙箱偏好）	Flatpak	暂未上 Flathub，需从文件安装；沙箱内浏览器导入和开机启动被隐藏，只能应用内登录
Linux（Arch）	AUR refryt-bin（非官方）	重打包 AppImage；依赖系统 webkit2gtk-4.1（应用内登录窗口用）和 yt-dlp
Windows	安装包（普通用户）/ MSI（静默部署）	安装程序未签名，首次运行 SmartScreen 会警告；Zip 版解压即用，注意 DLL 要和 exe 放一起
Windows on ARM	ARM64 MSI/Zip	原生 ARM64 构建，但作者声明未在 ARM 硬件上实测过；x64 版也可走系统模拟跑
macOS	DMG	仅 Apple Silicon；临时签名未公证，首次启动需放行；也可用作者的 Homebrew tap

明确取舍：Linux 用户无脑选 AppImage（测试覆盖最好）；图省事想包管理器管更新的，Windows 用 Scoop、macOS 用 Homebrew，但这类渠道只提示新版本、更新要自己动手；Windows/macOS 用户装完先验证登录和播放，别默认和 Linux 版一样稳。

安装步骤（只写卡点）

去 Releases 页下对应系统的包，每个 release 都带 refryt-<version>-SHA256SUMS.txt，用 sha256sum -c 先校验再装，别跳过这步。
macOS 首次启动被拒：终端跑一次 xattr -cr /Applications/Refryt.app，或去”系统设置→隐私与安全性”里手动放行（临时签名+未公证的正常代价）。
Windows 安装包未签名：SmartScreen 弹窗点”更多信息→仍要运行”；企业批量装直接用 MSI 加 /qn 静默参数。
Linux Flatpak：装完发现”从浏览器导入”和”开机启动”两个选项不见了——这是沙箱限制，不是 bug，只能用应用内窗口登录。
登录三选一：①应用内窗口直接登录（全平台）；②导入已登录浏览器的会话（Chrome/Chromium/Firefox/Brave/Vivaldi/Edge，Windows 下只有 Firefox 可用）；③从浏览器开发者工具复制 cookie 请求头粘贴。都不登录也能搜能放，但没有媒体库和账号同步。
离线下载是 Premium 功能：应用会查账号的 Paid memberships 页面并在设置里显示结果，非 Premium 账号看不到下载入口。

装完必改的 5 个设置

音频质量与音量归一化：播放走 mpv，设置里有音频质量档和基于 YouTube 响度数据的音量归一化。切歌音量忽大忽小的人先把归一化打开，体感提升最大。
主题与透明度：23 套主题是配置文件夹 themes 目录里的纯 CSS 文件，能直接改、能新增、删了也行，窗口重获焦点时自动重读。透明度滑杆和背景模糊开关在”设置→外观”，模糊效果依赖系统（KDE Plasma Wayland、Windows 亚克力、macOS 均可）。
播放行为：快捷键跟 Spotify 桌面版（空格播放/暂停、F 全屏播放器、Esc 关队列、Ctrl+S 随机、Ctrl+R 循环、Ctrl+K 跳搜索）。默认单击选中、双击播放，不习惯就去设置里改成单击播放。
桌面集成：托盘图标、开机启动、媒体键（Linux MPRIS / Windows SMTC / macOS 随航播放）按需开；Discord Rich Presence 默认关闭，想在 Discord 显示听歌状态再手动开。
更新检查：”设置→关于”里可以关掉启动时的 GitHub 版本检查，也可以手动触发。注意只有 Windows 安装包/MSI 和 AppImage 支持应用内自动更新并校验 SHA256，Flatpak/DMG/Zip/Homebrew/Scoop/AUR 渠道只提示新版本，更新走原来的安装方式。

独家整理：refryt vs 网页版 vs Electron 类客户端

维度	refryt	网页版 YouTube Music	Electron 封装类客户端
内存占用	100–300MB，原生	随浏览器标签波动，常更高	Electron 底座开销大
同步歌词	内置，全屏播放器直接看	基础歌词展示	看各家实现
桌面集成	托盘/媒体键/开机启动原生	依赖浏览器媒体键支持	走 Web API 封装
离线下载	Premium 可存 ~/Music/refryt，带标签和封面	以移动端离线为主	看各家实现
隐私	无遥测（只连 YouTube / LRCLIB / GitHub 更新检查）	Google 账号体系追踪	看各家实现
成熟度	1.0 之前，Windows/macOS 测试少	官方，最稳	参差不齐

一句话：要桌面原生体验+低内存+可折腾主题选 refryt；图省心、要官方同步和稳定性，直接用网页版；Electron 客户端除非有独家功能，否则内存账上不划算。

注意事项与常见问题

项目在 1.0 之前，变化快：作者明确写了 Windows 和 macOS 构建”测试少得多”，生产环境（比如主力听歌机）先在自己设备上把登录、播放、下载走一遍再长期用。
非官方客户端的定位：README 的 Disclaimer 写得很直白——它不是盗版工具（不托管、不分享、不解锁内容，所有歌曲都从登录的 YouTube 账号走流媒体），但它用的 YouTube 未公开内部 API，落在 YouTube 服务条款之外，用之前自己掂量。
下载仅限 Premium：应用会检查登录账号的付费会员状态，非 Premium 没有下载入口；下载的文件仅供个人离线收听，不要二次分发。
歌词来源：同步歌词走 LRCLIB，不是 YouTube 官方歌词，个别小众歌曲可能对不上或缺失。
崩溃报告：崩溃后会在配置目录写报告，下次启动时提供复制或生成预填的 GitHub issue 链接，不会自动上传，隐私上可以放心。