本地音乐

Folia 的本地音乐功能类似媒体库，会把导入的文件夹里的音乐、歌词、封面和标签整理成歌单的形式。

导入方式

推荐直接导入整个文件夹。

导入后，Folia 会：

扫描常见音频格式，如 mp3、flac、m4a、wav、ogg、opus、aac
读取音频标签中的标题、歌手、专辑、封面
读取内嵌歌词
读取同目录歌词文件与翻译歌词文件
生成本地索引，方便后续重扫与恢复

扫描速度取决于文件数量和标签复杂度，通常会在几秒到几十秒内完成。

文件发生变动之后，需要用户手动触发重扫，Folia 会根据之前的索引尽量复用未变动的歌曲信息。重新扫描的速度非常快，一般在几秒内完成。

支持的配套文件

歌词文件

会识别同目录的：

track.lrc
track.vtt
track.t.lrc
track.t.vtt
track.mp3.lrc 这类带音频扩展名的侧车歌词

其中 .t.lrc / .t.vtt 会被视为翻译歌词。

歌词格式支持

对“本地音乐目录导入”这一条路径来说，Folia 目前会扫描的歌词文件扩展名是：

.lrc
.vtt
.t.lrc
.t.vtt

也就是说，本地目录里最稳妥的做法仍然是放 .lrc 或 .vtt。其中：

.t.lrc / .t.vtt 会被当作翻译歌词
track.lrc 和 track.mp3.lrc 这两种命名都支持
如果没有单独的翻译文件，Folia 还会尝试把一份“双语交错时间轴”自动拆成原文和翻译

目前本地歌词实际支持的内容格式如下。

1. 标准 LRC

最常见的逐行时间轴格式，每行一个时间标签。

lrc

[00:04.00]Hello world
[00:10.00]再见

如果你还有翻译歌词，可以单独放一个同名 .t.lrc：

lrc

[00:04.20]你好 世界
[00:10.10]Goodbye

Folia 会按时间把原文和翻译对齐显示。

2. 双语交错 LRC

如果你只有一份歌词文件，也可以把原文和翻译按相同时间戳交错写在一起：

lrc

[00:12.428]ハロ窓を開けて小さく呟いた
[00:12.428]你好 打开窗户轻声说道
[00:17.798]ハワユ誰もいない部屋で一人
[00:17.798]你好吗 独自在空无一人的房间里

歌词流水线会先尝试把这种“同时间戳双行”拆成主歌词和翻译歌词，再交给统一解析器处理。

3. 增强 LRC：尖括号逐字时间轴

歌词工具

推荐使用 LDDC 这类支持增强 LRC 的工具来制作逐字歌词

这是增强型逐字歌词的一种常见写法：

lrc

[00:00.000]<00:00.000>你<00:00.300>好<00:00.600>!<00:00.900>

这种格式适合需要逐字高亮的歌词。Folia 会保留每个字或词的开始、结束时间。

它也支持元数据头，例如：

lrc

[ti:Song]
[ar:Artist]
[00:00.000]<00:00.000>你<00:00.300>好<00:00.600>!<00:00.900>

4. 增强 LRC：方括号逐字时间轴

除了尖括号风格，Folia 也支持另一种很常见的“行内重复时间标签”写法：

lrc

[00:12.428]ハ[00:12.667]ロ[00:13.343]窓[00:13.548]を[00:13.747]開[00:14.073]け[00:14.449]て

这类格式在测试里同样走 enhanced-lrc 分支，会被识别为逐字时间轴，而不是普通逐行 LRC。

LDDC 生成歌词，通常就属于这一类增强 LRC，Folia 对这种格式有专门适配。

5. WebVTT

.vtt 歌词文件常见于 DLsite 等平台的下载字幕，或者一些视频字幕文件。

如果你已经有 .vtt 歌词文件，也可以直接使用：

vtt

WEBVTT

00:00.000 --> 00:01.500
Hello & hi

支持 WEBVTT 头
支持标准 00:00.000 --> 00:01.500 时间范围
会去掉 cue 里的简单标签
会把  、& 这类实体还原成正常文本

6. 当前不建议放进本地目录的格式

Folia 的统一歌词解析器本身还支持：

yrc
qrc

测试样例如下：

text

[1000,800](1000,250,0)你(1250,250,0)好

text

[1000,800](1000,250)你(1250,250)好

它们主要用于网易云逐字歌词、Now Playing、Stage API 等别的歌词来源。

但对“本地文件夹导入”来说，扫描器目前只会主动找 .lrc 和 .vtt 侧车文件，不会自动扫描 .yrc 或 .qrc 作为本地歌词文件。所以如果你是在整理本地资料库，还是建议优先转换或保存成：

.lrc
.vtt

封面文件

会优先识别常见文件名：

cover.png
cover.jpg
cover.jpeg

如果没有单独封面，Folia 会尝试使用音频内嵌封面。

歌词与元数据来源

对于本地歌曲，Folia 可以同时保留多种信息来源：

本地歌词
内嵌歌词
在线匹配歌词
本地元数据
在线匹配封面与专辑信息

你可以为单首歌决定：

歌词优先使用本地、内嵌还是在线版本
封面是否优先使用在线版本
元数据是否优先使用在线版本

在线匹配

如果本地文件的标签不完整，或者没有歌词，可以手动触发在线匹配。

匹配逻辑会根据：

文件标签
文件名
艺术家与标题

去搜索在线结果，并尽量找到标题最接近的歌曲。

如果自动匹配不够准确，可以手动选择更合适的结果。

重扫与删除

对已导入文件夹，可以进行：

重扫 / 重新导入：刷新新增、删除或变更过的文件
从资料库移除整个文件夹

Folia 会尽量复用未变化的歌曲信息，减少重复处理。

ReplayGain

本地歌曲支持 ReplayGain 相关信息，并可切换：

off
track
album

如果音频文件本身带有这些标签，Folia 会显示并参与播放增益选择。

使用建议

尽量保持文件名和标签一致，匹配成功率会更高
把歌词文件放在音频同目录下，命名与音频文件保持一致，或嵌入到音频标签里
如果你收藏的是整张专辑，建议在文件夹中放一张 cover.jpg

本地音乐 ​

导入方式 ​

支持的配套文件 ​

歌词文件 ​

歌词格式支持 ​

1. 标准 LRC ​

2. 双语交错 LRC ​

3. 增强 LRC：尖括号逐字时间轴 ​

4. 增强 LRC：方括号逐字时间轴 ​

5. WebVTT ​

6. 当前不建议放进本地目录的格式 ​

推荐做法 ​

封面文件 ​

歌词与元数据来源 ​

在线匹配 ​

重扫与删除 ​

ReplayGain ​

使用建议 ​