nightingale

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

从您的音乐库中的任何歌曲进行卡拉OK，由神经网络驱动。

网站 ·
下载 ·
文档 ·
更新日志 ·
Discord

Nightingale 可以将你已有的音乐变成卡拉OK。它可以分离主唱、查找或生成逐字歌词，并播放带有同步高亮、音高评分、调性和节奏控制、多玩家和动态背景的曲目。在 Linux、macOS 或 Windows 上使用原生桌面应用，或者以自托管的网页应用运行相同的体验。

亮点

• 带上你的库 — 扫描本地音频、视频和 UltraStar 文件，或连接 Plex、Jellyfin 或 Navidrome。现有的提供商和文件夹播放列表将以只读导航方式显示。
• 在本地准备曲目 — 使用 UVR Karaoke 或 Demucs 分离人声，然后使用 LRCLIB、本地或粘贴的 LRC，或自动转录和对齐歌词。
• 尽情歌唱 — 按同步歌词演唱，评分麦克风音高，调整调或节奏，混合指导人声，监控麦克风，并补偿房间延迟。
• 举办卡拉 OK 夜 — 构建播放队列，在会话模式中继续管理，切换配置文件，对比排行榜，或为两到四个本地玩家分配独立麦克风。
• 布置舞台 — 使用源视频、GPU 着色器、Pixabay 循环，或自定义图像、视频和着色器背景；重新定位和缩放歌词以及音高图表。
• 使用你现有的屏幕 — 桌面模式和自托管模式共享相同的卡拉 OK 核心，支持键盘、游戏手柄、触控，以及从手机到 4K 显示器的布局。

详细行为、支持的媒体格式、控制选项、分析器选项及当前限制请参阅 用户指南。

获取 Nightingale

桌面版本支持 Linux x86_64/aarch64、macOS Apple Silicon/Intel 和 Windows x86_64。自托管版本二进制文件支持 Linux x86_64/aarch64。

首次启动会准备一个隔离的 ffmpeg、Python、分析器包和所需的机器学习模型副本。不需要系统 Python 设置，但首次下载需要几 GB。GPU 加速为可选；当 CUDA 或 Apple Silicon 加速不可用时，分析会回退到 CPU。

有关设置、平台特定说明、更新和添加音乐，请参见 入门指南。如遇故障，请查看 故障排除。

文档

• 图书馆资源
• 歌词与转录
• 控制
• 评分 和 多人模式
• 背景
• 自托管网页模式 和 Docker
• 从源代码构建

架构

桌面版和自托管交付共享一个 Rust 应用核心和一个 React 前端。传输适配器保持精简，因此 Tauri 和网页服务器之间的卡拉 OK 行为不会发生偏差。

flowchart LR
    UI["React UI"] --> Bridge["Typed bridge / client"]
    Bridge --> Tauri["Tauri IPC adapter"]
    Bridge --> Web["HTTP + WebSocket adapter"]
    Tauri --> API["app-api command contract"]
    Web --> API
    API --> Core["app-core"]
    Core --> Sources["Folder / Plex / Jellyfin / Navidrome"]
    Core --> Storage["SQLite library + cache"]
    Core --> Analyzer["Local Python analyzer"]

分析器作为一个持久的本地进程运行，通过令牌认证的回环 IPC 避免每首歌曲启动模型的开销。分析产物按 BLAKE3 源哈希缓存，因此未更改的曲目可以重用音轨、转录、歌词和移位播放变体。

仓库布局

开发

先决条件

平台构建包，包括 Windows ASIO 和 Linux WebKit 要求，列在 构建指南 中。

运行桌面应用程序

git clone https://github.com/rzru/nightingale.git
cd nightingale
pnpm --dir client install --frozen-lockfile
cargo desktop dev

为当前平台创建一个生产包，包含：

cargo desktop build

在提交应用更改之前，运行仓库检查：

pnpm --dir client format
pnpm --dir client quality

网站和指南工具与 site/ 分开运行；使用 pnpm --dir site build 来验证这些更改。

贡献

Nightingale 遵循以讨论为先的工作流程。在实现功能或行为更改之前，请先打开一个 GitHub 讨论 并等待批准。小的文档更正和明显的错误修复可以直接提交拉取请求。开始之前请阅读 CONTRIBUTING.md。

发布

匹配 v* 的标签会触发发布工作流。它会将标签与桌面清单进行验证，从CHANGELOG.md中提取发布说明，并创建包含桌面安装程序、更新程序工件和自托管服务器归档的草稿。对草稿工件进行冒烟测试，然后通过 GitHub 发布该版本。

git tag v<version>
git push origin v<version>

工作流程及其辅助脚本是工件和签名详情的规范来源。

支持项目

Nightingale 是免费、开源的，并在业余时间维护。通过 Patreon 或 Ko-fi 支持持续开发。

许可

GPL-3.0 或更高版本 — 请参阅 LICENSE。