NAudio.WinForms 3.0.1

Prefix Reserved

There is a newer prerelease version of this package available.
See the version list below for details.

dotnet add package NAudio.WinForms --version 3.0.1

NuGet\Install-Package NAudio.WinForms -Version 3.0.1

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="NAudio.WinForms" Version="3.0.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="NAudio.WinForms" Version="3.0.1" />
                    

                            Directory.Packages.props

<PackageReference Include="NAudio.WinForms" />
                    

                            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 NAudio.WinForms --version 3.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: NAudio.WinForms, 3.0.1"

#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 NAudio.WinForms@3.0.1

#: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=NAudio.WinForms&version=3.0.1
                    

                            Install as a Cake Addin

#tool nuget:?package=NAudio.WinForms&version=3.0.1
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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 fader
VolumeSlider — horizontal volume slider
PanSlider — pan control
Pot — rotary knob
WaveViewer — render a WaveStream as a waveform
ProgressLog — progress/log text control

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.

Product	Compatible and additional computed target framework versions.
.NET	net9.0-windows7.0 is compatible. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net9.0-windows7.0
- NAudio.WinMM (>= 3.0.1)

NuGet packages (8)

Showing the top 5 NuGet packages that depend on NAudio.WinForms:

Package	Downloads
NAudio NAudio is an open source .NET audio library — playback and recording, file readers and writers, MIDI, DSP and effects, with platform-specific backends auto-selected by target framework.	13.1M
MicroServices Micro Services Essential Pack	143.8K
InceptionMicroServices Micro Services Essential Pack	6.5K
Oakrey.Audio A Windows .NET library built on NAudio for audio recording, playback, synthesis, and signal analysis. Includes STFT/FFT pipelines, segmented SNR and log-likelihood-ratio audio comparators, signal generators, and reactive recording via IObservable.	1.5K
NetExtender.NAudio.Windows NAudio Windows module of NetExtender Framework	1.3K

GitHub repositories (32)

Showing the top 20 popular GitHub repositories that depend on NAudio.WinForms:

Repository	Stars
Azure-Samples/cognitive-services-speech-sdk Sample code for the Microsoft Cognitive Services Speech SDK	3.4K
moom825/xeno-rat Xeno-RAT is an open-source remote access tool (RAT) developed in C#, providing a comprehensive set of features for remote system management. Has features such as HVNC, live microphone, reverse proxy, and much much more!	1.6K
CXWorld/CapFrameX Frametime capture and analysis tool	1.3K
mukunku/ParquetViewer Simple Windows desktop application for viewing & querying Apache Parquet files	1.2K
lastbattle/Harepacker-resurrected All in one .wz file/map editor for MapleStory game files	640
akon47/ScreenRecorder ⏺️ A simple recording program with the ability to record screens and audio on your computer.	549
malaybaku/VMagicMirror VRM Software for Windows to move avatar with minimal devices.	541
Kinovea/Kinovea Video solution for sport analysis. Capture, inspect, compare, annotate and measure technical performances.	490
rampaa/JL JL is a program for looking up Japanese words and expressions.	397
octgn/OCTGN Online Card and Tabletop Gaming Network	379
mhwlng/streamdeck-elite Elgato Stream Deck plugin for Elite Dangerous	320
RoosterDragon/Desktop-Ponies Desktop Ponies in .NET [The Original!]	263
stuff-by-3-random-dudes/UWUVCI-AIO-WPF	255
mir-ethernity/mir-eternal	254
mhwlng/streamdeck-starcitizen Elgato Stream Deck button plugin for Star Citizen	234
FredTungsten/ScriptPlayer ScriptPlayer is a video player that controls the Handy and lots of other toys in sync with videos.	223
iss4cf0ng/DuplexSpyCS An open-source, C#-based remote administration tool (RAT), enabling complete control of a remote Windows machine, designed for legitimate remote administration and security testing of Windows systems.	218
kuma4649/MDPlayer	185
MarshmallowAndroid/UmamusumeExplorer Utility for viewing certain assets from ウマ娘プリティーダービー (Umamusume: Pretty Derby).	184
tgraupmann/WinForm_Ollama_Copilot Ollama AI front-end using Windows Forms as a Copilot Application	165

Version	Downloads	Last Updated
3.0.2-preview.1	0	8/20/2026
3.0.1	887	8/18/2026
3.0.1-preview.1	66	8/17/2026
3.0.0	742	8/15/2026
3.0.0-preview.20	253	8/8/2026
3.0.0-preview.19	216	7/25/2026
3.0.0-preview.18	236	7/16/2026
3.0.0-preview.17	118	7/11/2026
3.0.0-preview.16	274	7/1/2026
3.0.0-preview.15	130	6/28/2026
3.0.0-preview.14	104	6/25/2026
3.0.0-preview.10	228	6/8/2026
3.0.0-preview.9	141	5/27/2026
3.0.0-preview.8	124	5/22/2026
3.0.0-preview.7	91	5/21/2026
3.0.0-preview.6	85	5/21/2026
3.0.0-preview.5	140	5/11/2026
3.0.0-preview.4	79	5/11/2026
3.0.0-preview.3	79	5/11/2026
3.0.0-preview.2	102	5/10/2026

A patch release. The headline fix is packaging: the `NAudio` and `NAudio.Extras`
meta-packages now ship a plain `net9.0-windows` leg, so WinForms and WPF projects
targeting `netX.0-windows` get the full Windows stack again.

* **Breaking:** `AudioFileReader` now throws `NotSupportedException` instead of `InvalidOperationException` when the cross-platform build is asked for a format it cannot read, and the messages simply state that rather than suggesting an `NAudio.Wasapi` install that could never have helped (#1407)
* Fixed the `NAudio` and `NAudio.Extras` meta-packages resolving their portable `net9.0` asset on projects targeting a plain `netX.0-windows` TFM (the WinForms/WPF template default), which silently dropped the entire Windows stack — no `WaveOut`, WASAPI, Media Foundation, ASIO, DMO or WinForms types, and `AudioFileReader` throwing "MP3 file reading requires the NAudio.Wasapi package". Both packages now also ship a plain `net9.0-windows` leg (#1407)
* Projects on a plain `netX.0-windows` TFM may now see `CA1416` warnings when calling WASAPI process-loopback capture. The warning is correct — those callers do need an `OperatingSystem.IsWindowsVersionAtLeast(10, 0, 19041)` guard — and was previously hidden because the only Windows asset available already implied that floor (#1407)
* Sample and tool apps now roll forward onto newer .NET runtimes, so running them no longer requires the .NET 9 runtime to be installed (#1408)
* Fixed `AiffFileReader` reporting too long a `Length` and throwing `IndexOutOfRangeException` when the SSND chunk declares a non-zero offset (#1405)
* Fixed `AiffFileReader.Read` throwing `IndexOutOfRangeException` when the source stream returns fewer bytes than requested (#1405)