Metadata-Version: 2.0
Name: PyOgg
Version: 0.5.10a1
Summary: Xiph.org's Ogg Vorbis, Opus and FLAC for Python
Home-page: https://github.com/Zuzu-Typ/PyOgg
Author: Zuzu_Typ
Author-email: UNKNOWN
License: BSD 3-clause "New" or "Revised"
Keywords: Xiph ogg vorbis opus flac sound playback audio
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6

=====
PyOgg
=====

PyOgg provides bindings for Xiph.org's OGG Vorbis, OGG Opus and FLAC audio file formats.

It requires the OGG library (e.g. libogg.dll) and at least either OGG Opus' libraries (e.g. libopus.dll, libopusfile.dll) and / or OGG Vorbis' libraries (e.g. libvorbis.dll, libvorbisfile.dll) 
to support Opus and Vorbis respectively, or the FLAC C library (e.g. libFLAC.dll) for FLAC support.

All the functions, structures and datatypes are the same as in the C++ implementation, except for some that couldn't be translated.
If you want to use them natively you will have to use ctypes' data types.
Please refer to the official documentation and the C++ headers.

You can import the various functions from pyogg.ogg, pyogg.vorbis, pyogg.opus and pyogg.flac or use the predefined classes and functions from pyogg.

PyOgg is not capable of playing files, however, you can use OpenAL for normal or even 3D playback with `PyOpenAL <https://pypi.org/project/PyOpenAL>`_.

Currently FLAC cannot be streamed (at least not on Windows), because there seems to be an issue with processing single audio frames.

You can find a reference on `GitHub <https://github.com/Zuzu-Typ/PyOgg>`_


