快速开始
本文帮助你从零开始，完成 Lyrico 的首次配置并看到你的音乐库。
下载与安装
从 GitHub Releases 下载最新版本 APK。Lyrico 按设备 ABI 分别提供安装包，不生成通用包：
arm64-v8a：适用于绝大多数较新的 Android 设备，通常优先选择此版本。armeabi-v7a：适用于仍使用 32 位 ARM 架构的旧设备。
APK 文件名格式为 Lyrico-<版本号>-<ABI>.apk，例如 Lyrico-1.4.0-a1b2c3d-arm64-v8a.apk。版本号末尾的短字符串是对应源码提交的 Git 短哈希，用于确认安装包的准确构建来源；Debug 构建还会包含 -debug。
首次启动与权限
首次启动时，Lyrico 会申请尚未授予的必要权限：
- 音乐和音频：用于扫描、读取和管理本地音频文件。拒绝后将无法正常建立音乐库或处理需要直接访问的音频。
- 通知（Android 13 及以上）：用于显示批量任务等后台处理进度。拒绝不会影响普通浏览，但可能无法看到相关任务通知。
在 Android 13 及以上版本中，通知和音频权限会作为同一次启动权限请求提交；Android 12 及以下只会请求对应的音频读取权限。已授权的权限不会重复请求。如果之前拒绝过，可以进入系统的 设置 → 应用 → Lyrico → 权限 重新开启。
添加音乐文件夹
Lyrico 不会自动扫描整台设备，你需要手动指定要管理的音乐文件夹。
操作流程：
- 打开 Lyrico，按系统提示完成首次权限授权，然后进入“歌曲”页。如果还没有添加任何文件夹，页面会显示“尚未添加文件夹”。
- 点击 “添加文件夹” 按钮。
- 在系统文件选择器中，找到并选中你的音乐文件夹，点击“使用此文件夹”进行授权。
- Lyrico 开始扫描文件夹中的音频文件。扫描进度会显示当前状态，例如“正在扫描文件夹…”、“正在读取标签 1 / 100”、“正在更新音乐库…”。
扫描完成后，歌曲就会出现在"歌曲"列表中。如果歌曲数量较多，首次扫描可能需要几分钟。
提示
你可以在 设置 → 扫描设置 → 文件夹管理 中添加更多文件夹。Lyrico 只扫描你手动添加的文件夹，不会扫描设备上的其他目录。
浏览你的音乐库
扫描完成后，底部导航栏包含三个视图：
- 歌曲：按列表显示所有已扫描的歌曲。点击任一歌曲进入编辑页。
- 艺术家：按艺术家分组显示。如果开启了艺术家拆分，多个艺术家会分别归类。
- 专辑：按专辑封面网格显示。
关于排序、本地搜索、艺术家/专辑详情页的更多操作，见 浏览音乐库。
编辑第一首歌
从歌曲列表中点击任意歌曲，进入 "编辑元数据" 页面。这是 Lyrico 的核心编辑界面。
快速尝试：
- 点击一首歌进入编辑页。
- 修改标题或艺术家字段。
- 点击顶部的 "保存" 按钮。
- 看到"保存成功"提示后，修改已写入音频文件。
更完整的编辑操作（歌词、封面、ReplayGain 等）见 单曲编辑。
安装搜索源插件
Lyrico 本身不提供在线搜索能力。歌词、封面和歌曲信息搜索需要安装 插件 来实现。
操作流程：
- 下载插件 ZIP 文件（如从 Lyrico-Plugins 获取）。
- 进入
设置→搜索设置→插件管理。 - 点击 "导入插件"，选择下载的 ZIP 文件。
- 在"发现插件包"弹窗中勾选要安装的插件，点击"安装"。
- 回到插件管理页，打开插件的 启用开关。
插件启用后，在单曲编辑页顶部搜索框输入关键词即可搜索在线歌曲信息。
更多插件使用细节见 使用插件。