NAudio.Core 3.3.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

  • Fixed WasapiRecorder not able to re-start after successfully stopping the recorder. (#1479)
  • Nullable reference types in NAudio.Core - NAudio.Core is now compiled with nullable reference types enabled, so its public API carries nullability annotations (e.g. WaveFileReader.ReadNextSampleFrame and Mp3Frame.LoadFromStream return nullable types, and Mp3Frame.RawData is byte[]? when a frame is read without its data). This is a source-level change only: there are no binary breaks, but projects with nullable enabled may see new warnings, and overrides of NAudio.Core virtual members may need matching annotations. XingHeader.LoadXingHeader now returns null for a frame read without its data instead of throwing. Thanks to @Seb-stian (#1452)
  • Nullable reference types in NAudio.Midi - NAudio.Midi is now also compiled with nullable reference types enabled (e.g. MidiInMessageEventArgs.MidiEvent and NoteOnEvent.OffEvent are nullable). Source-level change only; projects with nullable enabled may see new warnings. MidiEvent.ReadNextEvent now throws FormatException instead of NullReferenceException for running status with no previous event, and RawMetaEvent treats null data as empty (#825)
  • Nullable reference types in NAudio.WinMM - NAudio.WinMM is now compiled with nullable reference types enabled (e.g. AcmDriver.FindByShortName and WaveCapabilitiesHelpers.GetNameFromGuid return nullable types, and AcmDriver.ShowFormatChooseDialog has nullable out parameters). Source-level change only; projects with nullable enabled may see new warnings. WaveOut.OutputWaveFormat before Init now throws InvalidOperationException, AcmStream members throw ObjectDisposedException after dispose, and GetNameFromGuid returns null instead of throwing when the registry key is missing, where each previously threw NullReferenceException (#825)
  • Nullable reference types in NAudio.SoundFile and NAudio.Sampler - both packages are now compiled with nullable reference types enabled (e.g. the SoundFileTags fields, SoundFileWriterOptions.Tags and SoundFileException.Function are nullable, and the TryLoad methods on WaveSampleLoader / ISfzSampleLoader mark left as non-null on success and right as null for mono). Source-level change only; projects with nullable enabled may see new warnings, and custom ISfzSampleLoader implementations may need matching annotations (#825)
  • NAudio.WinMM, NAudio.Asio, NAudio.Dmo and NAudio.Vst3 now target plain net9.0 instead of net9.0-windows, matching NAudio.Wasapi. They remain Windows-only, enforced by [SupportedOSPlatform("windows")], but can now be referenced directly from a plain netX.0 project (calls show CA1416 warnings unless guarded or the project is marked Windows-only) and built on Linux/macOS without EnableWindowsTargeting. No change for projects targeting netX.0-windows (#1482)
  • Breaking: the NAudio meta-package is now a single net9.0 package that pulls in NAudio.Core, NAudio.Midi, NAudio.WinMM and NAudio.Wasapi on every target framework. A plain netX.0 project on Windows (e.g. a console app on net10.0) now gets Mp3FileReader, WaveOut, WasapiPlayer and an AudioFileReader that reads MP3, where previously it silently got a cross-platform subset that threw NotSupportedException (#1472). It no longer includes NAudio.Asio, NAudio.Dmo or NAudio.WinForms: add those packages if you use AsioOut/AsioDevice, DirectSoundOut or the DMO effects, or WaveOutWindow/WaveInWindow/the NAudio.Gui controls. AudioFileReader now chooses its Media Foundation/ACM paths at runtime, and off Windows its NotSupportedException messages point to NAudio.SoundFile. NAudio.Extras is now single-target net9.0, with AudioPlaybackEngine marked Windows-only (#1485)
  • Nullable reference types in NAudio.WinForms, NAudio.Alsa and NAudio.Extras - these packages are now compiled with nullable reference types enabled (e.g. WaveViewer.WaveStream, AlsaException.Function and the control/device events are nullable). Source-level change only; projects with nullable enabled may see new warnings. AlsaOut.OutputWaveFormat and WaveOutWindow.OutputWaveFormat now throw InvalidOperationException before Init (previously null and NullReferenceException respectively), and WaveOutWindow.Play before Init throws InvalidOperationException instead of NullReferenceException (#825)
  • Nullable reference types in NAudio.Asio - NAudio.Asio is now compiled with nullable reference types enabled (e.g. the optional AsioPlaybackOptions.OutputChannels / AsioDuplexOptions.InputChannels, the AsioDevice/AsioOut events and the AsioDriverExt callbacks are nullable; required option members such as Source and Processor stay non-nullable). Source-level change only; projects with nullable enabled may see new warnings. AsioOut members now throw ObjectDisposedException after Dispose and AsioOut.OutputWaveFormat throws InvalidOperationException when no playback source is initialised, where they previously threw NullReferenceException or returned null (#825)
  • Nullable reference types in NAudio.Dmo - NAudio.Dmo is now compiled with nullable reference types enabled (e.g. DirectSoundOut.PlaybackStopped and DirectSoundDeviceInfo.ModuleName are nullable). Source-level change only; projects with nullable enabled may see new warnings. DirectSoundOut.OutputWaveFormat now throws InvalidOperationException before Init instead of returning null, and the MediaObject wrappers, DmoResampler.MediaObject, WindowsMediaMp3Decoder.MediaObject and DmoOutputDataBuffer.MediaBuffer throw ObjectDisposedException after Dispose instead of returning null or throwing NullReferenceException (#825)
  • Nullable reference types in NAudio.Wasapi (CoreAudioApi and MediaFoundation) - the NAudio.CoreAudioApi and NAudio.MediaFoundation types are now annotated for nullable reference types (e.g. AudioClient.TryGetAcousticEchoCancellationControl, MMDeviceEnumerator.TryGetDefaultAudioEndpoint, MfSourceReader.ReadSample, PropertyStoreProperty.Value and Part.AudioVolumeLevel/AudioMute/JackDescription are nullable); WasapiOut, WasapiCapture and the other top-level classes follow in a separate change. Source-level change only; projects with nullable enabled may see new warnings. The CoreAudio and Media Foundation COM wrappers now throw ObjectDisposedException when used after Dispose instead of NullReferenceException, AudioSessionManager.Sessions throws InvalidOperationException instead of returning null when sessions are unavailable, and AudioSessionControl.AudioMeterInformation / SimpleAudioVolume throw NotSupportedException instead of returning null if the session does not expose those interfaces (#825)
  • Nullable reference types in NAudio.Wasapi (playback, capture and Media Foundation classes) - WasapiOut, WasapiCapture, WasapiPlayer, WasapiRecorder, their builders and MediaFoundationReader/StreamMediaFoundationReader/MediaFoundationEncoder are now annotated too, completing NAudio.Wasapi (e.g. WasapiPlayer/WasapiRecorder.DeviceId and DeviceFriendlyName, LowLatencyUnavailableReason, WasapiRecorder.AcousticEchoCancellationControl, WasapiPlayer.GetSupportedExclusiveFormat, MediaFoundationEncoder.SelectMediaType and the playback/recording events are nullable). Source-level change only; projects with nullable enabled may see new warnings. The WASAPI classes now throw ObjectDisposedException when used after Dispose, and report InvalidOperationException instead of NullReferenceException through PlaybackStopped when playback is started without Init (#825)
  • Nullable reference types in NAudio.MacOS - NAudio.MacOS is now compiled with nullable reference types enabled (e.g. AudioSystemObject.DefaultInputDevice/DefaultOutputDevice, the ConvertUIDToDevice-style lookups, AudioObject.Owner, AudioDevice.Icon, ExtendedAudioFileReaderSettings.OutputFormat, ExtendedAudioFileWriterSettings.FileType/ProvidingFormat and the player, recorder and property-listener events are nullable). Source-level change only; projects with nullable enabled may see new warnings. Object-list properties such as AudioSystemObject.Devices now skip unknown object IDs instead of returning null entries, the parameterless CoreAudioPlayer/CoreAudioRecorder constructors throw InvalidOperationException instead of ArgumentNullException when there is no default device, and ExtendedAudioFileWriter captures ProvidingFormat when created rather than re-reading the settings object on every write (#825)
  • Fixed several buffer and handle lifetime bugs in the winmm MIDI backend: MidiOut.SendBuffer no longer frees a sysex buffer while the driver may still own it, MidiIn now stops input before resetting it, and neither class calls into winmm with a handle it never opened. MidiOut.SendBuffer now blocks until the driver releases the buffer and throws MmException if the send fails.
  • Fixed MediaFoundationReader reporting a Position that was not a whole number of frames after seeking a compressed file (e.g. MP3 or AAC), up to a frame before the requested position, and a Length that could include a partial frame. Seeks now round down to a frame boundary and land exactly on it (#1488)

.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