功能特性
现代播放器应有的一切。
没有用来博眼球的功能。每个细节都为你的日常聆听服务。
自动 Daily Mix
基于过去 90 天的收听记录生成三个歌单，并按节拍分组：舒缓、律动、活力。
外加基于规则的智能歌单编辑器：流派、BPM、年份、评分、格式、Hi-Res、收藏。
发烧级音频引擎
Symphonia 解码器、原生 DSD（DSF/DFF）、最高 24-bit 192 kHz Hi-Res，通过三个无锁线程进行 CPAL 输出。
ReplayGain、无缝播放、延迟低于 5 毫秒。全屏视图实时 FFT 频谱可视化。
5 种界面风格，70 种外观
Studio、Editorial、Lounge、Pulse 和 Liquid — 将每种与 14 种配色主题搭配，得到 70 种组合，按配置文件分别保存。
内置字体、每种风格独立的动效，以及一个「挑选氛围」的引导步骤。运行时零 Google Fonts 请求。
沙箱化插件 SDK
运行在 wasmtime 上的 WASM 组件，配合受权限管控的宿主导入 — 网络、存储、音频、UI。Web Radio 作为首个插件随附。
50 MB 上限、5 秒超时、SSRF 防护、离线阻断。一键启用、禁用或卸载。
WaveFlow Wrapped
用几张幻灯片讲述你的年度回顾：热门艺人、收听分钟、高峰时段、主导流派。
基于你的历史记录在本地计算。不发送任何数据，默认不分享任何指标。
心情电台
五个动态电台 — 专注、放松、运动、派对、睡眠 — 根据节奏和能量从你的音乐库筛选。
还有艺人专属电台：点击任何艺人即可开始相似曲目的无尽播放。
丰富的艺人页面
为你音乐库中的每位艺人提供传记、可点击的相似艺人、完整专辑列表和粉丝数。
传记可选来自 Deezer 或 TheAudioDB，也可自行撰写 — 手动覆盖完全离线工作。
内置 DLNA / UPnP 服务器
将音乐库投射到局域网中的 Sonos、Yamaha MusicCast、Kodi、VLC 或任何 UPnP 渲染器。无需配对，无需云端。
SSDP 发现、ContentDirectory、HTTP Range 流。在「设置 → 集成」中启用。
智能淡入淡出
经典淡入淡出，或智能（同专辑跳过淡入淡出）、动态（根据 BPM 差距调整）。
外加 Musicolet 风格的曲内 A-B 循环，以及 0.5× 至 2× 播放速度。
同步歌词，五大来源
依次从 Musixmatch、LRCLIB、NetEase、Megalobiz 和 Genius 级联检索 — 优先检查同名 .lrc / .txt 文件，让本地歌词永远不必联网。
内置编辑器支持逐词模式自动推进。可写回标签、随附文件或数据库，也可导出独立的 .lrc / .txt。
收听统计
GitHub 风格的 12 个月热力图、按时段的热门曲目/艺人/专辑、按流派的细分、每小时高峰、完播率。
隐藏你不关心的 KPI 卡片。年度 Wrapped 回顾及 JSON 导出 — 所有计算均在本地完成，从不发送到任何地方。
会自我归类的搜索
在顶部栏中输入，结果会分区返回 — 艺人、专辑和标题 — 让你立刻找到正确的那个。
由键盘驱动、带防抖且对过期查询安全；打开与关闭都无需离开当前页面。
沉浸式正在播放
重新设计的全屏视图，配以分页控制面板 — 歌词、播放队列和控制集于一处 — 并支持操作系统原生全屏。
不受界面风格影响、随处可读；过长的标题会在播放栏和沉浸式视图中以跑马灯形式滚动。
Discord 与 Last.fm
在 Discord 个人资料上显示 Spotify 风格的 Rich Presence。支持持久队列与指数退避的 Last.fm Scrobble。
外加操作系统媒体控制（MPRIS、SMTC、MediaRemote），支持你的多媒体键。
尊重你的音乐库
文件夹监控、拖放、基于哈希的重复检测、可点击的多艺人支持。
隔离的配置档案、可自定义专辑封面、.waveflow 归档导入/导出、定时的自动备份。首次扫描现在快约 4 倍。
100% 开源
Rust + React 代码托管在 GitHub，采用 GPL-3.0。审计、Fork、贡献都可以。无追踪器、无广告。
原生端使用 Tauri 2 + Rust，UI 使用 React 19 + TypeScript。支持 17 种语言。
智能歌单
为你定制的 Daily Mix。
基于过去 90 天收听记录生成的三个歌单。艺人按平均节拍分组，让每个歌单从早到晚都保持统一氛围。
Lo-fi、氛围音乐、抒情曲。工作、阅读、入睡的好伴侣。
流行、摇滚、嘻哈、独立。陪你度过午后的中速节奏。
舞曲、Drum & Bass、金属。运动、做家务、长途驾驶时的首选。
自定义智能歌单
构建你自己的规则。
不止自动 Daily Mix，你还可以用规则创建动态歌单：流派、BPM、年份、音频格式、POPM 评分、收藏。每当新曲目加入音乐库，歌单都会自动重新生成。
- 流派
- BPM
- 年份
- 评分 ≥ 3★
- 仅收藏
- 仅 Hi-Res
- FLAC 格式
- 时长
// 示例: { genre: "Jazz", year_min: 1955, year_max: 1965, hi_res_only: true, sort: "random", limit: 100 }
心情电台
五种心情。始终是你的音乐库。
WaveFlow 根据节奏、能量和频谱特征将你的曲目分为五个动态电台，并根据你的心情在它们之间切换。
每次会话都来源于你的本地目录。无流媒体，无赞助推荐。
你不会想离开的主页。
个性化问候、一目了然的统计、Wrapped 横幅、Mood Radio 和 Daily Mix — 都在同一视图。默认深色模式，喜欢的话可切换浅色。
界面风格
五种外观。七十种组合。
界面风格会重塑整个界面 — 布局、排版、玻璃质感与动效。将五种界面风格中的任意一种与 14 种配色主题搭配，得到 70 种外观，每种都按配置文件保存。从「设置 → 外观」切换，或在引导过程中挑选一种氛围。
Studio
默认受 Apple Music 启发的基础外观。简洁、深色优先 — WaveFlow 自带的外观。
Editorial
大报杂志式布局，搭配 Playfair Display 衬线字体、半调网点配图，以及华丽的 WaveFlow Gazette 报头。
Lounge
暖色玻璃在模糊专辑封面背景之上铺设暖色酒红玻璃 — Apple Vibrancy 风格的 backdrop-filter 配方。
Pulse
霓虹俱乐部OLED 霓虹俱乐部美学，配以品红/青色双色极光，以及随播放旋转的黑胶唱片封面。
Liquid
Vibrancy完整的 Apple Vibrancy，采用 8 层内嵌玻璃配方 — 随主题自适应，在浅色与深色下都很美。
所有字体均已内置 — Playfair Display、Lora、Space Grotesk、Space Mono、DM Sans。运行时零 Google Fonts 请求。
艺人页面
远不止是一份曲目列表。
为你音乐库中的每位艺人提供：传记、可点击的相似艺人、完整唱片目录、粉丝数 — 还有艺人专属电台让你继续探索。
如启用 Deezer，传记和相似艺人来自该服务；否则你的音乐库就足够。
网络投放
无需 Sonos S2 也能用上你的功放。
WaveFlow 会在局域网中以 UPnP MediaServer 的身份宣告自身。任何 DLNA 渲染器 — Sonos、Yamaha MusicCast、Kodi、VLC — 都能发现它并播放你的音乐库，无需专有配对，无需云端。
WaveFlow
MediaServer:1
- Sonos S2
- Yamaha MusicCast
- Kodi
- VLC
- BubbleUPnP
- 01
SSDP 通告
周期性广播到 239.255.255.250:1900 — 渲染器无需配置即可发现 WaveFlow。
- 02
DIDL-Lite 浏览
你的艺人和专辑像原生音乐库一样出现在渲染器界面中。
- 03
HTTP Range 流式传输
通过 HTTP Range 实现渐进式播放 — 精确拖动、断点续传、高效传输。
集成
与你的工具链愉快共处。
WaveFlow 自然接入你已经在用的服务 — 但运行时不依赖其中任何一个。
- DiscordRich Presence
- Last.fmScrobble + 艺人简介
- LRCLIB同步歌词
- Deezer元数据
- MPRISLinux 媒体键
- SMTCWindows Now Playing
Plugin SDK
安全地扩展 WaveFlow。
插件以沙箱化的 WASM 组件形式发布，基于 waveflow-plugin-sdk 接口构建。每一项能力 — 网络、存储、音频、UI — 均受限于你在安装时批准的权限。杜绝静默网络请求与文件系统访问。
设计即沙箱
WIT + wasmtime 运行时。面向 HTTP、存储、音频和 UI 的宿主导入 — 清单未声明的一概没有。
权限管控
每个宿主导入都在安装时获批。设置中提供每个插件的网络、存储和资源权限标签。
默认护栏
50 MB 最大体积、5 秒超时、不跟随重定向的 SSRF 防护，以及离线模式阻断。
一键管理
已安装插件列表，支持启用、禁用和卸载 — 版本与体积一目了然。
Web Radio，开箱即用。
超过 30,000 个在线广播电台
通过 radio-browser.info 接入互联网电台，使用与应用其余部分相同的 cpal 引擎进行流式播放 — 现在还带有实时的「正在播放」元数据、按配置文件的收藏、按国家浏览以及离线目录。EQ、ReplayGain 和频谱可视化在每一路实时流上同样可用。
- 按国家浏览，或一键直达本地电台。
- 按配置文件收藏你喜爱的电台 — 可在播放器、迷你播放器或沉浸式视图中操作。
- 实时 ICY 歌曲标题，配以来自 Deezer 的封面和当前曲目的同步歌词。
- 下载目录即可完全离线浏览和搜索电台。
运行在 wasmtime 上的 WASI 运行时。每个插件 50 MB 上限、5 秒 HTTP 超时、不跟随重定向、每次请求都有离线模式阻断。
本地优先
你拥有你的音乐。让我们夺回控制权。
无订阅
你的文件、你的播放器、终身使用。下载应用，就是这么简单。
无 DRM
FLAC、ALAC、MP3、AAC、OGG、WAV、DSD — 你的文件在哪里都能打开，永远如此。
无追踪
除可选的元数据补全外没有任何外发连接。离线模式一键启用。
无云端
全部存储在你的磁盘上。每个配置档案一个 SQLite。零成本迁移。
Hi-Res 与 DSD
24-bit 解码、最高 192 kHz、原生 DSF/DFF。Hi-Res 徽章会自动点亮。
多配置档案
每人独立音乐库，完全隔离。可导出 .waveflow 归档，可定时自动备份。
下载
为你的系统准备的 WaveFlow v1.6.0。
已签名的二进制文件，可通过 .sig 验证。无第三方安装程序，无嵌入式遥测。
Linux
x86_64 — 已在 Fedora 44 和 Ubuntu 26.04 上测试
macOS
Universal — Apple Silicon 和 Intel
Windows
x86_64 — Windows 10 22H2 及更新版本
或使用你的包管理器安装
更新将继续通过你常用的工具推送。
Windows · winget
winget install InstaZDLL.WaveFlowArch · AUR
yay -S waveflow-binFedora · Copr
sudo dnf copr enable instazdll/waveflow && sudo dnf install waveflowDebian / Ubuntu · APT
sudo install -d -m 0755 /etc/apt/keyrings curl -fsSL https://packages.buildkite.com/instazdll/waveflow/gpgkey | sudo gpg --dearmor -o /etc/apt/keyrings/waveflow.gpg echo "deb [signed-by=/etc/apt/keyrings/waveflow.gpg] https://packages.buildkite.com/instazdll/waveflow/any/ any main" | sudo tee /etc/apt/sources.list.d/waveflow.list sudo apt update && sudo apt install wave-flow
macOS 上暂无 Homebrew cask — 请获取上方的 .dmg。Debian 包名为 wave-flow（kebab-case，遵循 Debian 命名规范）。
常见问题
如果你的问题不在这里，请在 GitHub 上开 issue。
WaveFlow 真的免费吗？
是的，而且会一直免费。WaveFlow 采用 GPL-3.0 发布。无订阅、无高级套餐、无广告。
如何安装 WaveFlow v1.6.0？
使用适合你平台的包管理器：**Windows** 上 `winget install InstaZDLL.WaveFlow`，**Arch** 上 `yay -S waveflow-bin`，**Fedora** 上用 Copr 仓库（`dnf copr enable instazdll/waveflow`），或 **Debian/Ubuntu** 上用 APT 仓库（包名为 `wave-flow`）。也可在 GitHub releases 页面获取二进制文件：**Linux** 的 AppImage 是便携的（`chmod +x`），或安装 .deb / .rpm。在 **macOS** 上，打开 .dmg 并将 WaveFlow 拖入 Applications — 该 bundle 未经 Apple Developer 签名，首次启动请右键 → 打开（或运行 `xattr -cr /Applications/WaveFlow.app`）。在 **Windows** 上，.msi 为静默安装，.exe 为经典安装程序。
支持哪些音频格式？
通过 Symphonia 解码器支持 MP3、FLAC、ALAC、AAC、OGG Vorbis、WAV，并通过专用管线支持 DSD（DSF / DFF）。24-bit 或 ≥ 44.1 kHz 时，Hi-Res 徽章会自动亮起。
Daily Mix 如何工作？
WaveFlow 扫描你最近 90 天的播放记录，按平均节奏对艺人进行分组（< 95 BPM、95-130、≥ 130），并生成三个固定顺序的歌单 — 另外还有五个按节奏和能量筛选的 Mood Radio 电台（专注、放松、运动、派对、睡眠）。主页上的「重新生成」按钮即可刷新它们。你还可以按规则创建自己的智能歌单。
能投放到我的 Hi-Fi 上吗？
可以。WaveFlow 将你的音乐库作为 DLNA / UPnP 服务器开放。Sonos S2、Yamaha MusicCast、Kodi、VLC 等兼容渲染器都会在网络上看到它 — 无云端、无专有配对。在「设置 → 集成」中启用。
我的数据会离开本机吗？
不会。音乐库、播放记录、歌单和统计都本地存储在 SQLite 中。只有可选的元数据补全（Deezer、Last.fm、LRCLIB）会发起外部请求 — 全局离线模式一键全部切断。
WaveFlow 能替代 Spotify 或 Apple Music 吗？
流媒体方面不行。但对本地音乐库来说可以 — 同等界面品质、自动 Daily Mix、Hi-Res、DLNA，而且零云端依赖。
支持 Discord 和 Last.fm 吗？
支持。Spotify 风格的 Discord Rich Presence 会显示专辑封面。已认证的 Last.fm Scrobble 支持持久队列与自动重连。两者都是可选启用，随时可禁用。
我可以贡献吗？
非常欢迎。项目托管在 GitHub，使用 Rust（Tauri 2）和 React 19 + TypeScript。Issue、PR 和翻译都欢迎。
能获取 beta 版本吗？
可以。WaveFlow 提供可选启用的 beta 更新通道 — 在「设置 → 更新」中切换即可提前获得预发布版本，或继续留在稳定版。你可以随时切换回来。
内存占用是多少？
空闲时约 80 MB，包含 10,000 首曲目的音乐库播放时约 150 MB。扫描器在首次索引时占用会临时增加，随后恢复稳定。
能在多台机器间同步音乐库吗？
没有官方云服务，但 SQLite 数据库是单个文件，你可以放进 Syncthing、Dropbox 或任何自托管服务。.waveflow 导出会把配置档案、数据库和专辑封面打包成单个归档。
有离线模式吗？
WaveFlow 默认就是离线 — 这正是项目的精神。全局离线模式一键切断 Deezer、Last.fm、LRCLIB 和相似艺人发现。