Audio Converter for Anki

专为 Anki 打造的高性能音频格式转换插件。
支持在卡片浏览器中手动批量转换与后台自动静默转换，彻底解决苹果 iOS / iPadOS 等移动设备无法原生播放特定音频格式（如 .ogg）的系统限制，同时提供音频体积压缩与高品质格式互转能力。

主要功能

1. 双重转换工作流

• 手动批量转换：在卡片浏览器中多选或全选卡片，一键发起批量音频转码与卡片字段引用替换。
• 后台自动转换：设定监控规则后，无论是批量导入、第三方制卡还是手动添加卡片，新卡片写入数据库前后台自动静默转码为目标格式，全程无需人工干预。

2. 7 大主流音频格式互转

支持以下 7 种主流格式之间的任意双向转换：

• MP3 (.mp3)
• M4A (.m4a)
• AAC (.aac)
• OGG (.ogg)
• OPUS (.opus)
• WAV (.wav)
• FLAC (.flac)

环境准备

本插件依赖业界标准的多媒体处理工具 FFmpeg：

• Windows： 若系统中已安装 FFmpeg 并配置了环境变量（PATH），插件会自动侦测并调用；亦兼容默认安装路径（如 C:\Program Files\ffmpeg\bin\）。
  (若尚未安装，可前往 gyan.dev 下载 release essentials 构建包，解压并将 bin 目录路径添加至系统环境变量 PATH)

• macOS： 建议使用 Homebrew 安装：

  brew install ffmpeg
  

• Linux：

  sudo apt install ffmpeg   # Ubuntu / Debian
  sudo pacman -S ffmpeg      # Arch Linux
  

使用指南

1. 手动批量转换（针对现有卡片）

1. 打开 Anki，进入 【浏览】 窗口；
2. 选中需要处理的卡片（支持点选、框选或 Ctrl+A 全选）；
3. 右键点击选中的卡片，或点击顶部菜单栏 【笔记】 -> 【音频转换】；
4. 在弹出的配置窗口中：

• 勾选包含音频的目标字段（如 Word、Audio）；
• 选择目标音频格式与码率品质（如 MP3 + 192 kbps）；
• 选择源格式过滤（默认为全部，亦可在下拉框中指定格式）；
• 根据需求决定是否勾选【转码后删除源文件】；

5. 点击 【开始】 执行高速转换；
6. 若需要撤回修改，直接在 Anki 界面按下键盘 Ctrl + Z 即可一键恢复原状。

2. 自动转换音频（针对后续新增卡片）

1. 在 Anki 主界面点击顶部菜单栏 【工具】 -> 【自动转换音频】；
2. 点击 【+ 添加】 创建一条监控规则：

• 监控牌组：展开牌组树勾选需要监控的牌组（支持单选、多选或保持【全部牌组】）；
• 监控模版与字段：右侧树状列表按笔记类型（模版）层级分类，勾选需要处理的模版与字段（默认【全部模版与字段】）；
• 目标格式与码率：选择自动转码的目标格式与音质档位；
• 源格式：设定过滤条件（默认全部处理，亦可指定仅转换 .ogg 等）；

3. 点击 【确定】 保存规则，系统会提示是否对历史存量卡片立即执行一次全量扫描；
4. 规则保存后，自动转换引擎常驻后台：此后每次添加或导入新卡片，所含音频均会在落库前自动完成静默转码。

常见问题 (FAQ)

Q：为什么苹果 iOS / iPadOS 等设备上播放发音没有声音？
A：苹果 iOS / iPadOS 系统原生的多媒体框架（AVFoundation）不直接解码播放 .ogg 等格式音频。使用本插件将卡片中的 .ogg 批量转码或自动转为 .mp3 / .m4a 即可正常发声。

Q：转码后原音频会被删除吗？
A：默认情况下，插件会保留原音频文件以确保数据安全；若希望节约媒体库磁盘空间，可在转码面板中勾选【转码后删除源音频文件】。

Q：转换后需要手动执行 Anki 的“检查媒体”吗？
A：不需要。插件在转码写盘与改写字段引用的同时已自动处理了媒体库索引，AnkiWeb 同步时会自动上传新格式文件。

下载与安装

方式 1：通过 AnkiWeb 安装

在 Anki 中使用插件代码直接安装：

1555675372

在 AnkiWeb 上查看

方式 2：通过 GitHub 手动安装

1. 前往 Releases 页面；
2. 下载最新的 .ankiaddon 文件；
3. 双击该文件即可直接安装导入 Anki。

关于作者

• 作者：蔡Tony
• 我的网站：https://caitony.dpdns.org/
• Github：Caitony-czc

开源许可

本项目采用 MIT 许可证 开源。详情参见项目根目录的 LICENSE 文件。