NAudio 3.3.0-preview.1
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 what you need to play, record and manipulate audio on Windows, 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
On any target framework (net9.0 or later, with or without -windows):
- 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 (plus WinRT live MIDI I/O when your project targets
net9.0-windows10.0.19041.0or later) - 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.Wasapi and NAudio.WinMM are Windows-only at runtime. They're marked [SupportedOSPlatform("windows")], so the platform compatibility analyzer (CA1416) flags unguarded calls from code that isn't Windows-specific. AudioFileReader reads PCM/float WAV and AIFF everywhere, and uses Media Foundation (MP3, AAC, WMA, FLAC…) and ACM (compressed WAV) when running on Windows.
If you're targeting Linux or macOS, you probably want the individual packages (NAudio.Core plus NAudio.Alsa, NAudio.MacOS or NAudio.SoundFile) 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.Asio | Windows | Low-latency multichannel playback and capture through ASIO drivers (AsioDevice, AsioOut) |
| NAudio.Dmo | Windows | DirectSoundOut, DMO effects, and the DMO MP3 decoder and resampler |
| NAudio.WinForms | Windows (netX.0-windows) |
Windows Forms controls, and the window-callback WaveOutWindow / WaveInWindow |
| 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 (playback engine Windows-only) | Opinionated helpers — playback engine, capture mixing, ID3 tags |
NAudio 3.0–3.2 included NAudio.Asio, NAudio.Dmo and NAudio.WinForms in this meta-package on Windows target frameworks. If you're upgrading and use any of them, add the package reference.
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.
No packages depend on NAudio.
.NET 9.0
- NAudio.Core (>= 3.3.0-preview.1)
- NAudio.Midi (>= 3.3.0-preview.1)
- NAudio.Wasapi (>= 3.3.0-preview.1)
- NAudio.WinMM (>= 3.3.0-preview.1)
| Version | Downloads | Last updated |
|---|---|---|
| 3.4.0-preview.1 | 2 | 11/06/2026 |
| 3.3.0 | 3 | 10/21/2026 |
| 3.3.0-preview.1 | 3 | 10/21/2026 |
| 3.2.0 | 3 | 10/21/2026 |
| 3.2.0-preview.1 | 3 | 10/21/2026 |
| 3.1.1-preview.2 | 4 | 09/25/2026 |
| 3.1.1-preview.1 | 6 | 09/15/2026 |
| 3.1.0 | 6 | 09/15/2026 |
| 3.1.0-preview.2 | 6 | 09/15/2026 |
| 3.1.0-preview.1 | 6 | 09/15/2026 |
| 3.0.2-preview.2 | 6 | 09/15/2026 |
| 3.0.2-preview.1 | 6 | 09/15/2026 |
| 3.0.1 | 6 | 09/15/2026 |
| 3.0.1-preview.1 | 6 | 09/15/2026 |
| 3.0.0 | 6 | 09/15/2026 |
| 3.0.0-preview.20 | 6 | 09/15/2026 |
| 3.0.0-preview.19 | 6 | 09/15/2026 |
| 3.0.0-preview.18 | 6 | 09/15/2026 |
| 3.0.0-preview.17 | 6 | 09/15/2026 |
| 3.0.0-preview.16 | 6 | 09/15/2026 |
| 3.0.0-preview.15 | 6 | 09/15/2026 |
| 3.0.0-preview.14 | 6 | 09/15/2026 |
| 3.0.0-preview.10 | 6 | 09/15/2026 |
| 3.0.0-preview.9 | 6 | 09/15/2026 |
| 3.0.0-preview.8 | 6 | 09/15/2026 |
| 3.0.0-preview.7 | 6 | 09/15/2026 |
| 3.0.0-preview.6 | 6 | 09/15/2026 |
| 3.0.0-preview.5 | 6 | 09/15/2026 |
| 3.0.0-preview.4 | 6 | 09/15/2026 |
| 3.0.0-preview.3 | 6 | 09/15/2026 |
| 3.0.0-preview.2 | 6 | 09/15/2026 |
| 2.4.0 | 6 | 09/15/2026 |
| 2.3.0 | 6 | 09/15/2026 |
| 2.2.1 | 6 | 09/15/2026 |
| 2.2.0 | 6 | 09/15/2026 |
| 2.1.0 | 6 | 09/15/2026 |
| 2.1.0-beta.1 | 6 | 09/15/2026 |
| 2.0.1 | 6 | 09/15/2026 |
| 2.0.0 | 6 | 09/15/2026 |
| 2.0.0-beta2 | 6 | 09/15/2026 |
| 2.0.0-beta1 | 6 | 09/15/2026 |
| 1.10.0 | 6 | 09/15/2026 |
| 1.9.0 | 6 | 09/15/2026 |
| 1.9.0-preview2 | 5 | 09/15/2026 |
| 1.9.0-preview1 | 6 | 09/15/2026 |
| 1.8.5 | 6 | 09/15/2026 |
| 1.8.4 | 6 | 09/15/2026 |
| 1.8.3 | 6 | 09/15/2026 |
| 1.8.2 | 6 | 09/15/2026 |
| 1.8.1 | 6 | 09/15/2026 |
| 1.8.0 | 6 | 09/15/2026 |
| 1.7.3 | 10 | 09/15/2026 |
| 1.7.2 | 6 | 09/15/2026 |
| 1.7.1 | 6 | 09/15/2026 |
| 1.7.0 | 5 | 09/15/2026 |
| 1.7.0-beta01 | 5 | 09/15/2026 |
| 1.7.0-alpha06 | 5 | 09/15/2026 |
| 1.7.0-alpha05 | 5 | 09/15/2026 |
| 1.7.0-alpha04 | 5 | 09/15/2026 |
| 1.7.0-alpha03 | 5 | 09/15/2026 |
| 1.7.0-alpha02 | 5 | 09/15/2026 |
| 1.7.0-alpha01 | 5 | 09/15/2026 |
| 1.6.0 | 5 | 09/15/2026 |
| 1.5.7-beta | 6 | 09/15/2026 |
| 1.5.6-beta | 5 | 09/15/2026 |
| 1.5.5-beta | 6 | 09/15/2026 |
| 1.5.4-beta | 6 | 09/15/2026 |
| 1.5.3-beta | 6 | 09/15/2026 |
| 1.5.2-beta | 6 | 09/15/2026 |
| 1.5.1-beta | 6 | 09/15/2026 |
| 1.5.0 | 5 | 09/15/2026 |