NAudio.Midi
3.2.0
Prefix Reserved
See the version list below for details.
dotnet add package NAudio.Midi --version 3.2.0
NuGet\Install-Package NAudio.Midi -Version 3.2.0
<PackageReference Include="NAudio.Midi" Version="3.2.0" />
<PackageVersion Include="NAudio.Midi" Version="3.2.0" />
<PackageReference Include="NAudio.Midi" />
paket add NAudio.Midi --version 3.2.0
#r "nuget: NAudio.Midi, 3.2.0"
#:package NAudio.Midi@3.2.0
#addin nuget:?package=NAudio.Midi&version=3.2.0
#tool nuget:?package=NAudio.Midi&version=3.2.0
NAudio.Midi
MIDI support for NAudio. Dual-targets net9.0 (cross-platform: the MIDI event model and file reader/writer) and net9.0-windows10.0.19041.0 (adds WinRT live MIDI I/O on Windows).
What's included
MidiFilefor reading Standard MIDI Files (SMF)MidiEventCollectionandMidiEventhierarchy (NoteEvent,NoteOnEvent,ControlChangeEvent,PatchChangeEvent,TempoEvent,TimeSignatureEvent,MetaEvent,SysexEvent, …)MidiFileWriterhelpers to produce MIDI files from aMidiEventCollection- Enumerations for General MIDI patches, drum notes, controller numbers, etc.
- Windows only:
WinRTMidiIn/WinRTMidiOut— live MIDI input and output backed by the WinRTWindows.Devices.MidiAPI (present only in thenet9.0-windowsbuild; the cross-platformnet9.0build omits them)
What's not here
Sending or receiving live MIDI through the legacy winmm-backed MidiIn / MidiOut uses the Windows Multimedia API and lives in the NAudio.WinMM package. (The WinRT-backed WinRTMidiIn / WinRTMidiOut above are the modern alternative and ship here.)
See the NAudio documentation site for tutorials and the full API reference, or the GitHub repository for full documentation and tutorials on working with MIDI files and events.
License
MIT.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net9.0-windows10.0.19041 is compatible. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net9.0
- NAudio.Core (>= 3.2.0)
-
net9.0-windows10.0.19041
- NAudio.Core (>= 3.2.0)
NuGet packages (16)
Showing the top 5 NuGet packages that depend on NAudio.Midi:
| Package | Downloads |
|---|---|
|
NAudio
NAudio is an open source .NET audio library — playback and recording, file readers and writers, MIDI, DSP and effects, plus the core Windows audio backends (WASAPI, Media Foundation and WinMM). ASIO, DMO/DirectSound and WinForms support are separate packages. |
|
|
NAudio.WinMM
winmm.dll-based Windows audio APIs (WaveOut, WaveIn, MidiIn, MidiOut, ACM) for the NAudio audio library. |
|
|
MicroServices
Micro Services Essential Pack |
|
|
MappingTools.Core
osu! mapping utility library built for Mapping Tools. |
|
|
MultiAPI_Lib
MultiAPI - Это библиотека и сборка разного ПО (Далее "Библиотека") для разработчиков. Работает на .NET 8. Она содержит множество функций чтобы ускорить разработку ПО. MultiAPI подойдёт как начинающим разработчикам, так и профессиональным разработчикам ПО. |
GitHub repositories (27)
Showing the top 20 popular GitHub repositories that depend on NAudio.Midi:
| Repository | Stars |
|---|---|
|
tixl3d/tixl
TiXL is an open source software to create realtime motion graphics.
|
|
|
Azure-Samples/cognitive-services-speech-sdk
Sample code for the Microsoft Cognitive Services Speech SDK
|
|
|
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!
|
|
|
CXWorld/CapFrameX
Frametime capture and analysis tool
|
|
|
lastbattle/Harepacker-resurrected
All in one .wz file/map editor for MapleStory game files
|
|
|
akon47/ScreenRecorder
⏺️ A simple recording program with the ability to record screens and audio on your computer.
|
|
|
malaybaku/VMagicMirror
VRM Software for Windows to move avatar with minimal devices.
|
|
|
octgn/OCTGN
Online Card and Tabletop Gaming Network
|
|
|
mhwlng/streamdeck-elite
Elgato Stream Deck plugin for Elite Dangerous
|
|
|
RoosterDragon/Desktop-Ponies
Desktop Ponies in .NET [The Original!]
|
|
|
stuff-by-3-random-dudes/UWUVCI-AIO-WPF
|
|
|
mir-ethernity/mir-eternal
|
|
|
mhwlng/streamdeck-starcitizen
Elgato Stream Deck button plugin for Star Citizen
|
|
|
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.
|
|
|
FredTungsten/ScriptPlayer
ScriptPlayer is a video player that controls the Handy and lots of other toys in sync with videos.
|
|
|
kuma4649/MDPlayer
|
|
|
tgraupmann/WinForm_Ollama_Copilot
Ollama AI front-end using Windows Forms as a Copilot Application
|
|
|
Doublevil/Houhou-SRS
Japanese dictionary and SRS self-learning application for Windows.
|
|
|
nanami5270/GARbro-Mod
Fork of morkt/GARbro
|
|
|
elgarf/vMixUTC
Customizable controller for vMix
|
| Version | Downloads | Last Updated |
|---|---|---|
| 3.4.0-preview.1 | 408 | 10/24/2026 |
| 3.3.0 | 112,177 | 10/19/2026 |
| 3.3.0-preview.1 | 146 | 10/17/2026 |
| 3.2.0 | 14,659 | 10/15/2026 |
| 3.2.0-preview.1 | 128 | 10/13/2026 |
| 3.1.1-preview.2 | 451 | 9/21/2026 |
| 3.1.1-preview.1 | 564 | 9/8/2026 |
| 3.1.0 | 129,190 | 9/7/2026 |
| 3.1.0-preview.2 | 147 | 9/5/2026 |
| 3.1.0-preview.1 | 144 | 9/4/2026 |
| 3.0.2-preview.2 | 219 | 8/27/2026 |
| 3.0.2-preview.1 | 295 | 8/20/2026 |
| 3.0.1 | 144,005 | 8/18/2026 |
| 3.0.1-preview.1 | 160 | 8/17/2026 |
| 3.0.0 | 13,894 | 8/15/2026 |
| 3.0.0-preview.20 | 737 | 8/8/2026 |
| 3.0.0-preview.19 | 1,161 | 7/25/2026 |
| 3.0.0-preview.18 | 2,089 | 7/16/2026 |
| 3.0.0-preview.17 | 218 | 7/11/2026 |
| 2.4.0 | 78,674 | 8/26/2026 |
A feature and tidy-up release. Its headline is a first preview of macOS
support: the new `NAudio.MacOS` package wraps Core Audio for playback and
recording, Extended Audio File Services for reading and writing compressed
formats, and AudioConverter for resampling. It ships pre-release only while its
API settles, alongside the stable versions of the other packages. VB.NET users
also get base classes and a guide that keep the NAudio 2 array-based `Read`
signature.
Several legacy APIs that have modern replacements are now `[Obsolete]`, to be
removed in the next major version. The
fixes include `DirectSoundOut`, which failed every playback in 3.1.0, and
`WasapiPlayer`/`WasapiOut` getting stuck in the `Playing` state after a source
error.
* **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)
* **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)
* 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()` (#1466)
* Deprecated `WaveFileReader.ReadNextSampleFrame` in favour of `ToSampleProvider()`, which supports more formats and doesn't allocate an array per sample frame (#1465)
* 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)
* 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` (#1456)
* 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)
* Fixed `WaveFileWriter.WriteSample` and `WriteSamples(short[])` throwing for plain (non-extensible) 32-bit integer PCM formats (#1463)
* `WaveFileReader.ReadNextSampleFrame` now throws `InvalidDataException` for a WAV header with an invalid channel count or bit depth (#1464)
* Changed the `WaveStream.CurrentTime` setter to clamp to the bounds of the stream, and corrected the XML documentation for the core audio interfaces (#1441)
* 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)
* Refreshed the NuGet package icon, now rendered from the new SVG version of the NAudio logo as a sharper, square 256×256 PNG (#1467)
* Fixed the Help and About links in the AudioFileInspector, MidiFileConverter and MixDiff sample apps, which threw on .NET 9 instead of opening the help page or browser, and pointed the links and help pages at GitHub rather than CodePlex (#1469)