音乐库使用方法

音乐库会为您选择的音乐文件夹建立索引，让您可以按曲目、专辑、艺人、流派、子文件夹、文件夹、最近添加的曲目和播放列表浏览本地音乐收藏。播放的声音和普通音乐文件播放一样，会经过当前 EffeTune 的 Effect Pipeline。

音乐库保存的是应用内的目录、封面缓存和播放列表。它不会编辑、重命名、移动或删除音乐文件本身。

可用环境

桌面应用： 使用完整功能的文件夹扫描器，所选文件夹在下次启动时仍可使用。桌面版还可以在文件所在文件夹中显示曲目。
支持 File System Access 的 PC Chromium 浏览器： 重新加载后仍可访问所选文件夹。浏览器可能再次请求授权。
移动浏览器、Safari、Firefox 及其他不支持 File System Access 的浏览器： 仅在当前页面会话中保留对所选文件的访问。目录会继续保存，但每次重新加载后都要重新选择文件夹或文件，让 EffeTune 重新连接。

音乐库会索引MP3、WAV、OGG、FLAC、Opus、M4A、AAC、WebM、MP4等常见媒体文件扩展名。它还可以通过外部CUE表，将同一文件夹中的WAV或FLAC专辑文件拆分成独立曲目。对于MP4文件，EffeTune只播放音轨，不显示视频。实际能否播放（包括是否支持MP4内的音频编解码器）仍取决于浏览器和操作系统的解码能力。

打开音乐库

PC 布局： 点击页眉中的 音乐库 按钮。
移动端布局： 打开屏幕底部导航中的 音乐库 标签。
桌面应用： 也可以通过 视图 > 音乐库 或 Ctrl+L（macOS 为 Command+L）打开。

要返回效果编辑，PC 布局中点击 Effect Pipeline 按钮，移动端布局中返回效果标签。桌面应用中也可以使用 视图 > Effect Pipeline 或 Ctrl+E（macOS 为 Command+E）。

如果想在启动时首先显示音乐库，请打开 设置 > 配置…，将 启动时显示: 设置为 音乐库。在 音乐库 旁边的下拉列表中，可选择首先显示的项目：曲目、专辑、艺人、流派、子文件夹、文件夹 或 播放列表。

添加音乐文件夹

打开音乐库。
选择 添加音乐文件夹。
选择包含音乐文件的文件夹。在移动端或无法持久访问文件夹的浏览器中，可能会出现选择文件夹内文件的界面。
等待扫描完成。状态行会显示曲目数和专辑数，建立索引期间也会显示进度。

如果尝试添加已注册文件夹内部的文件夹，EffeTune 会发出警告，并且不会重复建立索引。添加包含已注册文件夹的父文件夹时，可以将现有文件夹合并到新的文件夹中。

浏览和搜索

使用导航标签切换分类视图。

曲目 - 显示所有已索引的曲目。PC 布局中是可排序表格，移动端布局中是紧凑列表。
专辑 - 根据元数据按专辑汇总。
艺人 - 根据元数据中的艺人或专辑艺人汇总。
流派 - 根据元数据中的流派汇总。
子文件夹 - 按每个曲目文件直接所在的子文件夹相对于各个已索引音乐文件夹根目录的路径分组。
文件夹 - 显示已注册的音乐文件夹根目录、扫描状态和实际目录树。
最近添加 - 显示最近索引的曲目。
播放列表 - 显示在音乐库内创建或导入的播放列表。

对于像 Artist A; Artist B 这样以分号分隔的专辑艺人值，系统会分别归入每位艺人，同时保留完整署名用于显示。&、/ 和 feat. 不会被视为分隔符。

在 文件夹 中打开一个根目录，即可使用 树状视图 浏览。子文件夹显示在曲目列表上方；选择子文件夹可进入其中，使用面包屑路径或 上一页 可返回上一级。曲目列表只显示直接存放在当前层级的曲目。切换到 平铺视图 后，则会显示该已注册根目录中的所有已索引曲目，包括所有子文件夹中的曲目。切换视图时会保留当前的面包屑位置，因此返回 树状视图 后可从原位置继续浏览。搜索音乐库 始终搜索整个音乐库，所以搜索期间不会显示子文件夹列表。

当文件夹中没有直接存放的曲目且只有一个子文件夹时，树状视图 会将连续符合这一条件的层级合并为一行，例如 Artist / Album。选择该行即可直接进入最深层文件夹；这一行显示的曲目数量也以该文件夹为准。你可以通过面包屑路径打开任意中间层级，而桌面端的 上一页 每次只返回一级。在移动端，上一页 会返回之前查看的页面，因此一次即可跳过合并路径中的中间层级。

