LiveChord 

对于许多乐器学习者而言，寻找准确的和弦谱、适应原曲速度以及反复练习特定段落往往充满挑战。LiveChord 是一款开源的 Web 应用，能够将任意音频文件（MP3/WAV/FLAC 等）瞬间转换为实时同步的和弦图谱。

它不仅提供精准的和弦识别，更内置了专为练习设计的功能：多乐器视图切换（钢琴/吉他/尤克里里/手风琴等）、一键移调、AB 段落循环及0.5 倍慢速播放。无论是初学者还是进阶玩家，LiveChord 都能让你的跟练过程更加高效、直观且充满乐趣。

核心亮点：AI 驱动、实时同步、练习友好

1. 多乐器视图，适配不同演奏习惯

• 五种视图模式：根据你学习的乐器，切换至对应的和弦显示方式（如吉他的指法图、钢琴的键盘映射、尤克里里的品格图等）。
• 实时同步滚动：和弦卡片随音频播放进度自动高亮滚动，确保你始终知道当前该按哪个和弦。

2. 高精度 AI 音频分析引擎

LiveChord 后端运行一套复杂的 AI 流水线，确保分析的准确性：

• 和弦识别 Transformer：深度学习模型精准捕捉和弦进行。
• 节拍跟踪 (Beat Tracking)：优先使用 GPU 加速的 beat_this 模型（备选 librosa），精确确定小节线、强拍位置及 BPM。
• 段落检测：自动识别主歌 (Verse)、副歌 (Chorus)、桥段 (Bridge) 等结构，方便快速跳转。
• 后处理优化：通过小节仲裁与节拍精炼算法，清理相位偏差，确保和弦与节奏完美对齐。

3. 专为练习打造的交互功能

• 智能移调：一键将歌曲移至适合你嗓音或指法的调式，无需重新扒谱。
• AB 循环播放：选中任意小节或段落，设置 A-B 点，无限循环练习难点。
• 慢速播放：支持降至 0.5 倍速播放，且不改变音高，让你看清每一个指法细节。
• 旋律瀑布图：可视化展示主旋律走向，辅助听力训练。

4. 隐私保护与版权合规

• 本地/用户上传：仅分析用户上传且拥有使用权的音频文件，不托管、不分发任何受版权保护的音乐内容。
• 无 YouTube 依赖：为避免版权风险，项目已移除 YouTube 链接导入功能，专注于本地文件分析。
• 示例曲目：首页提供 15 首公共领域/CC 许可的预分析曲目，新用户无需上传即可立即体验完整功能。

快速开始：在线使用

1. 访问官网：打开 livechord.org。
2. 体验示例：点击首页任意预置曲目，立即查看和弦同步效果。
3. 上传音频：将你的 MP3/WAV/FLAC/M4A/OGG 文件拖入上传区。
4. 开始练习：
   • 选择乐器视图（吉他/钢琴等）。
   • 如需移调，点击调式按钮。
   • 遇到难点，设置 A-B 循环并开启慢速播放。

本地开发与部署

LiveChord 完全开源，支持本地部署以保护隐私或进行二次开发。

环境要求

• Python 3.10+
• Node.js (前端构建，如需修改 UI)
• (可选) NVIDIA GPU 用于加速 beat_this 模型

安装步骤

1. 克隆仓库

   git clone https://github.com/JJ110112/LiveChord.git
   cd LiveChord
   

2. 安装 Python 依赖

   python -m venv .venv
   
   # Windows
   .venv\Scripts\activate
   
   # macOS / Linux
   source .venv/bin/activate
   
   pip install -r backend/requirements.txt
   

3. 配置环境变量 (可选)

   cp .env.example .env
   # 编辑 .env 文件，可设置 LIVECHORD_MODE=public 模拟公共实例行为
   

4. 启动后端服务

   cd backend
   python -m uvicorn main:app --host 127.0.0.1 --port 8800 --reload
   

5. 访问应用
   打开浏览器访问 http://127.0.0.1:8800。

运行模式说明

• Personal Mode (LIVECHORD_MODE=personal)：默认模式，单用户无验证，无上传配额限制，适合个人本地使用。
• Public Mode (LIVECHORD_MODE=public)：模拟 livechord.org 行为，包含身份验证与配额管理逻辑（需额外配置数据库等）。

对于每一位渴望更轻松、更高效学习乐器的朋友而言，LiveChord 都是值得尝试的得力助手。现在，上传你的第一首歌曲，开启智能跟练之旅吧！