1llum1n4t1s.NAudio 4.0.3

dotnet add package 1llum1n4t1s.NAudio --version 4.0.3
                    
NuGet\Install-Package 1llum1n4t1s.NAudio -Version 4.0.3
                    
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="1llum1n4t1s.NAudio" Version="4.0.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="1llum1n4t1s.NAudio" Version="4.0.3" />
                    
Directory.Packages.props
<PackageReference Include="1llum1n4t1s.NAudio" />
                    
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 1llum1n4t1s.NAudio --version 4.0.3
                    
#r "nuget: 1llum1n4t1s.NAudio, 4.0.3"
                    
#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 1llum1n4t1s.NAudio@4.0.3
                    
#: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=1llum1n4t1s.NAudio&version=4.0.3
                    
Install as a Cake Addin
#tool nuget:?package=1llum1n4t1s.NAudio&version=4.0.3
                    
Install as a Cake Tool

1llum1n4t1s.NAudio

Nuget

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 the NAudio.Effects framework
  • 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.WinMMWaveOut / WaveIn, classic MIDI I/O, ACM codecs and mixer controls via winmm.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);
}

License

MIT. See the fork repository for source and issues, and the upstream project for the original project and contributors.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed

### Fixed

- `WaveFileWriter.WriteSample` が範囲外のfloatを16-bit整数PCMへ書くと符号反転する問題を修正しました。
- `OffsetSampleProvider` のTimeSpan指定が長時間音源でsample数をオーバーフローする問題を修正しました。
- `FadeInOutSampleProvider` の0ミリ秒未満のsample数になるfadeでNaNを出力する問題を修正しました。
- `WaveFileReader` が末尾の不完全なsample frameを返す問題を修正しました。