文件夹 树严格按实际相对路径区分目录，并包含扫描发现的每一条目录曲目记录，即使其元数据仍在分析中或分析失败。文件夹旁的数量包括该文件夹及其所有下级目录中的曲目记录。CUE 曲目按逻辑曲目分别计数；多个逻辑曲目即使共用一个 WAV 或 FLAC 源文件，也会计为多首曲目，而不是一个物理音频文件。子文件夹 的含义不同：它按规范化后的直接父目录标识，对已成功分析的曲目进行分组，因此仅大小写或 Unicode 规范化形式不同的路径可能会合并到同一组。

例如，Artist/Album/01 Song.flac 会显示在 Artist/Album 子文件夹组中，也会在实际的 文件夹 树中依次位于 Artist 和 Album 下。不同索引根目录下相同的相对路径仍会分别显示。直接存放在根目录中的文件不会创建子文件夹组，但仍可在曲目以及 文件夹 中该根目录的直接曲目列表中使用。

使用 搜索音乐库 可以跨曲目、专辑、艺人和播放列表搜索。PC 布局中，可以从曲目列表表头按标题、艺人、专辑、流派和时长排序。专辑、艺人、流派、子文件夹和播放列表视图提供由目录数据库支持的排序列表。根据当前视图，可以按名称、艺人、年代、路径、曲目数、总时长、更新时间或创建时间进行升序或降序排列。每个视图会分别保留自己的选择。

搜索曲目时，三个或更多字符的关键词可匹配标题、艺人、专辑、流派、文件名或路径中的任意位置。一个或两个字符的关键词只匹配词语开头。如需匹配词语中间，请至少输入三个字符。

在 PC 和移动布局中，当曲目搜索结果、树状视图 当前层级的直接曲目，或专辑、艺人、流派、子文件夹、播放列表详情中的曲目不超过 300 首时，所有曲目都会默认选中；达到 301 首时则不会自动选择。可使用行复选框、全选或 取消全选 更改选择状态。

移动端首先显示普通的曲目标题列表，不显示艺人列和时长列。只有长按曲目才会进入选择模式并显示复选框、全选和 取消全选，同时保留常用的行操作。自动选择、全选、取消全选 和单个复选框操作只会改变选择状态，不会进入或退出选择模式。

如果没有元数据或无法读取元数据，EffeTune会使用文件名和文件夹信息显示。曲目属性中可以查看文件路径、格式、采样率、位深度、比特率和主要元数据项目。对于CUE曲目，还会显示曲目类型、CUE文件路径、源音频路径，以及它在源文件中的播放区间。

CUE专辑文件

请将外部.cue文件与其中指定的WAV或FLAC文件放在同一文件夹，然后添加或重新扫描该文件夹。每个有效的TRACK ... AUDIO条目都会在音乐库中显示为一首独立曲目。CUE中有标题、表演者、日期、流派和曲目编号时会优先使用这些信息；音频技术信息则来自源WAV或FLAC文件。

对于已添加到音乐库的曲目，EffeTune会优先使用源音频文件中的内嵌封面。如果没有内嵌封面，则按顺序在CUE文件所在的文件夹中查找cover.jpg、cover.png、front.jpg、front.png，然后查找与源音频文件同名的JPEG或PNG（文件名可以包含或不包含音频扩展名）。在桌面应用中直接播放时，会自动使用相同的相邻图片候选；此播放路径不会从源音频文件中提取内嵌封面。在浏览器中直接播放时，则使用可从所选文件或已注册文件夹访问的相应图片。

你也可以通过 Open music files 直接播放CUE专辑；在移动设备上，请使用 Open Music。桌面应用还可以使用 File > Open music file…，只需选择.cue文件。在电脑端Chromium浏览器中，请先把专辑文件夹添加到音乐库并允许访问。之后只需选择.cue文件，EffeTune就会从已登记的文件夹中打开其引用的WAV或FLAC文件和匹配的封面，而不会把此次选择加入目录。不支持File System Access的浏览器仍需同时提供一个.cue文件、其中引用的全部且仅限这些WAV或FLAC文件，以及需要使用的匹配封面。有效选择会替换当前播放队列。验证失败时，当前队列不会改变。

如果CUE表无效，或无法安全确定它引用的源文件，EffeTune会说明问题，并把WAV或FLAC作为整文件的普通曲目导入。请修正CUE表或文件名，然后重新扫描文件夹。

从音乐库播放

选择曲目、专辑、艺人、流派、子文件夹、文件夹、搜索结果或播放列表，然后使用以下操作。

