riff README

项目的 README,来自 github.com/rootscripts/riff。合并为一个 markdown 文件:README.md。

Riff

Desktop music player for YouTube Music, SoundCloud, and local audio.

Release Downloads Platforms License

Overview • Features • Architecture • Getting Started • Building • macOS Notes • Contributing • License


изображение

Overview

Riff is the best open-source desktop music player for Windows, Linux, and macOS. It streams from YouTube Music, YouTube, and SoundCloud without ads, and plays local audio files (FLAC, WAV, MP3, OGG).

No account or subscription required. No tracking or telemetry. Never.


Features


Architecture

Riff is built with Electron and runs an internal proxy server alongside a Vanilla JS and WebGL renderer.

riff/
├── assets/              # Icons and UI presets
├── scripts/             # Build and packaging scripts
├── src/
│   ├── main/            # Electron main process
│   │   ├── main.js      # App lifecycle, window management, and IPC
│   │   ├── discord.js   # Discord Rich Presence
│   │   ├── launcher.js  # yt-dlp and ffmpeg runner
│   │   ├── plugins.js   # Plugin loader
│   │   ├── preload.js   # Context bridge to renderer
│   │   ├── themes.js    # Theme and custom CSS handler
│   │   └── updater.js   # Auto-update manager
│   ├── renderer/        # Frontend UI (Vanilla JS & HTML5)
│   │   ├── audio.js     # Web Audio API playback engine
│   │   ├── styles.css   # Main stylesheet
│   │   └── modules/     # UI modules
│   │       ├── eq.js    # Equalizer and audio filters
│   │       ├── lyrics.js# Synced lyrics renderer and parser
│   │       ├── visualizer.js # WebGL and canvas visualizers
│   │       ├── library.js    # Local file indexing
│   │       ├── import.js     # Playlist importer
│   │       └── ui.js         # UI controls and color extraction
│   ├── server/          # Local backend proxy
│   │   ├── server.js    # Stream resolution and caching
│   │   └── tools.js     # Media extractors
│   └── shared/          # Shared constants and schemas
├── vendor/              # Bundled binaries
├── package.json
└── LICENSE

Getting Started

Prerequisites


Setup

git clone https://github.com/rootscripts/riff.git
cd riff
npm install

Running in Development

npm start

Building

# Build for your current OS (output goes to dist/)
npm run dist

Pre-built binaries for Windows (.exe), Linux (.AppImage), and macOS (.dmg) are also available on Releases.


macOS Notes

macOS releases are ad-hoc signed. If Gatekeeper blocks the app on first launch:

  1. Right-click Riff.app in /Applications, click Open, and confirm. On macOS 15+, open System Settings → Privacy & Security and select Open Anyway.
  2. If macOS reports the bundle as damaged, run:
    xattr -cr /Applications/Riff.app
    
  3. On Apple Silicon, installing dependencies via Homebrew is recommended:
    brew install yt-dlp ffmpeg
    

Contributing

Contributing is not welcome and we will never open pull request tab, the app is developed exclusively by our core team, please do not write us if you want to join or something


License

Distributed under the MIT License.

riff (rootscripts/riff)

正在搜索数据库…

935 ·GitHub
这是什么?Riff 是一款免费、开源的桌面音乐播放器,基于 Electron 构建,将 YouTube Music、YouTube、SoundCloud 和本地文件整合到同一个界面中,没有广告、无需账号,也不做任何追踪。
这是 Electron 应用,还是更轻量的版本?它是一个完整的 Electron 桌面应用,使用原生 JavaScript(Vanilla JavaScript)和 WebGL 进行渲染,而不是轻量级的原生客户端。
我该如何安装 Riff?从 Releases 页面下载预编译的二进制文件即可。Windows 和 Linux 版本已内置 yt-dlp 和 ffmpeg,无需额外配置运行环境。macOS 版本未签名且仍处于实验阶段,需要通过右键点击“打开”的方式运行,并通过 Homebrew 安装所需的二进制文件。
macOS 版本已经完全可用了吗?官方有移动端应用吗?macOS 支持仍处于实验阶段,且应用未签名,因此你需要手动允许其运行;目前没有官方的 Android 或 iOS 应用,只有社区分支版本。
我可以在没有网络连接的情况下使用 Riff 吗?可以,已下载的歌曲、已保存的音频片段以及已建立索引的本地音乐库,都可以完全离线使用。
Riff 会追踪或上传我的收听数据吗?不会。Riff 不收集任何遥测数据,所有配置、缓存的音频流和播放历史都严格保存在本地设备上。
Riff 真的完全免费,没有付费版吗?是的,Riff 采用宽松的 MIT 许可证发布,没有订阅费、付费墙或高级版本。
我可以把 Spotify 歌单导入 Riff 吗?可以。粘贴公开的 Spotify、Apple Music、YouTube Music 或 SoundCloud 歌单链接,Riff 就能解析其中的歌曲,并生成可编辑的本地歌单,即使歌单包含 100 首以上的歌曲也没问题。
我能在应用内进行哪些音频编辑?Riff 内置了可视化编辑器,支持无损裁剪和区段提取;还有一个 10 段参数均衡器,以及速度、音调、混响和失真等实时 DSP 效果。
Riff 能在 Discord 中显示吗?可以。它原生支持 Discord Rich Presence,可显示当前歌曲的标题、艺术家、已播放时长以及来源平台。
我能更改 Riff 的外观或行为吗?Riff 支持 Material Design 3 动态取色主题,内置 CSS 编辑器用于自定义样式,并提供插件系统以添加新功能。
大小
8.9 MB
星标
935
时长
1个月
提交 · 90 天