/PyOgg

Simple OGG Vorbis, Opus and FLAC bindings for Python

Primary LanguagePythonThe UnlicenseUnlicense

PyOgg

Build Status Documentation Status

PyOgg provides Python bindings for Xiph.org’s Opus, Vorbis and FLAC audio file formats as well as their Ogg container format.

PyOgg:

  • Reads and streams Opus, Vorbis, and FLAC audio formats in their standard file format (that is, from within Ogg containers).

  • Writes Opus files (that it, Opus-formatted packets into Ogg containers)

  • Reads and writes Opus-formatted packets (transported, for example, via UDP)

Further, should you wish to have still lower-level access, PyOgg provides ctypes interfaces that give direct access to the C functions and datatypes found in the libraries.

Under Windows, PyOgg comes bundled with the required dynamic libraries (DLLs) in the Windows Wheel distributions.

Under macOS, the required libraries can be easily installed using Homebrew.

PyOgg is not capable of playing audio, however, you can use Python audio libraries such as simpleaudio, sounddevice, or PyOpenAL to play audio. PyOpenAL even offers 3D playback.

For more detail, including installation instructions, please see the documentation at Read the Docs.

Building the Docs

If you are unable to find the documentation at Read the Docs, you may build the documentation yourself. First, clone this repository and from within the repository's directory, install PyOgg in editable mode using:

pip install -e .

Building the documentation requires Sphinx and the Read the Docs theme:

pip install sphinx
pip install sphinx-rtd-theme

Then, enter the docs directory and run:

make html

This will produce a docs/_build/html directory. Open the file index.html to browse the documentation.