播放 - 替换当前播放器队列并开始播放。
随机播放 - 以随机顺序播放所选曲目组。
下一首播放 - 将所选曲目插入到当前曲目之后。
添加到队列 - 将所选曲目添加到队列末尾。
添加到播放列表 - 将所选曲目保存到音乐库的播放列表中。

在 PC 上，可以双击曲目行从该位置开始播放，也可以右键点击或通过更多菜单打开曲目操作。在移动端，点按普通列表中的曲目即可播放；长按会进入上述选择模式。

普通音乐播放器的控制和循环/随机播放设置仍然可用。可使用键盘的设备上，也可以使用普通播放器键盘快捷键。如果文件夹离线，无法打开音乐库中的曲目，请重新连接或重新导入该文件夹。

更新和重新连接文件夹

在音乐文件夹中添加、删除、重命名文件或编辑标签后，请使用 重新扫描。重新扫描会更新已更改的曲目，将找不到的文件从目录中移除，并尝试重新解析之前不可用的播放列表项目。

可以在 文件夹 画面的状态显示中确认该文件夹是否可用。

正常 - 文件夹可用。
未扫描 - 尚未建立索引。
未找到 - 文件夹或保存的路径不可用。
重新连接 - EffeTune 需要您重新授予访问权限。

如果文件夹显示为 重新连接，请选择 重新连接，并重新允许访问同一个文件夹。移除文件夹只会将它从音乐库目录中移除，不会删除磁盘上的文件。

播放列表

音乐库的播放列表保存在 EffeTune 内，可以包含已索引文件夹中的曲目。

可以执行以下操作。

从所选的音乐库曲目创建播放列表。
使用 将队列保存为播放列表 保存当前播放器队列。
对播放列表进行重命名、复制、删除和重新排序。
拖动播放列表中的曲目来调整顺序。在不便拖动的环境中，使用上移、下移。
使用 导入播放列表 导入 M3U、M3U8、PLS、XSPF 格式的播放列表。
打开某个具体的播放列表，然后使用 导出 M3U8 或 导出 XSPF 将其导出。

安全性和保存位置

音乐库会读取音乐文件和元数据，但不会向音乐文件写入更改。
封面缓存和播放列表是应用内数据，不是写入音乐文件的嵌入式更改。
浏览器的存储区域可能会因浏览器设置或用户操作而被清除。重要播放列表请按需导出。
在支持 File System Access 的浏览器中，重新加载后能否继续使用文件夹取决于访问权限。在其他浏览器中，每次重新加载后都要重新选择文件。

大型音乐库

EffeTune 会分阶段加载大型音乐收藏，不会将整个音乐库一次性保存在内存中。扫描时间和实际容量取决于存储速度、可用内存、元数据、封面以及浏览器或操作系统的限制。

滚动时会加载当前位置附近的曲目。如果跳转速度特别快，在请求的曲目加载完成前可能会短暂出现空白行，尤其是在速度较慢的存储设备上。

请一次只在一个 EffeTune 窗口中使用音乐库。

OpenHome 远程控制（桌面应用）

在受支持的桌面版本中，EffeTune 可以作为 OpenHome 播放器显示在同一局域网的控制器应用中。打开 设置 > 配置…，启用 允许此网络中的 OpenHome 控制器，然后等待状态显示 EffeTune 已公开。默认播放器名称为 EffeTune (电脑名称)；可通过播放器名称为每台电脑设置易于识别的名称，例如 EffeTune Living Room。此设置默认关闭。

OpenHome 无需登录。启用后，本地网络中的其他设备可以查看播放元数据、替换或编辑 Player 队列并控制播放。如果 Windows 防火墙请求权限，请仅允许 EffeTune 访问专用网络，不要允许访问公用网络。不需要远程控制时请关闭此设置。

支持的安装包包括 Windows x64、Intel 或 Apple silicon Mac，以及 Linux x64。网页应用和移动浏览器不支持此功能。我们已使用 Android 版 BubbleUPnP 验证基本的队列和播放操作；其他 OpenHome 控制器显示服务和不受支持控件的方式可能有所不同。EffeTune 是 OpenHome Playlist 源，不是 UPnP AV MediaRenderer，也不声明兼容性或认证状态。

控制器可以添加 HTTP 或 HTTPS 音频，并在一个远程队列中执行播放、暂停、停止、切换曲目、跳转、重复和随机播放。远程音频仍会通过当前的 EffeTune Effect Pipeline。OpenHome 控制不支持编辑 EffeTune 效果、访问本地文件路径、主音量、Radio、Songcast 或同步多房间播放。不保证无缝播放，某些技术信息在音源提供前可能保持未知。睡眠、唤醒、VPN 或网络接口发生变化时，播放器在重新连接期间可能会短暂消失。

← 返回 README