NAudio 3.1.0
NAudio
NAudio is an open source .NET audio library written by Mark Heath and contributors.
This is the main NAudio meta-package. Installing it pulls in everything you need to play, record and manipulate audio on .NET, and adds AudioFileReader — the one-line "just open this audio file" reader that picks the right decoder for you — along with Mp3FileReader.
Requires net9.0 or later. If you need .NET Framework or .NET Standard 2.0, use NAudio 2.x.
What it pulls in
Always, on every target framework:
- NAudio.Core — the format-independent core:
WaveStream,IWaveProvider/ISampleProvider, WAV and AIFF readers and writers, mixing, resampling, DSP, and theNAudio.Effectsframework - NAudio.Midi — the MIDI event model and Standard MIDI File reading and writing
Additionally, on a Windows target framework:
- NAudio.Wasapi — WASAPI playback, capture and loopback (
WasapiPlayer/WasapiRecorder), plus Media Foundation codecs - NAudio.WinMM —
WaveOut/WaveIn, classic MIDI I/O, ACM codecs and mixer controls viawinmm.dll - NAudio.Asio — low-latency multichannel playback and capture through ASIO drivers
- NAudio.Dmo — DMO effects, the DMO MP3 decoder and resampler, and
DirectSoundOut - NAudio.WinForms — Windows Forms controls, and the window-callback
WaveOutWindow/WaveInWindow
On a non-Windows target framework only the cross-platform pieces are referenced. If you only need a subset, reference the individual packages directly rather than this meta-package.
Optional packages
These are not pulled in by the meta-package — add them explicitly if you want them:
| Package | Platform | What it gives you |
|---|---|---|
| NAudio.Sampler | cross-platform | Polyphonic software sampler — SoundFont (.sf2), SFZ and single-sample instruments |
| NAudio.SoundFile | cross-platform | Read and write WAV/AIFF/FLAC/Ogg-Vorbis/Opus/MP3 via libsndfile |
| NAudio.Alsa | Linux | AlsaOut / AlsaIn playback and capture via libasound |
| NAudio.Vst3 | Windows | VST 3 plug-in hosting (preview) — effects and instruments |
| NAudio.Extras | cross-platform (+ Windows extras) | Opinionated helpers — playback engine, capture mixing, ID3 tags |
Getting started
using NAudio.Wave;
using var audioFile = new AudioFileReader("myfile.mp3");
using var player = new WasapiPlayerBuilder().Build();
player.Init(audioFile);
player.Play();
while (player.PlaybackState == PlaybackState.Playing)
{
Thread.Sleep(500);
}
- Documentation site — tutorials and the full API reference
- GitHub repository — source, issues, and the demo applications (
NAudioDemo,NAudioWpfDemo) - Migrating from NAudio 2 to NAudio 3 — every breaking change, with before/after code
License
MIT. See the project site for source, issues, and contribution guidelines.
Showing the top 20 packages that depend on NAudio.
| Packages | Downloads |
|---|---|
|
NDILibDotNetCoreBase
Provides a wrapper to the NDI libraries for Windows, macOS, and Linux.
|
17 |
|
NDILibDotNetCoreBase
Provides a wrapper to the NDI libraries for Windows, macOS, and eventually Linux.
|
17 |
|
NDILibDotNetCoreBase
Provides a wrapper to the NDI libraries for Windows, macOS, and eventually Linux.
|
13 |
|
NDILibDotNetCoreBase
Provides a wrapper to the NDI libraries for Windows, macOS, and Linux.
|
12 |
A correctness release, with Native AOT as the theme. NAudio's remaining
[StructLayout] interop types — WAVEHDR, ACMSTREAMHEADER and WaveFormat
itself — were passed to native code by value, which CoreCLR pins in place but
the AOT marshaller copies into a per-call temporary. Anything the driver or
codec wrote back was silently discarded, so WaveIn/WaveOut, ACM conversion
(and with it Mp3FileReader and AudioFileReader) and every WASAPI, Media
Foundation and DMO format negotiation were broken in an AOT-published app while
building and running cleanly. Those paths now marshal by hand into stable
unmanaged blocks, and NAudio.WinMM joins the AOT-compatible package set.
The two breaking changes below both fall out of that work. Also fixed are two
3.0.0 regressions — Mp3FileReaderBase seeking on files with a Xing/Info
header, and WdlResamplingSampleProvider losing samples when its source
under-feeds — and a pair of infinite loops in the WAV parser on corrupt files.
- Breaking:
WaveFormatand its subclasses no longer carry[StructLayout], soMarshal.SizeOfandMarshal.PtrToStructureon them now throwArgumentExceptioninstead of silently returning wrong data under Native AOT (Marshal.SizeOf<WaveFormatExtensible>()returned 22 rather than 40, and a decoded format kept its constructor defaults). NAudio itself stopped marshalling these types in 3.1.0; useToWaveFormatExBytes,MarshalToPtrorMarshalFromPtrto cross a native boundary (#1432) - Breaking:
AudioClient.IsFormatSupportedandWasapiPlayer.IsFormatSupportednow return the closest-match format asout WaveFormatrather thanout WaveFormatExtensible. WASAPI documents this format as either aWAVEFORMATEXor aWAVEFORMATEXTENSIBLE, and the old signature could only represent the latter — a plain format was previously decoded as aWaveFormatExtensiblewhose base fields were valid but whose extensible fields were meaningless. Callers needing the extensible fields should pattern-match (#1425) - Fixed
WaveIn/WaveOutfailing under Native AOT withWaveHeaderUnprepared("The wave header was not prepared"). TheWAVEHDRwas a[StructLayout]class passed to winmm by value, which CoreCLR pins in place but NativeAOT copies into a per-call temporary, so the driver'sWHDR_PREPARED/WHDR_DONE/dwBytesRecordedwrites were discarded. It is now a struct in a stable unmanaged block (#1425) - Fixed ACM conversion failing under Native AOT —
WaveFormatConversionStream,AcmStreamand soMp3FileReaderandAudioFileReader.ACMSTREAMHEADERwas a[StructLayout]class passed to msacm32 by value, and the codec keeps private state in the header's reserved fields betweenacmStreamPrepareHeader,acmStreamConvertandacmStreamUnprepareHeader; the AOT marshaller's per-call copy round-trips only the declared fields, so that state was lost and conversion failed. It is now a struct in a stable unmanaged block, asWAVEHDRalready is (#1425) - Fixed
WaveFormat.MarshalToPtrandWaveFormat.MarshalFromPtrcorrupting anyWaveFormatsubclass under Native AOT — the AOT marshaller drops the inheritedWAVEFORMATEXfields of a class hierarchy, so aWaveFormatExtensiblewas written with its SubFormat GUID over the sample rate. Every remaining site that sized or wrote aWaveFormatwithMarshal.SizeOf/StructureToPtrwas converted too: WASAPI (AudioClient), Media Foundation (MFInitMediaTypeFromWaveFormatEx, reachable fromMediaFoundationResampler/MediaFoundationEncoder), DMO (DmoMediaType.SetWaveFormat,MediaObject) and ACM (AcmStream,AcmDriver) (#1425) WaveFormat.MarshalToPtrnow always allocates at least the18 + cbSizebytes it advertises. AWaveFormatsubclass that declaresextraSizebut doesn't write it inSerializepreviously produced a block shorter than its owncbSize, which a native consumer would read past (#1425)- Added
WaveFormat.ToWaveFormatExBytes(), which renders aWaveFormatas a native WAVEFORMATEX byte array.MarshalToPtris now a thin wrapper over it, for callers who need an unmanaged block rather than a buffer they already own (#1425) - Added a
Serializeoverride toMp3WaveFormat, which previously advertisedcbSize= 12 but wrote none of its 12 MPEGLAYER3WAVEFORMAT extra bytes (#1425) WaveFormatExtraDatanow sizes its buffer fromcbSizeinstead of holding a fixed 100-byte array, so a fmt chunk declaring more than 100 bytes of extra data keeps it rather than having all of it discarded (#482). The fixed size existed only because[MarshalAs(ByValArray, SizeConst = 100)]needed a compile-time length.ExtraDatais now exactlyExtraSizebytes long rather than always 100 (#1432)NAudio.WinMMis now markedIsAotCompatible, and the AOT smoke test covers the winmm WAVEHDR/WAVEFORMATEX paths (#1425)- Fixed
Mp3FileReaderBaseseeking silently restarting playback from the beginning of the file on MP3s with a Xing/Info header — the lazy frame index was gated onIsLengthExact, which such a header sets without any frame having been scanned. Also fixed seeks landing on the wrong frame when the target fell exactly on a frame boundary, and Xing/Info header frames being indexed as audio (shifting every seek in those files ~26 ms early). A 3.0.0 regression (#1419) - Fixed
WdlResamplingSampleProviderlosing samples, and eventually returning 0 permanently, when asked for more output than the source could supply — a 3.0.0 regression that broke the common pattern of reading generously from aBufferedWaveProvider-backed capture chain.WdlResampler.ResampleOutalso no longer drifts in input-driven (feed) mode when handed fewer samples thanResamplePreparerequested (#1412) - Fixed two infinite loops in the WAV parser triggered by corrupt files declaring a negative chunk size. An RF64
ds64chunk with a negativedataChunkLength, or aLIST/adtlsub-chunk with a negative size, made the chunk walk advance by zero bytes per iteration and spin at 100% CPU without throwing. Negative and oversized sizes are now rejected where they are read, and an undersizedds64chunk throwsFormatExceptionrather thanArgumentOutOfRangeException(#1428) - Fixed the
NAudioConsoleTestWASAPI exclusive-mode quick scan reporting no supported formats at all on devices that support plenty — it built its probe formats with an emptyWAVEFORMATEXTENSIBLEchannel mask, which drivers such as Realtek reject outright. It now probes with the canonical layout for the channel count, the same mask the library's own format adaptation uses (#1431)
.NET 9.0
- NAudio.Core (>= 3.1.0)
- NAudio.Midi (>= 3.1.0)
.NET 9.0
- NAudio.Asio (>= 3.1.0)
- NAudio.Core (>= 3.1.0)
- NAudio.Dmo (>= 3.1.0)
- NAudio.Midi (>= 3.1.0)
- NAudio.Wasapi (>= 3.1.0)
- NAudio.WinForms (>= 3.1.0)
- NAudio.WinMM (>= 3.1.0)
.NET 9.0
- NAudio.Asio (>= 3.1.0)
- NAudio.Core (>= 3.1.0)
- NAudio.Dmo (>= 3.1.0)
- NAudio.Midi (>= 3.1.0)
- NAudio.Wasapi (>= 3.1.0)
- NAudio.WinForms (>= 3.1.0)
- NAudio.WinMM (>= 3.1.0)
| Version | Downloads | Last updated |
|---|---|---|
| 3.1.1-preview.2 | 1 | 09/22/2026 |
| 3.1.1-preview.1 | 8 | 09/10/2026 |
| 3.1.0 | 7 | 09/07/2026 |
| 3.1.0-preview.2 | 7 | 09/06/2026 |
| 3.1.0-preview.1 | 11 | 09/04/2026 |
| 3.0.2-preview.2 | 5 | 09/03/2026 |
| 3.0.2-preview.1 | 15 | 08/20/2026 |
| 3.0.1 | 11 | 08/18/2026 |
| 3.0.1-preview.1 | 11 | 08/18/2026 |
| 3.0.0 | 9 | 08/16/2026 |
| 3.0.0-preview.20 | 13 | 08/10/2026 |
| 3.0.0-preview.19 | 11 | 07/29/2026 |
| 3.0.0-preview.18 | 12 | 07/18/2026 |
| 3.0.0-preview.17 | 15 | 07/15/2026 |
| 3.0.0-preview.16 | 11 | 07/01/2026 |
| 3.0.0-preview.15 | 0 | 06/28/2026 |
| 3.0.0-preview.14 | 0 | 06/25/2026 |
| 3.0.0-preview.10 | 2 | 09/08/2026 |
| 3.0.0-preview.9 | 0 | 05/27/2026 |
| 3.0.0-preview.8 | 0 | 05/22/2026 |
| 3.0.0-preview.7 | 1 | 09/21/2026 |
| 3.0.0-preview.6 | 1 | 09/19/2026 |
| 3.0.0-preview.5 | 0 | 05/11/2026 |
| 3.0.0-preview.4 | 0 | 05/11/2026 |
| 3.0.0-preview.3 | 1 | 09/18/2026 |
| 3.0.0-preview.2 | 1 | 09/16/2026 |
| 2.4.0 | 8 | 08/28/2026 |
| 2.3.0 | 19 | 05/30/2026 |
| 2.2.1 | 18 | 05/30/2026 |
| 2.2.0 | 21 | 05/30/2026 |
| 2.1.0 | 15 | 05/30/2026 |
| 2.1.0-beta.1 | 15 | 05/30/2026 |
| 2.0.1 | 19 | 05/30/2026 |
| 2.0.0 | 19 | 05/30/2026 |
| 2.0.0-beta2 | 18 | 05/30/2026 |
| 2.0.0-beta1 | 17 | 05/30/2026 |
| 1.10.0 | 19 | 05/29/2026 |
| 1.9.0 | 15 | 05/30/2026 |
| 1.9.0-preview2 | 16 | 05/30/2026 |
| 1.9.0-preview1 | 15 | 05/30/2026 |
| 1.8.5 | 17 | 05/30/2026 |
| 1.8.4 | 18 | 05/30/2026 |
| 1.8.3 | 17 | 05/30/2026 |
| 1.8.2 | 16 | 05/30/2026 |
| 1.8.1 | 18 | 05/30/2026 |
| 1.8.0 | 1 | 09/21/2026 |
| 1.7.3 | 19 | 05/30/2026 |
| 1.7.2 | 15 | 05/30/2026 |
| 1.7.1 | 15 | 05/30/2026 |
| 1.7.0 | 15 | 05/30/2026 |
| 1.7.0-beta01 | 17 | 05/30/2026 |
| 1.7.0-alpha06 | 2 | 09/10/2026 |
| 1.7.0-alpha05 | 1 | 09/19/2026 |
| 1.7.0-alpha04 | 2 | 09/08/2026 |
| 1.7.0-alpha03 | 17 | 05/29/2026 |
| 1.7.0-alpha02 | 2 | 09/08/2026 |
| 1.7.0-alpha01 | 1 | 09/08/2026 |
| 1.6.0 | 18 | 05/30/2026 |
| 1.5.7-beta | 1 | 09/20/2026 |
| 1.5.6-beta | 0 | 10/09/2012 |
| 1.5.5-beta | 0 | 09/11/2012 |
| 1.5.4-beta | 2 | 09/18/2026 |
| 1.5.3-beta | 0 | 03/05/2012 |
| 1.5.2-beta | 0 | 03/03/2012 |
| 1.5.1-beta | 0 | 03/02/2012 |
| 1.5.0 | 2 | 09/10/2026 |