预览版变更日志

2026-06-26

• 修改了用于告诉解码器和文件读取器取消耗时操作的接口（abort_callback）。

• 现在与 C++20 std::stop_token 语义兼容。

• 新的 SDK 将支持这些升级，同时保持与过去 foobar2000 版本的兼容性，但性能会略有下降。

• 已将 7-Zip 库更新至 26.01 版本。

• UnRAR 库已更新至 7.2.6 版本。

2026-06-23

• 修复了 Ogg/Opus 文件中单章节曲目编号显示不正确的问题。

• Windows：修复了 GPU 驱动程序重新初始化后 Direct2D 可视化卡住的问题。

• Mac：用现代方法替换了过时的 NSSavePanel 方法。

• 重构了线程同步辅助代码，应该不会产生可见的影响。

2026-06-18

• 更符合规范的 FLAC/Vorbis/Opus 封面图编写（颜色数量字段）。

• 转换器：更可靠地读取编码器错误日志。

• 转换器：解决了 FLAC 最近更改后拒绝编码奇数长度 24 位文件的问题。

• Windows：遵循 filesystem::open_shareable 标志打开本地文件（使用所有 FILE_SHARE_* 打开）。

2026-06-10

• 转换器：通过临时文件编码时，也能显示详细的错误信息。

• 转换器：恢复编码器进程优先级类映射。

• Mac：修复了辅助代码中一个隐蔽的文件路径损坏错误，目前没有已知症状。

2026-06-09

• 防止包含过多嵌套或链式运算符的特定搜索查询导致 foobar2000 因堆栈溢出而崩溃。

• 修复了 2.26 版本早期回归问题，该问题会导致播放列表搜索卡在“正在运行”状态，如果结果与上次查找的结果没有变化。

• 修复了影响特定稀有设备发现的长期 UPnP 搜索错误。

• 转换器：如果转换失败，则在错误弹出窗口中显示命令行编码器程序的输出。

• 改进了对带有空白值的 M4A 标签的处理。

• 改进了对 Matroska 段标题字段的处理。

2026-05-26

• 修复了 2026-05-15 版本中引入的与 Denon 接收器的 UPnP 不兼容问题。

• Windows：修复了从 2026-05-20 版本开始的转换器崩溃回归问题。

2026-05-21

• Windows：转换器回归修复 - 通过外部编码器编码时，最后几个样本缺失。

2026-05-20

• Windows：改进了机器具有虚拟网络适配器时的 UPnP 渲染器初始化。

• Windows：改进了转换器 WAV 写入的 CPU 使用率。

2026-05-19

• 解决了与 BubbleUPnP 的 UPnP 发现分歧。

2026-05-16

• ARDFTSRC 重采样器更新。

• UPnP资源泄漏问题已彻底修复。

• Windows：修复了从 2026-05-14 版本开始的“抑制 HTTPS 证书检查”回归问题。

• Windows：还修复了当服务器没有受信任的证书时 ftpes:// 连接失败的问题。

2026-05-15

• UPnP资源泄漏回归问题已修复。

• 其他UPnP漏洞已修复。

• Windows：新的 VC 运行时。

2026-05-14

• Windows 和 macOS 上的网络（HTTPS 等）加密代码已升级。如果您的操作系统支持，则现在支持 TLS v1.3。

• Mac：由于 Apple Network.framework 的技术限制，目前不支持 ftpes://。

• 修复了“删除章节”功能无法处理包含章节的 Ogg 文件的问题。

• Windows：修复了部分窗口丢弃多媒体键盘事件的问题。

• 添加了帮助/搜索查询语法。

• Mac：实现了真正的帮助菜单。

• 修复了在首选项中禁用 HTTP 搜索后，静态 HTTP 文件会被识别为广播流并无限循环播放的问题。

• 修复了另一个 UPnP 发现功能缺失的问题。

2026-05-08

• 修复了UPnP渲染器卡死回归问题。

• 提高了WebDAV的可靠性。

2026-05-07

• 提高了UPnP渲染器发现的可靠性。

