NVorbis 1.0.0-alpha.2

.NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
This is a prerelease version of NVorbis.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package NVorbis --version 1.0.0-alpha.2
                    


                    

                
NuGet\Install-Package NVorbis -Version 1.0.0-alpha.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="NVorbis" Version="1.0.0-alpha.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="NVorbis" Version="1.0.0-alpha.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="NVorbis" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add NVorbis --version 1.0.0-alpha.2
                    


                    

                
#r "nuget: NVorbis, 1.0.0-alpha.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package NVorbis@1.0.0-alpha.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=NVorbis&version=1.0.0-alpha.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=NVorbis&version=1.0.0-alpha.2&prerelease
                    


                            Install as a Cake Tool

NVorbis

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

This implementation is based on the Vorbis specification found on xiph.org. The MDCT and Huffman codeword generator were borrowed from public domain implementations in https://github.com/nothings/stb/blob/master/stb_vorbis.c.

To use:

// add a reference to NVorbis.dll

// this is the simplest usage; see the public classes and constructors for other options
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.TimePosition;
    }
}

NVorbis can be downloaded on NuGet.

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.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (60)

Showing the top 5 NuGet packages that depend on NVorbis:

Package Downloads
MonoGame.Framework.DesktopGL

The MonoGame runtime supporting Windows, Linux and macOS using SDL2 and OpenGL.
NAudio.Vorbis

NAudio support for Vorbis
AdamsLair.Duality

The Duality engine core.
engenious

engenious graphics framework core assembly, similar to XNA/MonoGame.
DeltaEngine.Xna

Xna Version of the Delta Engine, requires Xna 4.0 framework to be installed. The Delta Engine allows you to develop applications and especially games for many different platforms (mobile, tablets, console, PC) completely under Windows with .NET or native C++ by using your favorite tools.

GitHub repositories (37)

Showing the top 20 popular GitHub repositories that depend on NVorbis:

Repository Stars
OpenRA/OpenRA
Open Source real-time strategy game engine for early Westwood games such as Command & Conquer: Red Alert written in C# using SDL and OpenGL. Runs on Windows, Linux, *BSD and Mac OS X.
MonoGame/MonoGame
One framework for creating powerful cross-platform games.
morkt/GARbro
Visual Novels resource browser
4sval/FModel
Unreal Engine Archives Explorer
ddevault/TrueCraft
Minecraft for hipsters
filoe/cscore
An advanced audio library, written in C#. Provides tons of features. From playing/recording audio to decoding/encoding audio streams/files to processing audio data in realtime (e.g. applying custom effects during playback, create visualizations,...). The possibilities are nearly unlimited.
FakeFishGames/Barotrauma
A 2D online multiplayer game taking place in a submarine travelling through the icy depths of Jupiter's moon Europa.
AdamsLair/duality
a 2D Game Development Framework
WolvenKit/WolvenKit
Community Mod editor/creator for REDengine games.
ProwlEngine/Prowl
An Open Source C# 3D Game Engine under MIT license, inspired by Unity and featuring a complete editor
MaKiPL/OpenVIII-monogame
Open source Final Fantasy VIII engine implementation in C# working on Windows and Linux (Android and iOS planned too!) [Monogame]
overtools/OWLib
DataTool is a program that lets you extract models, maps, and files from Overwatch.
ciribob/DCS-SimpleRadioStandalone
An open source Stand alone Radio for DCS integrating with all clickable cockpits and FC3 Aircraft
Suprcode/Zircon
Legend of Mir 3 - Official Public Zircon Source
rampaa/JL
JL is a program for looking up Japanese words and expressions.
leezer3/OpenBVE
OpenBVE- A free train simulator
egordorichev/BurningKnight
Top-down roguelike about goblins, lamps and magic
Kalejin/DCSB
Deathcounter and Soundboard, WPF app for setting up key shortcuts
zhongkaifu/TensorSharp
A native .NET LLM inference engine for GGUF models. TensorSharp provides a console application, a web-based chatbot interface, and Ollama/OpenAI-compatible HTTP APIs for programmatic access. It supports Windows/MacOS/Linux with full GPU capability
mir-ethernity/mir-eternal
Version Downloads Last Updated
1.0.0-rc.2 209 7/13/2026
1.0.0-beta.1 83 7/11/2026
1.0.0-alpha.2 191 6/29/2026
1.0.0-alpha.1 67 6/28/2026
0.10.5 392,193 10/16/2022
0.10.4 926,186 9/29/2021
0.9.1 12,715 1/19/2020
Loading failed

1.0.0-alpha.2:
- Fix dead loop in StreamDecoder.Read on a near-end re-seek + over-read; re-seek is now correct/idempotent (#40, #74)
- NuGet publish via GitHub OIDC trusted publishing (#73)

1.0.0-alpha.1:

Reliability and correctness:
- Fix SeekOrigin.Current seeking backward instead of forward (#46)
- Fix mux submap bounds check off-by-one (#47)
- Fix seeking to position 0 when the last header page has granule -1 (#55)
- Bound NormalizePacketIndex walkback at the first data page (#58)
- Fix three decode bugs surfaced by new tests: PacketCount, FindPacket EOS clipping, SeekTo(TotalSamples) (#59)
- Remove dead null check, make Dispose idempotent, fix Codebook idxDiv overflow (#61)
- MDCT double-precision twiddle factors, Floor0 bark-scale precision, Codebook null safety (#63)
- Correct VerifyPage bounds and VerifyHeader comparison in PageReaderBase (#64)
- Fix Enum.HasFlag boxing, stats bit undercount, Extensions.Read zero-length guard, seek error message (#68)

Performance:
- Eliminate per-packet List<int> allocation (#56)
- Cache page packets to avoid a double read on seek (#57)
- Lock-free StreamStats and ArrayPool reuse in Residue0 (#60)
- Use MathF for float arithmetic in the decode paths (#67)

API:
- New Read(Span<float>) on IStreamDecoder, VorbisReader.OpenAsync, and threading docs (#62)

Packaging and maintenance:
- Add netstandard2.1 target (#41)
- Include README.md in the NuGet package (#43)
- Typos, named constants, readonly fields, drop net45 target (#65)
- Remove obsolete backward-compatibility shims (#66)

Tests:
- Add issue #28 regression fixture and unit-coverage batches 1-3 (#59, #69, #70, #71)