pyrogg 0.3

这是什么？

pyrogg是一个简单的Ogg-Vorbis音频文件重编码库，使用Cython实现。它从提供的输入文件中读取Vorbis流，并将它们重编码到所需的质量级别（-1 … 10）。它附带了一个方便的命令行界面。

示例

命令行用法

$ recode.py -d outputdir --quality=1 --parallel=3 input1.ogg input2.ogg input3.ogg

Python用法

>>> from pyrogg import VorbisFileRecoder
>>> rec = VorbisFileRecoder("input.ogg")

>>> time = rec.recode("output.ogg", quality=1)

由于解码所需时间远低于编码所需时间，您可能需要设置以下环境变量以避免忙等待OpenMP线程

OMP_WAIT_POLICY=PASSIVE

为什么我要使用它？

• 它可以重编码文件系统上的文件以及文件-like 对象。

• 它使用OpenMP并行解码和编码输入流，以及多进程并行重编码多个文件。因此，它可以充分利用您的机器可以提供的所有资源，使其非常快速。

• 单独输入文件的重编码是线程安全的，并释放了GIL。

为什么我不使用它？

• 目前，错误处理不够详细，因此意外的错误可能会使您的系统崩溃。这应该很容易修复，并且对此类帮助当然会感激不尽。（不要担心，它是用Cython编写的，而不是C。）

• 它不是为了实时重编码流而设计的，只是文件和文件-like 对象。目前，输入文件/对象必须通过seek()允许随机访问。这应该是可修复的。

我如何安装它？

使用pip

pip install pyrogg

请注意，这将执行源码构建，因此您需要在系统上配置一个能够构建 Python 扩展模块以及库包 libogg、libvorbis 以及它们对应的开发包的 C 编译器。大多数操作系统（包括所有常用 Linux 发行版）都允许您通过正常的软件包管理工具安装它们。对于开发包，寻找名为 libogg-dev 或 libogg-devel 的软件包。

然而，对于 Windows 和 MacOS，您需要手动安装它们。请参阅这里

https://www.xiph.org/downloads/