Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fork of with some performance improvements and a streaming sample for OpenTK
C# Other

NVorbis Gitter

NVorbis is a .Net library for decoding Vorbis files. It is designed to run in partial trust environments and does not require P/Invoke or unsafe code.

This implementation is based on the Vorbis specification found on The MDCT and Huffman codeword generator were borrowed from public domain implementations in

Currently the only container supported is Ogg. Ogg Skeleton and Matroska / WebM are planned (no ETA, though). RTP support is possible, but not planned.

To use:

// add a reference to NVorbis.dll

using (var vorbis = new NVorbis.VorbisReader("path/to/file.ogg"))
    // get the channels & sample rate
    var channels = vorbis.Channels;
    var sampleRate = vorbis.SampleRate;

    // OPTIONALLY: get a TimeSpan indicating the total length of the Vorbis stream
    var totalTime = vorbis.TotalTime;

    // create a buffer for reading samples
    var readBuffer = new float[channels * sampleRate / 5];  // 200ms

    // get the initial position (obviously the start)
    var position = TimeSpan.Zero;

    // go grab samples
    int cnt;
    while ((cnt = vorbis.ReadSamples(readBuffer, 0, readBuffer.Length)) > 0)
        // do stuff with the buffer
        // samples are interleaved (chan0, chan1, chan0, chan1, etc.)
        // sample value range is -0.99999994f to 0.99999994f unless vorbis.ClipSamples == false

        // OPTIONALLY: get the position we just read through to...
        position = vorbis.DecodedTime;

If you are using NAudio, support is available via NAudio.Vorbis.

If you have any questions or comments, feel free to join us on Gitter. If you have any issues or feature requests, please submit them in the issue tracker.

Something went wrong with that request. Please try again.