https://github.com/teampyogg/pyogg

Simple OGG Vorbis, Opus and FLAC bindings for Python
https://github.com/teampyogg/pyogg

audio flac ogg-flac ogg-opus ogg-vorbis opus pip pypi python python2 python3

Last synced: 1 day ago
JSON representation

Simple OGG Vorbis, Opus and FLAC bindings for Python

• Host: GitHub
• URL: https://github.com/teampyogg/pyogg
• Owner: TeamPyOgg
• License: unlicense
• Created: 2017-07-20T18:41:42.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-09-13T09:47:34.000Z (3 months ago)
• Last Synced: 2024-12-11T18:20:33.401Z (14 days ago)
• Topics: audio, flac, ogg-flac, ogg-opus, ogg-vorbis, opus, pip, pypi, python, python2, python3
• Language: Python
• Homepage:
• Size: 8.08 MB
• Stars: 66
• Watchers: 5
• Forks: 27
• Open Issues: 33
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
# PyOgg

[![Build Status](https://travis-ci.com/TeamPyOgg/PyOgg.svg?branch=master)](https://travis-ci.com/TeamPyOgg/PyOgg)

[![Documentation Status](https://readthedocs.org/projects/pyogg/badge/?version=latest)](https://pyogg.readthedocs.io/en/latest/?badge=latest)

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](https://pyogg.readthedocs.io/en/latest/).

Building the Docs

=================

If you are unable to find the documentation at [Read the

Docs](https://pyogg.readthedocs.io/en/latest/), 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.