• 在 UPnP 渲染器中启用 audio/x-wav 类型。

2026-05-04

• 检查组件更新时，会自动发送 Windows 版本号。

• 只会安装与当前系统兼容的组件更新。

2026-04-30

• UPnP 输出：已启用向 OpenHome 设备进行流媒体传输。

• UPnP 渲染器：实现了 SetNextAVTransportURI 方法，以便与兼容的客户端实现无缝播放。

• 修复了 6.1 FLAC 文件中缺少显式通道掩码字段时通道映射不正确的问题。

• 改进了在播放 5.1 声道环绕扬声器时后中置声道的重新映射。

2026-04-27

• UPnP 渲染器兼容性得到进一步改进（M-SEARCH 处理，SOAP 响应中的内容类型正确）。

• Windows：键盘快捷键已正确显示“上下文菜单”键的标签。

2026-04-20

• 修改了 UPnP 渲染器代码，实现了标准中要求的各种缺失方法；使其与各种流行的 UPnP 远程控制应用程序兼容。

• Windows：修复了在主线程之外调用各种 DSP 配置对话框时，某些未维护的旧组件会导致崩溃的问题。

2026-04-17

• 修复了某些情况下播放列表搜索错误地重新聚焦第一个项目的问题。

• UPnP渲染器：支持MP3（音频/mpeg）流。

• Windows：已将 zlib 更新至 1.3.2 版本。请注意，所有其他平台均使用系统自带的 zlib。

• Mac：修复了音频延迟计算错误，该错误会导致平滑搜索模式不稳定。

• Mac：包含播放统计信息 v3.1.10。

2026-03-27

• 新增实验性 float8 PCM 支持。

2026-03-23

• Windows：修复了在特定播放列表 + 专辑封面 + 自动调整列大小模式下出现的卡顿问题。

• 重构了 MP4/M4A 标签更新代码，应该不会影响输出。

2026-03-19

• 修复了特定专辑封面标签更新操作的卡顿问题。

• Mac：包含播放统计信息 v3.1.9。

2026-03-18

• 尝试修复新版电台浏览器服务器查找器崩溃的问题。

2026-03-17

• Windows：实现了查找无线电浏览器服务器的替代方法，该方法更节省资源。

• 改进了暂停期间音频设备短暂断开连接后的恢复能力。

• 修复了 WebDAV 文件名显示时缺少 URL 解码的问题。

• 重构了文件名清理代码（转换器、文件操作），实际行为不应改变。

• 读取文件标签时抛出的 C++ 异常更少。

2026-03-04

• 修复了多个 FPL 加载/保存与相对路径处理问题。

• 修复了一个导致 FPL 加载速度远低于预期的回归问题。

• 解决了 radio-browser.info 网站配置最近发生的更改导致 foobar2000 客户端崩溃的问题。

• 转换器：使文件名预览能够识别新添加的 %source_list_index%。

2026-03-03

• 为 MP4/M4A 文件添加更多兼容的类型标签。

• 忽略 MP4/M4A 文件中重复的类型标签值。

• Windows：改进了 ERROR_LOGON_FAILURE 错误消息的显示。

• Windows：修复了各种弹出窗口中“不再询问”复选框在深色模式下渲染不正确的问题。

• Windows：专辑列表解决了 Wine 错误 #59448，使 Wine 中多选可见。

• 转换器：添加了 %source_list_index% 和 %source_list_total%，仅用于多轨道图像命名模式，以允许在模式中使用列表索引。

• 转换器：恢复了对每个预设上次使用的输出文件夹的记忆功能

• 转换器：恢复了使用 .bat/.cmd 文件作为外部编码器的功能。

• 转换器：恢复了外部编码器参数的控制台日志记录。

2026年2月25日

• 改进了 M4A Apple 标签兼容性，能够恢复 UTF-8 内容中包含空字节的标签。

• 更智能的“删除重复项”代码，能够识别不同路径指向同一文件的各种情况，并且在 Windows 上不区分大小写。

