NAudio.WinForms 3.2.0-preview.1
NAudio.WinForms
Windows Forms controls for NAudio. Windows-only (net9.0-windows, UseWindowsForms=true).
What's included
A handful of reusable GUI controls useful when building audio apps with WinForms:
Fader— vertical channel faderVolumeSlider— horizontal volume sliderPanSlider— pan controlPot— rotary knobWaveViewer— render aWaveStreamas a waveformProgressLog— progress/log text control (obsolete as of 3.2; use aRichTextBox)
When to use it
Install this package only if you are building a Windows Forms application and want ready-made audio controls. For WPF apps, use the NAudioWpfDemo project in the NAudio source tree as a reference and roll your own controls — there is no NAudio.Wpf package.
See the NAudio documentation site for tutorials and the full API reference, or the GitHub repository for full documentation and demos.
License
MIT.
Showing the top 20 packages that depend on NAudio.WinForms.
* 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](Docs/Architecture/MacOSWrappersDesign.md) 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](Docs/UsingNAudioFromVB.md) 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
- NAudio.WinMM (>= 3.2.0-preview.1)
| Version | Downloads | Last updated |
|---|---|---|
| 3.4.0-preview.1 | 2 | 11/14/2026 |
| 3.3.0 | 3 | 10/21/2026 |
| 3.3.0-preview.1 | 3 | 10/21/2026 |
| 3.2.0 | 2 | 10/21/2026 |
| 3.2.0-preview.1 | 3 | 10/21/2026 |
| 3.1.1-preview.2 | 4 | 09/30/2026 |
| 3.1.1-preview.1 | 5 | 09/15/2026 |
| 3.1.0 | 6 | 09/15/2026 |
| 3.1.0-preview.2 | 6 | 09/15/2026 |
| 3.1.0-preview.1 | 6 | 09/15/2026 |
| 3.0.2-preview.2 | 6 | 09/15/2026 |
| 3.0.2-preview.1 | 6 | 09/15/2026 |
| 3.0.1 | 6 | 09/15/2026 |
| 3.0.1-preview.1 | 6 | 09/15/2026 |
| 3.0.0 | 6 | 09/15/2026 |
| 3.0.0-preview.20 | 6 | 09/15/2026 |
| 3.0.0-preview.19 | 6 | 09/15/2026 |
| 3.0.0-preview.18 | 6 | 09/15/2026 |
| 3.0.0-preview.17 | 5 | 09/15/2026 |
| 3.0.0-preview.16 | 6 | 09/15/2026 |
| 3.0.0-preview.15 | 6 | 09/15/2026 |
| 3.0.0-preview.14 | 6 | 09/15/2026 |
| 3.0.0-preview.10 | 6 | 09/15/2026 |
| 3.0.0-preview.9 | 6 | 09/15/2026 |
| 3.0.0-preview.8 | 6 | 09/15/2026 |
| 3.0.0-preview.7 | 6 | 09/15/2026 |
| 3.0.0-preview.6 | 6 | 09/15/2026 |
| 3.0.0-preview.5 | 6 | 09/15/2026 |
| 3.0.0-preview.4 | 6 | 09/15/2026 |
| 3.0.0-preview.3 | 6 | 09/15/2026 |
| 3.0.0-preview.2 | 6 | 09/15/2026 |
| 2.4.0 | 6 | 09/15/2026 |
| 2.3.0 | 6 | 09/15/2026 |
| 2.2.1 | 6 | 09/15/2026 |
| 2.2.0 | 6 | 09/15/2026 |
| 2.1.0 | 5 | 09/15/2026 |
| 2.1.0-beta.1 | 6 | 09/15/2026 |
| 2.0.1 | 6 | 09/15/2026 |
| 2.0.0 | 6 | 09/15/2026 |
| 2.0.0-beta2 | 6 | 09/15/2026 |
| 2.0.0-beta1 | 6 | 09/15/2026 |