Riff：开源桌面音乐播放器

项目简介

Riff 是一款免费开源的桌面音乐播放器，使用 Electron、原生 JavaScript 和 WebGL 构建，把 YouTube Music、YouTube、SoundCloud 的在线播放与本地离线音乐统一到同一个界面中。界面遵循 Material Design 3（M3 Expressive）规范，无广告、无遥测、播放无需账号，所有配置、缓存流媒体和播放记录都只保存在本机。支持 Windows、macOS（实验性）与 Linux，以 MIT 许可证发布。

主要功能

• 多源播放：直接解析 YouTube Music、YouTube、SoundCloud 的音源，无需第三方广告或登录。
• 本地曲库：支持 FLAC、WAV、MP3、OGG、M4A 等格式的离线播放与完整本地库管理。
• 内置音频套件：可视化无损裁剪与片段提取；10 段参数均衡器（32 Hz–16 kHz，含 Bass Boost、Vocal Clarity、Electronic、Flat、Rock 预设）；实时 DSP 效果链，包括变速不变调、独立升降调、混响与失真。
• 下载管线：把在线音源下载到本地（MP3、FLAC、Opus、WAV），自动写入 ID3 元数据与高清封面，支持完整离线歌单与搜索索引。
• 歌单迁移：一键导入 Spotify（含 100 首以上的分页歌单）、Apple Music、Deezer、SoundCloud、YouTube Music 的公开歌单，并按所选平台检索匹配曲目。
• 外观与主题：从专辑封面动态提取配色生成界面调色板，支持横幅背景、网格渐变、模糊滤镜、排版控制，以及内置 CSS 编辑器直接覆盖样式；提供紧凑迷你播放器、桌面展开和全屏 TV / 卡拉 OK 三种布局。
• 可视化与歌词：Canvas / WebGL 实时频谱可视化、可交互的波形进度条，以及同步歌词引擎，支持 LRC 文件、在线时间轴对齐、手动偏移与多语言翻译。
• 其他：Discord Rich Presence 实时展示播放状态、插件机制、全屏歌词动画、艺人专辑浏览。

安装与使用

预编译安装包发布在 Releases 页面，官网为 riff.hs.vc。Windows 与 Linux 的标准发行版已内置 yt-dlp 和 ffmpeg，无需额外配置；Windows 安装器可选安装目录，卸载不会删除应用数据。

macOS 目前为实验性支持，需按芯片选择 Riff-<version>-mac-arm64.dmg 或 Riff-<version>-mac-x64.dmg，拖入 Applications 目录，首次启动需右键选择“打开”。若提示应用已损坏，可在终端执行：

xattr -cr /Applications/Riff.app

macOS 上建议用 Homebrew 安装依赖（下载与音频编辑需要 ffmpeg，纯播放不需要）：

brew install yt-dlp ffmpeg

从源码构建需要 Node.js 18 及以上与 npm：

git clone https://github.com/rootscripts/riff.git
cd riff
npm install
npm start        # 运行开发版本
npm run dist     # 生成生产构建

注意事项

• 项目仅由核心团队维护，公开 Pull Request 已关闭；问题请通过 Issues 反馈，自定义功能可自行 fork。
• 官方没有 Android 或 iOS 客户端，第三方社区分支见 这里。
• 单渲染进程加服务进程的常态播放内存占用约 180 MB，实际随可视化模式、曲库大小和系统窗口合成而变化。
• macOS 数据与本地索引存放于 ~/Library/Application Support/Riff。
• 可选 Google 登录仅用于导入自己的 YouTube 点赞与歌单，播放本身不需要账号。

本作品整理自 GitHub 开源项目 rootscripts/riff，原作者 @rootscripts，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。