1llum1n4t1s.NAudio
4.0.3
dotnet add package 1llum1n4t1s.NAudio --version 4.0.3
NuGet\Install-Package 1llum1n4t1s.NAudio -Version 4.0.3
<PackageReference Include="1llum1n4t1s.NAudio" Version="4.0.3" />
<PackageVersion Include="1llum1n4t1s.NAudio" Version="4.0.3" />
<PackageReference Include="1llum1n4t1s.NAudio" />
paket add 1llum1n4t1s.NAudio --version 4.0.3
#r "nuget: 1llum1n4t1s.NAudio, 4.0.3"
#:package 1llum1n4t1s.NAudio@4.0.3
#addin nuget:?package=1llum1n4t1s.NAudio&version=4.0.3
#tool nuget:?package=1llum1n4t1s.NAudio&version=4.0.3
1llum1n4t1s.NAudio
1llum1n4t1s.NAudio is a fork of the open source .NET audio library written by Mark Heath and contributors. It keeps the upstream assembly names and NAudio.* namespaces while publishing every package under the 1llum1n4t1s.NAudio.* ID family.
This is the main 1llum1n4t1s.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 net10.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);
}
- Upstream documentation site — tutorials and the full API reference
- Fork repository — source, issues, and the demo applications (
NAudioDemo,NAudioWpfDemo) - Fork changelog — fork-specific fixes, compatibility notes, and release history
- Migrating from NAudio 2 to NAudio 3 — every breaking change, with before/after code
License
MIT. See the fork repository for source and issues, and the upstream project for the original project and contributors.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. net10.0-windows7.0 is compatible. net10.0-windows10.0.19041 is compatible. |
-
net10.0
- 1llum1n4t1s.NAudio.Core (>= 4.0.3)
- 1llum1n4t1s.NAudio.Midi (>= 4.0.3)
-
net10.0-windows10.0.19041
- 1llum1n4t1s.NAudio.Asio (>= 4.0.3)
- 1llum1n4t1s.NAudio.Core (>= 4.0.3)
- 1llum1n4t1s.NAudio.Dmo (>= 4.0.3)
- 1llum1n4t1s.NAudio.Midi (>= 4.0.3)
- 1llum1n4t1s.NAudio.Wasapi (>= 4.0.3)
- 1llum1n4t1s.NAudio.WinForms (>= 4.0.3)
- 1llum1n4t1s.NAudio.WinMM (>= 4.0.3)
-
net10.0-windows7.0
- 1llum1n4t1s.NAudio.Asio (>= 4.0.3)
- 1llum1n4t1s.NAudio.Core (>= 4.0.3)
- 1llum1n4t1s.NAudio.Dmo (>= 4.0.3)
- 1llum1n4t1s.NAudio.Midi (>= 4.0.3)
- 1llum1n4t1s.NAudio.Wasapi (>= 4.0.3)
- 1llum1n4t1s.NAudio.WinForms (>= 4.0.3)
- 1llum1n4t1s.NAudio.WinMM (>= 4.0.3)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on 1llum1n4t1s.NAudio:
| Package | Downloads |
|---|---|
|
1llum1n4t1s.NAudio.Extras
Optional extras (extra demo/sample providers and helpers) for the NAudio audio library. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.0.3 | 98 | 8/29/2026 |
| 4.0.2 | 94 | 8/27/2026 |
| 4.0.1 | 98 | 8/26/2026 |
| 4.0.0 | 119 | 8/25/2026 |
| 1.0.49 | 135 | 7/26/2026 |
| 1.0.48 | 110 | 7/26/2026 |
| 1.0.47 | 132 | 7/1/2026 |
| 1.0.46 | 151 | 5/28/2026 |
| 1.0.45 | 143 | 5/22/2026 |
| 1.0.44 | 124 | 5/20/2026 |
| 1.0.43 | 122 | 5/16/2026 |
| 1.0.42 | 185 | 3/10/2026 |
| 1.0.40 | 135 | 2/19/2026 |
| 1.0.34 | 140 | 2/10/2026 |
| 1.0.30 | 131 | 2/7/2026 |
| 1.0.24 | 146 | 1/29/2026 |
| 1.0.22 | 139 | 1/26/2026 |
| 1.0.20 | 134 | 1/26/2026 |
| 1.0.18 | 131 | 1/26/2026 |
| 1.0.16 | 129 | 1/26/2026 |
### Fixed
- `WaveFileWriter.WriteSample` が範囲外のfloatを16-bit整数PCMへ書くと符号反転する問題を修正しました。
- `OffsetSampleProvider` のTimeSpan指定が長時間音源でsample数をオーバーフローする問題を修正しました。
- `FadeInOutSampleProvider` の0ミリ秒未満のsample数になるfadeでNaNを出力する問題を修正しました。
- `WaveFileReader` が末尾の不完全なsample frameを返す問題を修正しました。