数学视频动画引擎Python库 -- Manim Voiceover 安装 Installation

发布于:2025-07-05 ⋅ 阅读:(24) ⋅ 点赞:(0)

文中内容仅限技术学习与代码实践参考,市场存在不确定性,技术分析需谨慎验证,不构成任何投资建议。

Mathematical Animation Engine

Manim Voiceover 是一个为 Manim 打造的专注于语音旁白的插件:

  • 直接在 Python 中添加语音旁白: 无需使用视频编辑器,即可为 Manim 视频添加语音旁白。
  • 在渲染期间录制旁白: 通过简单的命令行界面(参见 RecorderService),可使用麦克风在渲染过程中录制语音旁白。
  • 使用 AI 生成旁白: 利用多种免费及付费服务,开发时可直接使用 AI 自动生成的配音。
  • 动画逐词时间标记: 实现动画与语音旁白的逐词时间标记同步,即根据语音旁白中特定词语触发相应的动画效果。即使是录制的音频,此功能也能实现。这得益于 OpenAI Whisper 技术的支持。

安装

从 PyPI 安装带有额外组件 azuregtts 的 Manim Voiceover :

pip install --upgrade "manim-voiceover[azure,gtts]"

检查安装是否正确:

wget https://github.com/ManimCommunity/manim-voiceover/raw/main/examples/gtts-example.py
manim -pql gtts-example.py --disable_caching

重要提示:由于存在一个漏洞,调用 Manim 时需要加上 --disable_caching 标志。每次渲染时都不要忘记加上它。

上面的例子使用了 gTTS,它调用了 Google 翻译 API,因此需要联网才能工作。如果出现错误,可能是你的网络连接有问题,或者是 Google 翻译 API 出了问题。

附加组件

Manim Voiceover 默认不会安装所有依赖项。它会动态检测缺少哪些软件包,并会请求您的许可来安装它们,因此您无需担心手动安装它们。

如果您想安装所有依赖项,请使用 all extra 命令:

pip install --upgrade "manim-voiceover[all]"

您可以在 pyproject.toml 文件中查看其他附加组件。

安装 PortAudio

Manim Voiceover 允许你在渲染过程中使用 PyAudio 录制旁白。
PyAudio 依赖于 PortAudio,而 PortAudio 需要单独安装。

在基于 Debian 的发行版上:

sudo apt install portaudio19-dev
sudo pip install pyaudio
# 或者从 apt 全局安装:
sudo apt install python3-pyaudio

在 macOS 上,你可以使用 Homebrew 安装:

brew install portaudio
pip install pyaudio

在 Windows 上,PortAudio 应该会随二进制文件预先打包,因此只需使用 pip 安装 PyAudio :

python -m pip install pyaudio

更多信息请参考 PyAudio 文档

安装 SoX

Manim Voiceover 可以使用 SoX(需要 14.4.2 或更高版本)来加快或减慢语音合成器的输出。

在 Mac 上使用 Homebrew 安装 SoX :

brew install sox

在基于 Debian 的发行版上安装 SoX(以及必要的 mp3 处理器):

sudo apt-get install sox libsox-fmt-all

或者从源代码安装

安装 gettext

Manim Voiceover 使用 gettext 来存储和获取旁白文本的翻译。如果你打算自动翻译视频,你需要安装 gettext。

在基于 Debian 的发行版上:

sudo apt install gettext

在 macOS 上,你可以使用 Homebrew 安装:

brew install gettext

风险提示与免责声明
本文内容基于公开信息研究整理,不构成任何形式的投资建议。历史表现不应作为未来收益保证,市场存在不可预见的波动风险。投资者需结合自身财务状况及风险承受能力独立决策,并自行承担交易结果。作者及发布方不对任何依据本文操作导致的损失承担法律责任。市场有风险,投资须谨慎。


网站公告

今日签到

点亮在社区的每一天
去签到