• Windows：修复了使用多选模式时专辑列表的重绘故障。

• Windows：工具链从 VS2019 升级到 VS2022。

• Mac：偏好设置中的界面更改。

2026-02-18

• 修复了尝试对当前正在播放的大型播放列表进行排序时导致崩溃的回归问题。

• Windows：默认情况下恢复专辑封面和可视化效果的 GDI 渲染，Direct2D 为可选功能，以防止 GPU 驱动程序错误破坏默认的 foobar2000 设置。

• 修复了 SMB 代码中的一个错误，该错误导致非访客用户无法进行无密码登录。

2026-02-16

• 修复了 FPL 序列化代码中一个严重的回归问题，该问题会导致在使用相对路径在 foobar2000 实例之间复制或拖放播放列表内容时出现无意义的输出。

• Windows：已将 SQLite 更新至最新版本。

• 制作了适用于 MP4 格式 H.266 和 VP9 的视频编解码器报告。

• 改进了高级限制器的行为，确保在衰减后恢复输出完全相同的信号。

• 网络电台：解决了电台浏览器网站无法按文档说明运行的问题，所有标签都会重新获取。

• Windows：禁用 ws2_32.dll 的延迟加载，这在大多数配置中没有意义。

2026-02-11

• 已将 FFmpeg 更新到最新版本。

• Windows：重新构建了 FFmpeg，未使用 MSVC /fp:fast，修复了导致 Wine 崩溃的错误编译问题。

• Mac：修复了窗口焦点跟踪错误，该错误会导致在切换窗口后播放列表的“移除”/“裁剪”菜单命令块错误地变为灰色。

• Mac：修复了 Apple SMB 支持和文件夹监视中的一些漏洞。移动包含特定 Unicode 字符的文件夹不再会导致库项目重复。

• Windows：修复了在首选项中禁用 WMA 解码器时，WMA 专辑封面读取器不会被禁用的问题。

• Windows：修复了 Direct2D 可视化竞争条件错误导致的随机不稳定。

2026-02-06

• Windows：移除了 Direct2D 专辑封面切换 - 新的默认 Direct2D 代码应该在所有地方都能正常工作，包括 Wine。

• Mac：修复了在 ReplayGain 扫描期间“属性”对话框底部控件无法禁用的问题。

• Mac：修复了“属性”对话框 ReplayGain 扫描无法取消的问题。

• Mac：尝试解决在未激活 foobar2000 应用程序的情况下通过上下文菜单打开“属性”对话框时出现的窗口顺序错误问题。

• ReplayGain扫描器内部修复，新增组件访问ReplayGain扫描选项的接口。

2026-02-04

• Windows：修复了非 Direct2D 模式下专辑封面绘制回归的问题。

• 修复了默认 AccurateRip 日志保存位置无法可靠地设置为扫描专辑文件夹的问题。

2026-02-03

• Mac：修复了音频单元面板替换整个参数树时音频单元设置丢失的问题。

• Windows：修复了对未记录的 Gdiplus 行为的意外依赖，导致在 Wine 上运行时出现问题（主要是属性对话框崩溃）。

2026年1月29日

• ReplayGain扫描器：新增写入REPLAYGAIN_ALGORITHM标签的选项。

• ReplayGain 扫描器：默认模式现在更准确地命名为“ITU-R BS.1770”。

• Speedx重采样器代码已更新。

• Windows：修复了便携式相对路径处理错误，该错误会影响将便携式 foobar2000 本身作为索引音乐文件夹。

• Windows：转换器：修复了输出路径中包含高 Unicode 字符时出现的回归问题。

• Windows：恢复了专辑封面查看器的默认 Gdiplus 渲染，以解决 Wine 上的问题。

• 如果运行在较新的 Windows 系统上，建议在高级设置中启用所有“Direct2D”选项，以获得更好的性能。

• Windows：新增了对已知 Wine C++ 异常处理问题（会导致稳定性问题）的检查，如果检测到异常行为，每次启动时都会在控制台中显示通知。

