Lyrico：Android 音乐标签编辑器

项目简介

Lyrico 是一款面向 Android 的开源本地音乐标签编辑与歌词管理工具，用于整理本地音乐库、读写音频元数据，并通过插件化搜索源补全歌词、封面和其他歌曲信息。项目灵感来源于 LDDC 和「音乐标签」，使用 Kotlin 编写，遵循 Apache-2.0 许可证。

主要功能

• 本地音乐库管理：扫描本地音乐文件，按歌曲、艺术家、专辑、文件夹等维度浏览与搜索。
• 音频元数据编辑：读取和修改标题、艺术家、专辑、专辑艺术家、年份、流派、音轨号、歌词、封面、注释和自定义标签等信息。
• 多格式标签读写：基于 TagLib 处理 MP3、FLAC、OGG/Opus、M4A/AAC、WAV、APE 等常见音频格式。
• 歌词与封面补全：通过插件搜索歌词、翻译、音译、封面和候选元数据，并写入本地音频文件。
• 歌词格式处理：支持普通 LRC、增强型逐字歌词、TTML 等歌词内容的展示、匹配、转换与写入。
• 批量整理流程：支持多选、批量匹配、批量编辑、批量重命名、批量响度分析、批量分享和批量删除。
• 插件化搜索源：在线搜索能力由插件提供，应用本体负责运行时、配置界面、结果处理和标签写入。
• 双界面风格：内置 Miuix 与 SaltUI 两套界面，切换后立即生效。

安装与使用

应用本体可从 GitHub Releases 获取，当前版本为 v1.7.0。

在线搜索依赖搜索源插件，插件以 JavaScript 编写，运行在 Android 端嵌入式 quickjs-ng 运行时中，可声明并实现搜索歌曲信息、获取歌词、搜索封面和插件配置项等能力。插件相关文档：

• 插件使用
• 插件开发概览
• Manifest 参考
• 宿主 API

部分播放器已适配 Lyrico 的外部编辑功能，接入方式见 外部编辑接入指南；已适配的播放器包括光锥音乐、Halcyon、棱镜音乐、mica-music、Raws-Music、Salt Player、MD3Music 等。

构建

推荐使用 Android Studio 打开项目，也可直接通过 Gradle 构建。基础环境需要 JDK 21、Android SDK、Android NDK 29、CMake 4.1.2、Git 与 GNU Make 4.x。首次构建前初始化源码子模块：

git submodule update --init --recursive

常用构建命令：

.\gradlew.bat :lyrico-app:assembleDebug

主要模块分为 lyrico-app（Android 应用主模块，含 UI、音乐库、搜索、插件运行时和业务逻辑）、lyrico-audiotag（音频标签读写模块）与 docs（VitePress 文档站点）。

注意事项

项目开发主要围绕维护者自身的实际使用需求展开，不追求覆盖所有可能的个性化场景；高度定制化、使用场景过窄或会显著增加复杂度的功能可能不会纳入主线，更适合通过插件、配置或 fork 项目实现。

Lyrico 本体代码基于 Apache License 2.0 开源，所使用第三方组件仍遵循各自许可证，可在应用内「开源许可」页面查看依赖许可信息，随源码引入或嵌入构建的组件见 THIRD_PARTY_NOTICES.md。

---

本作品整理自 GitHub 开源项目 Replica0110/Lyrico，原作者 @Replica0110，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。