NAudio.Core 3.2.0-preview.1

NAudio.Core

Nuget

The cross-platform core of NAudio. Contains everything that is independent of the underlying audio API, so it targets plain net9.0 and can be used on Windows, Linux, and macOS.

What's included

  • WaveStream, IWaveProvider, ISampleProvider and associated base classes
  • WaveFormat and format-conversion helpers
  • WAV, AIFF, and raw file readers and writers (WaveFileReader, WaveFileWriter, AiffFileReader, …)
  • Sample providers for mixing, panning, volume, fade in/out, offset/skip/take, mono↔stereo conversion
  • Resampling (WdlResamplingSampleProvider) and pitch shifting (SmbPitchShiftingSampleProvider)
  • Signal generators, envelope generators, a BiQuad filter, and an FFT
  • G.711 (µ-law / a-law) codecs

When to use it

Reference NAudio.Core directly when you want to read, write, or manipulate audio on non-Windows targets, or when you are assembling your own combination of platform packages (NAudio.Wasapi, NAudio.WinMM, NAudio.Asio, …) and don't want the full NAudio meta-package.

See the NAudio documentation site for tutorials and the full API reference, or the GitHub repository for full documentation.

License

MIT.

Showing the top 20 packages that depend on NAudio.Core.

Packages Downloads
NAudio.Midi
Cross-platform MIDI file reading and writing, MIDI message types, and SMPTE timing for the NAudio audio library.
 26
NAudio.Midi
Package Description
 24
NAudio.Asio
ASIO driver support for the NAudio audio library — low-latency multichannel playback and capture via ASIO SDK.
 24
NAudio
NAudio, an audio library for .NET
 23
NAudio.Asio
ASIO driver support for the NAudio audio library — low-latency multichannel playback and capture via ASIO SDK.
 23
NAudio.Dmo
Package Description
 23
NAudio.Asio
Package Description
 23
NAudio.Dmo
DirectX Media Objects (echo, chorus, reverb, MP3 decoder, resampler) and DirectSound output for the NAudio audio library.
 23
NAudio.Wasapi
Package Description
 22
NAudio.WinMM
Package Description
 22
NAudio.Midi
Package Description
 22
NAudio.Asio
Package Description
 22
NAudio.Asio
ASIO driver support for the NAudio audio library — low-latency multichannel playback and capture via ASIO SDK.
 22
NAudio.Midi
Cross-platform MIDI file reading and writing, MIDI message types, and SMPTE timing for the NAudio audio library.
 22
