Termune 是一款面向飞牛 NAS 音乐的跨平台终端播放器。 无需打开浏览器或桌面音乐客户端,在终端中即可连接自己的 NAS,浏览曲库、搜索歌曲、管理歌单并播放音乐。
轻量、免安装,支持 Windows、macOS 和 Linux。支持通过 FN ID 自动发现 NAS,也可以直接填写 NAS 地址。
Termune 已在 macOS、Linux 和 Windows 环境中实际运行。以下截图来自真实设备,并非模拟界面。
macOS · Btop 布局
Linux · Airwave 布局
Windows · PowerShell · Btop 布局
支持 Windows、macOS 和 Linux,使用 Rust 构建。Termune 是独立开发的第三方客户端,与飞牛官方没有隶属、合作或背书关系。
| 功能 | 说明 |
|---|---|
| NAS 连接 | FN ID 自动发现,支持通过域名或 IP 直连 |
| 曲库浏览 | 浏览专辑、歌手、风格、全部歌曲、收藏和歌单 |
| 搜索 | 在曲库中快速查找歌曲 |
| 歌单管理 | 创建歌单、重命名、删除,以及添加或移除歌曲 |
| 播放控制 | 暂停、继续、停止、切歌、进度跳转和音量调节 |
| 播放模式 | 顺序播放、列表循环、单曲循环和随机播放 |
| 歌词 | 支持带时间戳歌词同步、手动浏览和歌词定位 |
| 音效 | 内置六种预设,包括空间 3D 和全景环绕,支持播放中切换 |
| 多种界面 | 专业布局与极简模式,支持主题和中英文界面 |
| 自动登录 | 可将登录会话保存在系统凭据存储中 |
| 记忆位置 | 记住上次浏览的分类、页面和选中位置 |
| 自更新 | 在终端中检查并安装最新正式版本 |
Termune 提供完整的交互式终端界面,支持键盘和鼠标操作:
- 多种专业布局:Airwave、Operations、Tracker 和 Btop。
- 极简模式:保留曲库与基本播放控制,减少界面信息。
- 个性化设置:切换主题、语言、布局和显示模式。
- 播放队列:队列保持开始播放时的来源,浏览其他分类不会打断当前播放。
- 歌词同步:带时间戳的歌词跟随播放进度,也可以手动浏览或双击歌词跳转。
- 音效预设:可在播放过程中切换不同听感。
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/Nyakooo/termune/master/install.sh | sh
Windows(PowerShell 5.1 或 PowerShell 7):
irm https://raw.githubusercontent.com/Nyakooo/termune/master/install.ps1 | iex
安装脚本会自动识别操作系统和 CPU 架构,下载最新正式版并校验 SHA256。无需安装 Rust、Python,也不需要管理员权限。再次运行相同命令即可更新。
安装完成后重新打开终端,运行:
termune
前往 GitHub Releases,根据系统和架构下载对应资源包。
| 系统 | 架构 | 发布包 |
|---|---|---|
| Windows | x86_64 | ZIP |
| Windows | ARM64 | ZIP |
| macOS | Intel | TAR.GZ |
| macOS | Apple Silicon | TAR.GZ |
| Linux | x86_64 | TAR.GZ |
| Linux | ARM64 | TAR.GZ |
解压后运行目录中的 termune.exe(Windows)或 ./termune(Linux / macOS)。
- 确保飞牛 NAS 正常在线。使用 FN ID 登录时,需要启用 FN Connect。
- 在 NAS 上安装并初始化飞牛音乐。
- 创建一个飞牛音乐的音乐独立账号,用于 Termune 登录。
运行 termune,按照提示输入:
- FN ID 或 NAS 地址:填写 FN ID 自动发现 NAS,或填写域名、IP 或完整 URL 直接连接。
- 音乐用户名:飞牛音乐的独立账号。
- 音乐密码:对应账号的密码。
FN ID 只用于设备发现,不代替音乐账号认证。密码输入时不会明文显示。
登录页可以勾选「下次自动登录」。登录成功后,Termune 会将会话凭据保存到系统凭据存储;不会把音乐密码写入普通配置文件。
使用 FN ID 时,Termune 会自动探测线路,优先尝试局域网。未开启 FN Connect,或使用反向代理、内网穿透时,可以填写实际可访问的地址,例如 https://music.example.com/nas。省略协议时默认使用 HTTPS。
仅在可信局域网中,可开启 设置 → 局域网 HTTP,再填写如 http://192.168.1.42:5666 的地址。公网 IP 和域名使用 HTTPS。连接成功后,顶栏显示实际连接方式。
Termune 支持键盘和鼠标交互。以下是曲库界面的快捷键速查;登录页、搜索框、弹窗和设置页还提供各自的上下文操作提示。
| 快捷键 | 操作 |
|---|---|
| ↑ / ↓、j / k | 上下选择条目 |
| Home / End | 跳到当前页首 / 尾 |
| Enter | 打开分类、详情或播放选中歌曲 |
| Tab / Shift+Tab | 切换曲库分类 |
| 1~6 | 直接切换六种曲库分类 |
| Alt+1~Alt+6 | 快速切换曲库分类 |
| Alt+← / →、Alt+h / Alt+l | 调整分类顺序 |
| ← / →、h / l | 上一页 / 下一页 |
| PageUp / PageDown | 上一页 / 下一页 |
| R | 刷新当前页面 |
| Esc | 返回上一级或取消当前操作 |
六种分类依次为:专辑、歌手、风格、全部歌曲、收藏和歌单。
| 快捷键 | 操作 |
|---|---|
| / | 打开搜索 |
| Enter | 确认搜索 |
| Esc | 取消搜索或返回搜索结果列表 |
| Ctrl+U | 清空当前输入内容 |
| F | 收藏 / 取消收藏选中歌曲 |
| A | 将选中歌曲加入歌单 |
| N | 在歌单分类中新建歌单 |
| C | 重命名选中歌单 |
| D / Delete | 删除歌单,或从当前歌单移除歌曲(需要确认) |
| 快捷键 | 操作 |
|---|---|
| Space | 暂停 / 继续播放 |
| S | 停止播放 |
| [ / ] | 上一首 / 下一首 |
| Ctrl+← / Ctrl+→ | 快退 / 快进 5 秒 |
| Ctrl+h / Ctrl+l | 快退 / 快进 5 秒 |
| - | 降低音量 |
| + / = | 提高音量 |
| O | 切换播放模式 |
| E | 切换到下一种音效 |
| Shift+E | 切换到上一种音效 |
播放模式包括顺序播放、列表循环、单曲循环和随机播放。点击播放栏中的模式或音效可打开菜单并直接选择。当前选项带有 ✓,空间不足时可用鼠标滚轮查看其余选项。进度条和音量刻度支持鼠标点击或拖动。
| 快捷键 | 操作 |
|---|---|
| M | 切换专业 / 极简模式 |
| P | 打开设置 |
| ↑ / ↓、j / k | 在设置中选择选项 |
| ← / →、h / l | 修改当前设置项 |
| Enter | 确认设置 |
| Esc | 返回 / 关闭设置 |
| Alt+↑ / Alt+↓ | 手动浏览歌词 |
| Alt+Home | 恢复歌词自动跟随 |
| ? / F1 | 打开快捷键帮助 |
| Q | 退出程序 |
| Ctrl+C | 退出程序 |
不同页面的按键行为可能随当前焦点和输入状态变化。例如正在输入搜索内容或密码时,文字按键不会触发曲库快捷操作。按 ? 可在程序内查看帮助。
已安装的 Termune 可以直接在终端执行:
termune update
程序会检查最新正式 Release,按当前系统和架构下载对应版本,并在替换前验证 SHA256。更新不会修改登录凭据、个人配置和缓存。
- 支持 Windows、macOS 和 Linux,提供 x86_64 与 ARM64 发布包。
- Linux 构建以 Ubuntu 22.04 为基线,使用 GNU libc;不提供 Alpine / musl 版本。
- macOS 使用原生构建,旧版本 macOS 的兼容性尚未全部验证。
- 建议终端尺寸至少为 36 × 20,推荐 100 × 30 或更大;建议使用支持 UTF-8、真彩色和鼠标事件的终端。
- Termune 需要 NAS 在线、飞牛音乐已初始化,并使用音乐独立账号登录。
遇到连接或播放问题时,可以先运行:
termune --version
termune --login-only
termune --diagnose
| 命令 | 用途 |
|---|---|
| termune --version | 查看当前版本 |
| termune --login-only | 检查设备发现、连接线路和账号登录 |
| termune --diagnose | 抽样检查连接、登录、曲库、搜索和媒体资源 |
| termune --help | 查看命令行帮助 |
提交问题时请附上 Termune 版本、操作系统、复现步骤和脱敏诊断结果。请勿提交音乐密码、会话令牌、Cookie 或完整网络抓包。
Termune 是独立开发的第三方开源客户端,仅用于连接用户自己的飞牛 NAS 音乐服务。Termune 与飞牛官方没有隶属、合作或背书关系。请遵守所在地法律法规及飞牛音乐服务的使用条款。
本项目采用 MIT License。