• 受影响的系统将不会自动提交崩溃报告，因为这些报告现在几乎没有任何用处。

• 请查看控制台输出以获取更多详细信息。

2026-01-21

• 修复了 LargeFieldsConfig 处理中的节假日编码错误，该错误导致某些情况下属性对话框无法加载完整信息（部分信息未标记为部分信息）。

• Mac：禁用了导致显示故障的音频单元进程外加载。

• Mac：修复了音频单元面板调整大小的各种问题。

• Windows：改进了从 fooHelper.exe 崩溃/终止（系统文件对话框）中恢复的功能。

• Windows：针对最新 Windows 更新中的“错误 380”漏洞进行缓解，该漏洞会导致在云同步文件夹（例如 OneDrive 文件夹）中执行特定文件操作失败。

2026-01-18

• 修复了当 MP4/M4A 文件的标签包含格式错误的 Apple Gapless 信息时，这些文件无法完整播放的问题。

• 文件操作：修复了无法删除空文件夹时出现的异常行为。

• Mac：内置播放统计信息内部修复。

• 解决文件系统返回无意义的文件夹内容时媒体库崩溃的问题（使用 Wine 发现）。

2026-01-15

• 转换器重大更新：

• 新的预设格式，预设文件以 .ini 文件形式存储在 profile 子文件夹中。旧预设文件会在首次运行时导入。

• 鉴于上述原因，建议在升级前备份用户配置文件。

• 增加了可扩展的转换后操作，可用于 ReplayGain 扫描、完整性测试等。

• 转换出错时，编码器的 stderr 输出会转发到 foobar2000 控制台。

• 修复了一个错误，该错误会导致当源为 float64 时，将 int32 流发送到无法识别它的编码器。

• 现在默认关闭 Ogg 链式传输，改为默认写入 Ogg 章节。

• 修复了 replaygain_scanner API 实现中的逻辑错误，finalize() 之后使用 replaygain_scanner 对象无法按文档所述正常工作。

• ARDFTSRC 防止在被告知使用最高质量时使用“最大带宽”模式进行隐式重采样。

• Speedx 重采样器代码更新。

2026-01-07

• 始终将小时和分钟写入 Ogg 章节标记字段。

• 修复了“重新加载信息”属性绕过 LargeFieldsConfig 设置的问题。

• 用 Speex 重采样器替换了 libretro 重采样器，在速度相当的情况下提供了更好的质量 / 在质量相当的情况下提供了更好的速度。

• Windows：修复了某些页面无法访问 ARDFTSRC 重采样器设置对话框的问题。

2026-01-02

• Windows：解决了 Wine 在“属性”对话框的专辑封面视图中 IWICBitmapScaler::CopyPixels() 崩溃的问题。

2025-12-31

• Mac：已将正确的实时/离线标志传递给音频单元，修复了特定音频单元可视化无法正常工作的问题。

2025-12-29

• 修复了最近导致新配置文件崩溃的回归问题。

• 已彻底修复碎片化/流式 MP4 文件的标签写入问题。

2025-12-28

• LargeFieldsConfig 技术回归了 - https://www.foobar2000.org/LargeFieldsConfig-v2

• 在 Windows 系统上启用 WavPack 汇编优化，以略微提高解码速度。

• Windows：修复了便携式安装中复制粘贴文件相对位置相关的错误。

• 修复了 MP4 标签写入器损坏特定类型碎片化/流媒体 MP4 文件的问题。目前部分此类文件无法添加标签（会彻底失败）。此问题将很快得到彻底修复。

2025-12-17

• Mac：由于最新 macOS 系统上表格视图控件的行为不稳定，macOS 26 的新外观已被禁用。稍后将对此问题进行调查。

• 文件操作：修复了在重定向的便携式音乐文件夹和 macOS 卷上重命名文件时出现的错误。

• 修复了媒体库首选项页面中网络共享的各种回归问题。

• 在网络电台面板上下文菜单中新增了“播放”选项。

• Opus解码器已更新至v1.6。

