NAudio.Core 3.1.0-preview.1
NAudio.Core
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,ISampleProviderand associated base classesWaveFormatand 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.Wasapi
Package Description
|
34 |
|
NAudio.Wasapi
Package Description
|
31 |
|
Lib.AudioMonitor
Package Description
|
28 |
|
Lib.AudioMonitor
Package Description
|
24 |
|
Lib.AudioMonitor
Package Description
|
21 |
|
NAudio.Wasapi
Package Description
|
17 |
|
NAudio.Wasapi
Package Description
|
11 |
|
NAudio.Midi
Package Description
|
11 |
|
NAudio.Wasapi
WASAPI playback and capture (including loopback and process loopback) and WinRT MIDI for the NAudio audio library.
|
11 |
* Fixed two infinite loops in the WAV parser triggered by corrupt files declaring a negative chunk size. An RF64 `ds64` chunk with a negative `dataChunkLength`, or a `LIST/adtl` sub-chunk with a negative size, made the chunk walk advance by zero bytes per iteration and spin at 100% CPU without throwing. Negative and oversized sizes are now rejected where they are read, and an undersized `ds64` chunk throws `FormatException` rather than `ArgumentOutOfRangeException` (#1428)
* Fixed `WaveIn`/`WaveOut` failing under Native AOT with `WaveHeaderUnprepared` ("The wave header was not prepared"). The `WAVEHDR` was a `[StructLayout]` class passed to winmm by value, which CoreCLR pins in place but NativeAOT copies into a per-call temporary, so the driver's `WHDR_PREPARED`/`WHDR_DONE`/`dwBytesRecorded` writes were discarded. It is now a struct in a stable unmanaged block (#1425)
* Fixed `WaveFormat.MarshalToPtr` and `WaveFormat.MarshalFromPtr` corrupting any `WaveFormat` subclass under Native AOT — the AOT marshaller drops the inherited `WAVEFORMATEX` fields of a class hierarchy, so a `WaveFormatExtensible` was written with its SubFormat GUID over the sample rate. Every remaining site that sized or wrote a `WaveFormat` with `Marshal.SizeOf`/`StructureToPtr` was converted too: WASAPI (`AudioClient`), Media Foundation (`MFInitMediaTypeFromWaveFormatEx`, reachable from `MediaFoundationResampler`/`MediaFoundationEncoder`), DMO (`DmoMediaType.SetWaveFormat`, `MediaObject`) and ACM (`AcmStream`, `AcmDriver`) (#1425)
* Added `WaveFormat.ToWaveFormatExBytes()`, which renders a `WaveFormat` as a native WAVEFORMATEX byte array. `MarshalToPtr` is now a thin wrapper over it, for callers who need an unmanaged block rather than a buffer they already own (#1425)
* `WaveFormat.MarshalToPtr` now always allocates at least the `18 + cbSize` bytes it advertises. A `WaveFormat` subclass that declares `extraSize` but doesn't write it in `Serialize` previously produced a block shorter than its own `cbSize`, which a native consumer would read past (#1425)
* **Breaking:** `AudioClient.IsFormatSupported` and `WasapiPlayer.IsFormatSupported` now return the closest-match format as `out WaveFormat` rather than `out WaveFormatExtensible`. WASAPI documents this format as either a `WAVEFORMATEX` or a `WAVEFORMATEXTENSIBLE`, and the old signature could only represent the latter — a plain format was previously decoded as a `WaveFormatExtensible` whose base fields were valid but whose extensible fields were meaningless. Callers needing the extensible fields should pattern-match (#1425)
* Added a `Serialize` override to `Mp3WaveFormat`, which previously advertised `cbSize` = 12 but wrote none of its 12 MPEGLAYER3WAVEFORMAT extra bytes (#1425)
* `NAudio.WinMM` is now marked `IsAotCompatible`, and the AOT smoke test covers the winmm WAVEHDR/WAVEFORMATEX paths (#1425)
* Fixed `Mp3FileReaderBase` seeking silently restarting playback from the beginning of the file on MP3s with a Xing/Info header — the lazy frame index was gated on `IsLengthExact`, which such a header sets without any frame having been scanned. Also fixed seeks landing on the wrong frame when the target fell exactly on a frame boundary, and Xing/Info header frames being indexed as audio (shifting every seek in those files ~26 ms early). A 3.0.0 regression (#1419)
* Fixed `WdlResamplingSampleProvider` losing samples, and eventually returning 0 permanently, when asked for more output than the source could supply — a 3.0.0 regression that broke the common pattern of reading generously from a `BufferedWaveProvider`-backed capture chain. `WdlResampler.ResampleOut` also no longer drifts in input-driven (feed) mode when handed fewer samples than `ResamplePrepare` requested (#1412)
.NET 9.0
- System.Numerics.Tensors (>= 9.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 3.1.1-preview.2 | 1 | 09/28/2026 |
| 3.1.1-preview.1 | 1 | 09/09/2026 |
| 3.1.0 | 1 | 09/09/2026 |
| 3.1.0-preview.2 | 1 | 09/09/2026 |
| 3.1.0-preview.1 | 1 | 09/09/2026 |
| 3.0.2-preview.2 | 2 | 08/29/2026 |
| 3.0.2-preview.1 | 3 | 08/21/2026 |
| 3.0.1 | 3 | 08/21/2026 |
| 3.0.1-preview.1 | 3 | 08/21/2026 |
| 3.0.0 | 3 | 08/21/2026 |
| 3.0.0-preview.20 | 3 | 08/10/2026 |
| 3.0.0-preview.19 | 4 | 07/30/2026 |
| 3.0.0-preview.18 | 7 | 07/18/2026 |
| 3.0.0-preview.17 | 7 | 07/12/2026 |
| 3.0.0-preview.16 | 7 | 07/03/2026 |
| 3.0.0-preview.15 | 7 | 07/03/2026 |
| 3.0.0-preview.14 | 7 | 06/27/2026 |
| 3.0.0-preview.10 | 9 | 06/12/2026 |
| 3.0.0-preview.9 | 9 | 05/29/2026 |
| 3.0.0-preview.8 | 8 | 05/26/2026 |
| 3.0.0-preview.7 | 10 | 05/26/2026 |
| 3.0.0-preview.6 | 10 | 05/26/2026 |
| 3.0.0-preview.5 | 8 | 05/17/2026 |
| 3.0.0-preview.4 | 7 | 05/17/2026 |
| 3.0.0-preview.3 | 7 | 05/17/2026 |
| 3.0.0-preview.2 | 7 | 05/17/2026 |
| 2.4.0 | 2 | 08/29/2026 |
| 2.3.0 | 16 | 03/13/2026 |
| 2.2.1 | 35 | 02/19/2025 |
| 2.2.0 | 31 | 02/19/2025 |
| 2.1.0 | 31 | 02/19/2025 |
| 2.1.0-beta.1 | 31 | 02/19/2025 |
| 2.0.0 | 31 | 02/19/2025 |
| 2.0.0-beta2 | 28 | 02/19/2025 |
| 2.0.0-beta1 | 31 | 02/19/2025 |