EffeTune 浏览器扩展

浏览器扩展可同时处理最多四个标签页的音频，每个标签页都有独立的立体声 Effect Pipeline。它适合在不启动桌面应用、也不配置虚拟音频设备的情况下收听视频或音乐网站。

兼容性和安装

请在装有 Chrome 116 或更高版本，或兼容的基于 Chromium 的 Microsoft Edge 的 PC 上使用。Firefox、Safari、移动浏览器和隐私浏览不受支持。每个标签页都使用立体声效果链。

从扩展商店获得的扩展请在该商店安装。对于本地包，请将 effetune-extension-<version>.zip 解压到会保留的文件夹。在 Chrome 中打开 chrome://extensions，在 Edge 中打开 edge://extensions，开启 Developer mode，选择 Load unpacked，再选择该文件夹。Load unpacked 不能直接安装 ZIP 文件；替换文件后，请在此页面重新加载扩展。

开始、对比和停止处理

打开要处理其音频的标签页并开始播放。
从浏览器工具栏打开 EffeTune 扩展。
选择 Start on this tab。效果链准备好后，状态会从 Starting… 变为 Processing。

要添加另一个标签页，请在该标签页中打开扩展并选择 Start on this tab。弹窗会列出所有会话，最多可同时运行四个；开始第五个之前，请先停止一个。Bypass 可在保持会话的同时试听不加效果的音频。Stop 会让该标签页恢复正常播放，不影响其他标签页。

关闭扩展弹窗或编辑器后，处理仍会继续。再次打开时会显示当前标签页和实际状态。重启浏览器后请手动开始新会话；扩展不会自动捕获标签页。

编辑效果链和使用预设

选择 Edit pipeline 可打开 EffeTune Pipeline Editor。您可像在 EffeTune 中一样添加、排序、启用或禁用效果，调节参数，并使用可用的分析显示。弹窗中的 Saved preset 和 Apply to selected tab 可以不打开编辑器而更换完整效果链。在编辑器中打开 Pipeline Presets，可通过 Save as 保存完整效果链预设。要导入或导出完整预设，请打开 Settings，然后选择 Import preset… 或 Export preset。在编辑器顶部选择标签页，即可查看它的效果链和分析显示。没有活动会话时，Offline pipeline 可编辑下次启动使用的默认效果链。在弹窗中先选择标签页，再应用预设。

在编辑器顶部选择 Visualizer，即可在 Visualizer 中查看所选标签页处理后的声音；再次选择即可返回效果链。如果该标签页尚未开始处理，Visualizer 会显示“Start EffeTune on a tab to show Visualizer.”。扩展中不显示曲目名称和封面图。Share 和 Import Link 的用法与网页应用相同，分享的链接会在网页版中打开。Visualizer 的布局和预设保存在扩展中，不会与网页应用或桌面应用同步。

已保存的设置和预设保存在扩展中，不会自动与网页应用或桌面应用同步。若预设需要不支持的路由、效果或不可用的外部资源，它不会被应用，当前效果链会保持不变。

要在 Room EQ 或 Crosstalk Cancellation 中使用网页应用或桌面应用的测量结果，请先在相应应用中将测量结果导出为 JSON。在扩展编辑器中打开 Settings，选择 Import measurement…，再选择该 JSON 文件。用于 Crosstalk Cancellation 或 Room EQ 相位校正时，导出时应包含脉冲响应。导入的测量结果会立即出现在 Room EQ 的 Measurement 列表中，保存在扩展的浏览器存储中，并且不会自动同步。如需删除导入的副本，请先在该列表中选中它，再选择列表旁的 Delete。确认后，会先清除所有使用该副本的 Room EQ 和 Crosstalk Cancellation 分配，再删除副本。

如需选择已保存的数据并一次性转移，请在编辑器中打开 Settings > Backup / Restore。同一个 .effetune_backup 文件也可用于网页应用和桌面应用，能包含已保存的效果链预设、效果器预设、Visualizer 预设、脉冲响应和导入的测量结果。使用扩展不支持的路由或效果的效果链仍会保存，也可以再次备份，但无法在扩展中应用。文件不包含 URL 规则和扩展的 Sample rate 设置。

URL预设与采样率

在 Settings 中打开 URL rules…，添加匹配模式，选择保存的预设并启用规则。模式使用 host/path 格式，例如 example.com/music/*，其中 * 可匹配任意文本。第一个匹配的启用规则生效。主机名不区分大小写，协议、查询字符串和片段不参与匹配。可调整规则顺序以改变优先级，也可停用或删除不需要的规则。

每个标签页仍需手动开始处理。启动时及URL改变时会自动选择预设；没有匹配规则时使用默认效果链。规则修改从下次启动或页面跳转起生效。编辑由URL规则选中的效果链会更新对应的已保存预设；其他编辑会更新默认效果链。手动应用预设后的编辑也保存到默认效果链。删除预设会停用引用它的规则，并将正在使用这些规则的标签页切回默认效果链。

Settings 中的 Sample rate 适用于所有活动标签页，可选 Auto、44.1 kHz、48 kHz、96 kHz 或 192 kHz。Auto由浏览器选择采样率。更改时，所有标签页的音频处理会短暂重启，但捕获会保留。如果某个标签页无法以新采样率处理，它会恢复正常播放；请选择其他采样率并重新开始该标签页的处理。

权限、限制和帮助

扩展只捕获您明确开始处理的标签页音频，并读取这些标签页的URL，包括页面跳转后的URL，以选择保存的预设。它不会读取页面内容、插入脚本、使用麦克风、录音或向外发送音频。

立体声效果链支持使用 Bus Routing 连接 Main 和 Bus 1–4，包括并行效果路径。扩展不支持两个以上声道、执行新测量与设备控制、Music Library、批量文件转换，以及依赖设备或文件路径的桌面专用功能。

某些受保护内容可能无法捕获，扩展不会绕过内容保护。如果无法开始捕获，EffeTune 会停止处理，标签页会恢复正常播放。确认标签页正在播放音频后，再选择 Start on this tab。出现 Needs attention 时，也请这样操作。若无法应用预设，当前效果链会被保留；请更换预设或提供所需资源后重试。