2025-12-12

• 从 foobar2000 移动版移植的“播放”功能 - 目前可通过播放列表上下文菜单访问 - 网络电台和其他 http 链接可直接发送到任何 UPnP 渲染器设备。

• 默认用户界面：通过键盘快捷键循环切换标签页，取消正在进行的标签页重命名。

• 默认用户界面：使播放列表排序操作能够识别 %queue_index% 和其他播放列表特定字段。

• 此项更改尚处于实验阶段，目前不适用于附加组件。SDK 更新文档将很快发布，其中将详细介绍如何进行此操作。

• 修复了跳过曲目与播放统计交互回归问题，跳过的曲目不再标记为已播放。

2025-12-09

• ARDFTSRC 重采样器修复了查找时不正确的刷新行为。

• Retroarch 重采样器减少了样本偏移。

2025-12-03

• 对两个重采样器都进行了质量/错误修复更新。

• 转换器：在概览中明确显示了“无 DSP 重置”，因为如果意外启用该功能会很危险。

2025-12-02

• 修复了 RetroArch 重采样器昨天更改后可能导致处理流末尾出现故障的问题。

2025-12-01

• 恢复了开箱即用的 APL 链路支持。

• 改进了使用 retroarch 重采样器的子采样偏移行为。

2025-11-25

• 修复了未指定默认排序模式时，默认排序的自动播放列表出现死机回归的问题。

2025-11-24

• 针对 foo_tags（M-Tags）组件的错误，改进了临时解决方案。现在不会在开始播放时加载所有子歌曲。

• 已解决禁用多子歌曲支持导致的属性对话框信息重新加载故障。

• 使引用多子歌曲文件的 M3U 播放列表显示所有子歌曲，恢复了过去 foobar2000 版本的行为。

• 使输入空白传入项目排序模式保留应用程序与 foobar2000 交互时处理的原始曲目顺序，恢复旧版 foobar2000 的行为。

2025-11-21

• 新增高级偏好设置开关，可关闭所有子歌曲支持。

• 谨慎使用，可能产生不良副作用或效果不明显。

2025-11-18

• Windows：修复了由于任何原因无法解码图片时发生的崩溃问题。

• Windows：添加了 Gdiplus 回退机制，以便在 Windows Imaging 无法解码某些图像时，没有 Windows Imaging 编解码器的系统也能再次显示专辑封面。

• Mac：实现了专辑封面在加载时缩小尺寸，降低了专辑封面查看器等的内存使用量（在永远不会显示完整尺寸图像的上下文中不会加载完整尺寸图像）。

2025-11-15

• 修复了新专辑封面渲染程序中的各种问题。

2025-11-14

• 实验性 Windows 图像组件/Direct2D 专辑封面渲染在默认用户界面中。

2025-11-07

• Windows：已启用从专辑封面图片读取 EXIF 方向信息。

• 修复了一个回归问题，该问题导致短窗口 AAC 无法在可用时跳转到附加解码器。

• 修复了更多意外出现的异常重采样器行为。

2025-11-05

• 修复了意外出现的异常默认重采样器设置。

• Windows：添加了控制台输出，用于排查特定的便携模式错误。

2025-11-04

• 重采样器设置更新。

• 移除了数十年前用于无内容类型 MP3 广播的破解方法 - 应该可以像以前一样工作，并能被内容检查识别。

• 标题格式设置帮助再次更新。

2025-11-01

• 更新了标题格式帮助，包含一些近期新增内容和一些并非近期新增内容。

• 修复了一个不太常见的重采样器错误。

2025-10-31

• 重采样器修复。

• 使重采样器优先级设置接受重采样器的短名称，例如“retroarch;ardftsrc”。

• Windows：修复了当 DSP 管理器创建为模态弹出窗口时，某些 DSP 设置页面无法导航的问题。

2025-10-30

• 重采样器修复。

• 在打开文件进行播放和完整性验证时，抑制了特定的、速度较慢的 Matroska 完整性检查。

2025-10-29

