NAudio 3.0.1
Prefix ReservedSee the version list below for details.
dotnet add package NAudio --version 3.0.1
NuGet\Install-Package NAudio -Version 3.0.1
<PackageReference Include="NAudio" Version="3.0.1" />
<PackageVersion Include="NAudio" Version="3.0.1" />
<PackageReference Include="NAudio" />
paket add NAudio --version 3.0.1
#r "nuget: NAudio, 3.0.1"
#:package NAudio@3.0.1
#addin nuget:?package=NAudio&version=3.0.1
#tool nuget:?package=NAudio&version=3.0.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 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.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. 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. net9.0-windows7.0 is compatible. net9.0-windows10.0.19041 is compatible. 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. |
-
net9.0
- NAudio.Core (>= 3.0.1)
- NAudio.Midi (>= 3.0.1)
-
net9.0-windows10.0.19041
- NAudio.Asio (>= 3.0.1)
- NAudio.Core (>= 3.0.1)
- NAudio.Dmo (>= 3.0.1)
- NAudio.Midi (>= 3.0.1)
- NAudio.Wasapi (>= 3.0.1)
- NAudio.WinForms (>= 3.0.1)
- NAudio.WinMM (>= 3.0.1)
-
net9.0-windows7.0
- NAudio.Asio (>= 3.0.1)
- NAudio.Core (>= 3.0.1)
- NAudio.Dmo (>= 3.0.1)
- NAudio.Midi (>= 3.0.1)
- NAudio.Wasapi (>= 3.0.1)
- NAudio.WinForms (>= 3.0.1)
- NAudio.WinMM (>= 3.0.1)
NuGet packages (262)
Showing the top 5 NuGet packages that depend on NAudio:
| Package | Downloads |
|---|---|
|
SIL.Media
SIL.Media contains Windows Forms UI elements and classes for processing audio on Windows and Linux. |
|
|
AlphaTab.Windows
alphaTab is a cross platform music notation and guitar tablature rendering library. |
|
|
MilestoneSystems.VideoOS.Platform.SDK
Milestone Integration Platform Software Development Kit for standalone application development |
|
|
MicroServices
Micro Services Essential Pack |
|
|
SIPSorceryMedia
The SIPSorcery package for WebRTC plumbing and Windows audio and video capture. |
GitHub repositories (230)
Showing the top 20 popular GitHub repositories that depend on NAudio:
| Repository | Stars |
|---|---|
|
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
|
|
|
rocksdanister/lively
Free and open-source software that allows users to set animated desktop wallpapers and screensavers powered by WinUI 3.
|
|
|
MathewSachin/Captura
Capture Screen, Audio, Cursor, Mouse Clicks and Keystrokes
|
|
|
microsoft/ailab
Experience, Learn and Code the latest breakthrough innovations with Microsoft AI
|
|
|
STranslate/STranslate
A ready-to-go translation ocr tool developed with WPF/WPF 开发的一款即用即走的翻译、OCR工具
|
|
|
ScottPlot/ScottPlot
Interactive plotting library for .NET
|
|
|
LorisYounger/VPet
虚拟桌宠模拟器 一个开源的桌宠软件, 可以内置到任何WPF应用程序
|
|
|
Azure/azure-sdk-for-net
This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
|
|
|
immense/Remotely
A remote control and remote scripting solution, built with .NET 8, Blazor, and SignalR.
|
|
|
PCL-Community/PCL-CE
PCL 社区版 由社区开发者维护与管理
|
|
|
openutau/OpenUtau
Open singing synthesis platform / Open source UTAU successor
|
|
|
jitwxs/163MusicLyrics
云音乐歌词获取处理工具【网易云、QQ音乐】
|
|
|
ModernFlyouts-Community/ModernFlyouts
A modern Fluent Design replacement for the old Metro themed flyouts present in Windows.
|
|
|
unchihugo/FluentFlyout
The modern Flyout app for Windows 11, built with Fluent 2 Design principles. Media Flyouts, Taskbar Widgets and more.
|
|
|
SciSharp/LLamaSharp
A C#/.NET library to run LLM (🦙LLaMA/LLaVA) on your local device efficiently.
|
|
|
Azure-Samples/cognitive-services-speech-sdk
Sample code for the Microsoft Cognitive Services Speech SDK
|
|
|
Belphemur/SoundSwitch
C# application to switch default playing device. Download: https://soundswitch.aaflalo.me/
|
|
|
morkt/GARbro
Visual Novels resource browser
|
|
|
SciSharp/BotSharp
AI Multi-Agent Framework in .NET
|
|
|
open-rpa/openrpa
Free Open Source Enterprise Grade RPA
|
| Version | Downloads | Last Updated |
|---|---|---|
| 3.0.2-preview.1 | 50 | 8/20/2026 |
| 3.0.1 | 5,511 | 8/18/2026 |
| 3.0.1-preview.1 | 77 | 8/17/2026 |
| 3.0.0 | 4,479 | 8/15/2026 |
| 3.0.0-preview.20 | 388 | 8/8/2026 |
| 3.0.0-preview.19 | 525 | 7/25/2026 |
| 3.0.0-preview.18 | 862 | 7/16/2026 |
| 3.0.0-preview.17 | 189 | 7/11/2026 |
| 3.0.0-preview.16 | 526 | 7/1/2026 |
| 3.0.0-preview.15 | 193 | 6/28/2026 |
| 3.0.0-preview.14 | 194 | 6/25/2026 |
| 3.0.0-preview.10 | 487 | 6/8/2026 |
| 3.0.0-preview.9 | 718 | 5/27/2026 |
| 3.0.0-preview.8 | 234 | 5/22/2026 |
| 3.0.0-preview.7 | 99 | 5/21/2026 |
| 3.0.0-preview.6 | 85 | 5/21/2026 |
| 3.0.0-preview.5 | 414 | 5/11/2026 |
| 3.0.0-preview.4 | 91 | 5/11/2026 |
| 3.0.0-preview.3 | 92 | 5/11/2026 |
| 3.0.0-preview.2 | 134 | 5/10/2026 |
A patch release. The headline fix is packaging: the `NAudio` and `NAudio.Extras`
meta-packages now ship a plain `net9.0-windows` leg, so WinForms and WPF projects
targeting `netX.0-windows` get the full Windows stack again.
* **Breaking:** `AudioFileReader` now throws `NotSupportedException` instead of `InvalidOperationException` when the cross-platform build is asked for a format it cannot read, and the messages simply state that rather than suggesting an `NAudio.Wasapi` install that could never have helped (#1407)
* Fixed the `NAudio` and `NAudio.Extras` meta-packages resolving their portable `net9.0` asset on projects targeting a plain `netX.0-windows` TFM (the WinForms/WPF template default), which silently dropped the entire Windows stack — no `WaveOut`, WASAPI, Media Foundation, ASIO, DMO or WinForms types, and `AudioFileReader` throwing "MP3 file reading requires the NAudio.Wasapi package". Both packages now also ship a plain `net9.0-windows` leg (#1407)
* Projects on a plain `netX.0-windows` TFM may now see `CA1416` warnings when calling WASAPI process-loopback capture. The warning is correct — those callers do need an `OperatingSystem.IsWindowsVersionAtLeast(10, 0, 19041)` guard — and was previously hidden because the only Windows asset available already implied that floor (#1407)
* Sample and tool apps now roll forward onto newer .NET runtimes, so running them no longer requires the .NET 9 runtime to be installed (#1408)
* Fixed `AiffFileReader` reporting too long a `Length` and throwing `IndexOutOfRangeException` when the SSND chunk declares a non-zero offset (#1405)
* Fixed `AiffFileReader.Read` throwing `IndexOutOfRangeException` when the source stream returns fewer bytes than requested (#1405)