[Vorbis] Searching for pyvorbis docs

[Ralph Giles]

On Fri, Nov 10, 2006 at 01:29:36PM +0100, Christian Edelmann wrote:

> The pyvorbis bindings aren't documented. As i understand the pyvorbis 
> package, this is a simpe 1:1 mapping to libvorbis.
> dir(pyvorbins-oject) gives me an refernece to an C Object.
> If this is correct, the only thing i need is the libvorbis 
> documentation, but i could'nt find this eighter.
> Can someone provide an URL for the libvorbis docs?

There aren't any, unfortunately. You can infer the general outline by 
looking at the example C code included with libvorbis, or the pyvorbis 
examples.

However, for a mass tagger you shouldn't need to use libvorbis. 
And unfortunately ogg.vorbis.VorbisComment doesn't provide methods
to read/write packet data. You'd be better off, I think, just using
pyogg and writing your own comment rewriter in pure python. The format 
is easy to parse, and documented here:

  http://www.xiph.org/vorbis/doc/v-comment.html

The harder part is learning enough about Ogg to parse, edit, and rewrite 
a stream.

  http://www.xiph.org/ogg/doc/oggstream.html
  http://xiph.org/vorbis/doc/Vorbis_I_spec.html#vorbis-over-ogg

If you want less of a challenge, you might consider using os.popen() to 
drive the command line vorbiscomment utility from the vorbis-tools 
package which will do tag rewriting for you.

HTH,
 -r