• 将内置的 SSRC 重采样器替换为 ARDFTSRC。

• 清理了重采样器设置，删除了无意义的“排除速率”复选框，添加了有关格式的明确提示。

• 修复了 TrueHD 和 MLP 显示为有损格式的问题。

2025-10-24

• 仅限Mac用户晚间更新，修复了死机回归问题。

2025-10-24

• 修复了解码器性能管理中非常古老的竞态条件错误，这些错误可能会导致解码器被列出两次。

• 修复了将播放文件打开错误变为“严重错误”的回归问题，该问题会导致播放停止而不是播放下一个文件。

• 增加了对 Matroska 格式 TrueHD 和 MLP 流解码的支持。

• 移除了效率极低且不准确的 Matroska 音轨比特率探测功能。现在仅显示解码器报告的比特率（即所有 AC3 比特率）以及播放时的实时比特率。

• 修复了通过工具栏下拉菜单切换流时信息未重新加载的问题。

• 增加了对 M4A“长描述”标签的支持。

• 为配置和元数据库启用实验性的内存映射 SQLite 读取。

• 手动执行 metadb 垃圾回收，始终执行 sqlite vacuum。

• Mac：修复了在“重命名”模式下文件操作目标位置可编辑的问题。

2025-10-17

• Windows：尝试解决最新 Windows 11 更新中引入的多行编辑框重绘故障问题。请注意，这是 Windows 系统本身的 bug，与 foobar2000 无关。

• Windows：解决 foobar2000 不可见时播放结束导致可视化效果卡住的问题。

2025-10-16

• Mac：更改了从播放列表中移除项目的选择行为，现在会选择下一个项目，因此键盘导航不会将选择移动到播放列表的顶部。

• 修复了 LD 和 ELD AAC 无法可靠地发送到备用数据包解码器的问题。

• 修复了解码速度测试无法记住上次使用的DSP链的问题。

2025-10-12

• Windows：修复了 SMB 操作缺少 winsock 初始化的问题，该问题会导致如果没有先使用其他网络功能，则所有 SMB 访问都会失败。

• 修复了WebDAV文件系统和媒体库之间的交互问题。

2025-10-10

• 改进了对各种标签格式中格式错误的 UTF-8 文本的恢复。

• 完整性验证器报告了格式错误的 UTF-8 标签文本。

• MP4标签改进：

• 标签类型信息（Apple、Nero）

• 不再默认为单章节文件写入 Nero 标签，仅对多章节文件写入，因为其他标签格式无法存储每个音轨的标签。

• 增加了对一些不常用的 Apple 标签元素的支持。

• 不再更改不受编辑影响的 Apple 标签元素的二进制结构。

• Monkey's Audio 解码已迁移到 FFmpeg，不再包含 foobar2000 中的 Monkey's Audio 库。

• 您可以再次安装 Monkey 的音频解码器组件来替换内置的 FFmpeg 解码器。

• 新增信息字段：容器格式（MP4、Matroska、Ogg 等）

• 新增标题格式字段：%_cpu_arch%

• Mac：使播放列表视图能够从 Finder 复制/粘贴

• Mac：来自 Apple Icon Composer 的新图标

• Mac：使用 Xcode 26 构建，启用 macOS Tahoe 外观。

• Mac：通过从 Finder 拖放到组件列表来安装组件。

• Mac：播放列表管理器列可以切换显示。

• 添加了从网络电台页面拖放到播放列表的功能。

• 现在尝试播放受密码保护的资源（例如广播流）时会显示密码提示。

• 转换器：在转换过程中收到意外数据格式更改时，提供更好的错误消息；在检查格式匹配之前丢弃空白块。

• 现在均衡器可以通过从资源管理器/查找器拖放来接受预设。

• 针对 foo_tags 问题的变通方案 [已向后移植到 2.25.x 版本]

• 针对 WAV 文件头长度为零的问题，已修复 [正在向后移植到 2.25.x 版本]

• 固定文件操作链接与可移植相对路径[正在向后移植到 2.25.x 版本]