xmmusic

项目概述

XM Music 是一款基于 Electron + Vue 3 + TypeScript 的本地音乐播放器，界面仿 QQ 音乐风格，支持 macOS、Windows 与 Linux。它对本地曲库做智能扫描与元数据编辑，提供歌单、收藏与播放模式管理。歌词与封面可在线匹配，歌词支持 LRC、全屏与桌面歌词，搜索支持汉字、全拼与声母

高颜值、面向大曲库的跨平台本地播放器

主要功能

• 本地音乐管理：智能扫描、设置扫描目录、元数据编辑与封面提取
• 失效清理：清理磁盘上已不存在或标记为不可播放的记录
• 歌单管理：创建、编辑、设置封面与复制歌曲到目录
• 收藏与最近播放：快速收藏并置顶最近播放记录
• 高品质播放：原生 Audio 为主、Howler.js 兜底，提供多种播放模式
• 均衡器：内置预设音效并可自定义，全屏、迷你与普通模式共用滤波链
• 智能搜索：支持汉字、全拼与声母搜索
• 歌词显示：LRC、全屏歌词与桌面歌词，支持偏移校准与批量在线匹配
• 封面匹配：按标签或文件名搜索封面，支持批量匹配与导出封面
• 标签编辑：智能解析文件名修复乱码，支持编码自动识别与手动兜底
• 性能优化：虚拟滚动与分批加载，应对万级曲库与队列

适用人群

• 拥有大量本地音乐的收藏者
• 需要歌词与封面批量补全的用户
• 在意界面美观与搜索效率的听众
• 跨 macOS、Windows 与 Linux 使用的用户

快速上手

1. 从 Releases 下载对应平台的安装包
2. 首次启动时在设置中添加本地音乐文件夹
3. 扫描音乐库并等待元数据与封面提取完成
4. 双击歌曲播放，或使用批量匹配补全歌词与封面
5. 顶栏搜索框支持全拼与声母，快速定位歌曲

核心优势

• 大库友好：虚拟滚动与分批加载让万级曲库依然流畅
• 匹配全面：歌词与封面均支持多源并发在线匹配
• 整理能力强：标签编辑、乱码修复与失效清理一应俱全
• 跨平台一致：macOS、Windows 与 Linux 提供一致体验

系统要求

项目	要求
操作系统	macOS（Apple Silicon）、Windows、Linux
运行环境	安装包自带运行时；源码构建需 Node.js 24+
原生依赖	better-sqlite3 需对应平台构建工具
网络	在线匹配歌词与封面时需要

注意事项

• macOS 安装包仅支持 Apple Silicon（arm64）
• 未做 Apple 公证，首次打开可能需右键打开或解除隔离属性
• 批量匹配歌词与封面互斥，不可同时进行