oggpy

A Boost.Python wrapper for ogg and vorbis.

mail feedback: Daniel Holth <dholth@fastmail.fm>; see below for details.

Latest News

5 Feb. 2007

Patched to work on 64-bit systems.

7 April 2004

theora playback is now possible via pygame!

I need help compiling this for Win32 - I have tried using MinGW (gcc for Win32) to do this. I've gotten as far as actually compiling the ogg and vorbis modules but they fail on import.

16 Mar. 2004

Thanks to improvement in numarray, oggpy's encode.py - formerly three times slower than oggenc - can now encode ogg/vorbis files in just 6.5% to 14% more time than oggenc. That's just a few seconds penalty for the flexibility of Python.

What can oggpy do for me?

Decode ogg/vorbis.
Play ogg/vorbis through python's oss audio device.
Encode custom ogg bitstreams - not necessarily vorbis.
Re-encode ogg/vorbis for icecast streaming via your favorite libshout2 python wrapper.
Expose basic information about theora streams.

How do I compile oggpy?

oggpy requires Boost.Python version 1.31 and of course the ogg and vorbis libraries. If you want to use theora you need the theora library to manipulate it, and pygame to display it. oggpy is distributed as a Python distutils package. First edit setup.py to suit your needs, then 'python setup.py build'.

Okay, where are the examples?

Here they are:

encode.py
decode.py
oggtext.py
theoratest.py
video.py
rfc3533.ogg - the ogg bitstream version 0 rfc, encoded in a simple one packet per line, one ogg page per text page format.

doxygen docs for the C++ wrapper

Download

The unreleased newest version, patched to work on 64-bit systems: http://svn.xiph.org/experimental/dholth/oggpy

oggpy-0.5.tar.gz source code and examples

Older stuff

oggpy-0.4.linux-i686.tar.gz binaries for Debian unstable. This includes a copy of libboost in ./usr/lib/python2.3/site-packages/libboost_python-gcc-1_31.so.1.31.0 ; you will want to move that file to your library path or set LD_LIBRARY_PATH to a directory containing it.

oggpy-0.4.tar.gz source code and examples

After the dependencies are installed, it should be easy to compile oggpy. Debian and gentoo are ready with up to date boost packages, and oggpy has been tested apart from just my own machine. There's also a partial boost-jam jamfile if you're interested. Thanks for visiting!