安装#

从 PyPI 安装 Manim Voiceover，并带上 azure 和 gtts 扩展包

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 扩展包

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

你可以在 pyproject.toml 文件中查看其他扩展包。

Manim Voiceover 允许你在渲染期间使用 PyAudio 进行配音。PyAudio 依赖于 PortAudio，后者需要单独安装。

在基于 Debian 的发行版上

sudo apt install portaudio19-dev
sudo pip install pyaudio
# Or install from apt globally:
sudo apt install python3-pyaudio

在 macOS 上，你可以使用 Homebrew 安装它

brew install portaudio
pip install pyaudio

在 Windows 上，PortAudio 应该预先打包了二进制文件，因此只需使用 pip 安装 PyAudio 即可

python -m pip install pyaudio

更多信息，请参阅 PyAudio 文档。

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

在 Mac 上使用 Homebrew 安装 SoX

brew install sox

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

sudo apt-get install sox libsox-fmt-all

Manim Voiceover 使用 gettext 来存储和获取配音文本的翻译。如果你计划自动翻译你的视频，你需要安装 gettext。

在基于 Debian 的发行版上

sudo apt install gettext

在 macOS 上，你可以使用 Homebrew 安装它

brew install gettext