NAudio.WinMM
Package Description
 21

  • Deprecated legacy APIs that have modern replacements: Wave16ToFloatProvider, WaveFloatTo16Provider and Wave32To16Stream (use ToSampleProvider() / ToWaveProvider16()), IgnoreDisposeStream (no longer needed), ByteArrayExtensions (use the BCL), MidiMessage (use the typed MIDI events), ResamplerDmoStream/DmoResampler (use MediaFoundationResampler or WdlResamplingSampleProvider), DmoEffectWaveProvider and the Dmo* effects (use NAudio.Effects), AsioOut's recording path (use AsioDevice), WaveFilter, and ProgressLog. Added AsioOut.IsSupported() and deprecated the lowercase isSupported()
  • Deprecated WaveFileReader.ReadNextSampleFrame in favour of ToSampleProvider(), which supports more formats and doesn't allocate an array per sample frame
  • Fixed WaveFileWriter.WriteSample and WriteSamples(short[]) throwing for plain (non-extensible) 32-bit integer PCM formats
  • WaveFileReader.ReadNextSampleFrame now throws InvalidDataException for a WAV header with an invalid channel count or bit depth
  • Reduced allocations when reading and writing WAV files, added ReadOnlySpan<byte> overloads of WaveFileWriter.AddChunk and ChunkIdentifier.ChunkIdentifierToInt32, and fixed WaveChunks.GetData leaving the stream position changed when a read fails. ChunkIdentifierToInt32 now throws ArgumentOutOfRangeException for identifiers that aren't four bytes (#1457)
  • Changed the WaveStream.CurrentTime setter to clamp to the bounds of the stream, and corrected the XML documentation for the core audio interfaces (#1441)
  • Fixed DirectSoundOut failing every playback with DirectSoundException 0x80004001 (or an ArgumentException for a format with extra data, e.g. one read from a WAV by WaveFileReader): the secondary buffer's WAVEFORMATEX was still a GCHandle-pinned WaveFormat instance — a site missed in the #1432 marshalling conversion, since WaveFormat no longer carries [StructLayout] — and now marshals via WaveFormat.MarshalToPtr
  • Fixed WasapiPlayer and WasapiOut being stranded in the Playing state, unable to play again, when the source's Read threw or the source ended before the first buffer was filled (#1442)
  • macOS support (preview) - A new wrappers library is added wrapping macOS native API's for playback/recording, reading/writing files and resampling audio. The NAudio.MacOS package ships pre-release only (X.Y.Z-preview.N) while its API settles, so it stays pre-release alongside stable releases of the other packages. Special thanks to @mdcdi1315 (#1325) for the work and the tests. For more information, see the design doc that describes the decisions that helped shape the wrappers. (#1398)
  • Reworked the macOS CoreAudioPlayer and CoreAudioRecorder non-interleaved path, used for devices that expose one mono stream per channel; the recorder now also drains buffered audio when stopped, and non-interleaved streams carrying more than one channel are rejected explicitly (preview) (#1461)
  • ExtendedAudioFileServicesReader.CurrentTime and TotalTime on macOS now throw ObjectDisposedException after the reader is disposed, rather than a native exception (preview) (#1451)
  • VB.NET support - Added SampleProviderBase and WaveProviderBase, base classes that keep the NAudio 2 Read(buffer, offset, count) signature for languages that cannot name a Span<T> in a method signature, and a Using NAudio from VB.NET guide covering playback, recording and custom providers from VB (#1426)
  • Refreshed the NuGet package icon, now rendered from the new SVG version of the NAudio logo as a sharper, square 256×256 PNG (#1467)

.NET 9.0

Version Downloads Last updated
3.3.0-preview.1 2 10/18/2026
3.2.0 2 10/16/2026
3.2.0-preview.1 4 10/14/2026
3.1.1-preview.2 8 09/23/2026
3.1.1-preview.1 13 09/10/2026
3.1.0 10 09/10/2026
3.1.0-preview.2 16 09/07/2026
3.1.0-preview.1 10 09/06/2026
3.0.2-preview.2 13 08/30/2026
3.0.2-preview.1 15 08/20/2026
3.0.1 15 08/19/2026
3.0.1-preview.1 13 08/19/2026
3.0.0 13 08/16/2026
3.0.0-preview.20 15 08/10/2026
3.0.0-preview.19 18 07/25/2026
3.0.0-preview.18 16 07/22/2026
3.0.0-preview.17 17 07/22/2026
3.0.0-preview.16 18 07/03/2026
3.0.0-preview.15 7 09/09/2026
3.0.0-preview.14 5 09/18/2026
3.0.0-preview.10 4 09/18/2026
3.0.0-preview.9 6 09/21/2026
3.0.0-preview.8 3 09/25/2026
3.0.0-preview.7 2 09/08/2026
3.0.0-preview.6 1 10/02/2026
3.0.0-preview.5 2 09/25/2026
3.0.0-preview.4 1 10/09/2026
3.0.0-preview.3 5 09/18/2026
3.0.0-preview.2 1 09/25/2026
2.4.0 14 08/26/2026
2.3.0 21 05/30/2026
2.2.1 18 05/30/2026
2.2.0 19 05/30/2026
2.1.0 17 05/30/2026
2.1.0-beta.1 18 05/30/2026
2.0.0 20 05/30/2026
2.0.0-beta2 18 05/30/2026
2.0.0-beta1 17 05/30/2026