NAudio.Midi 3.1.0-preview.1

NAudio.Midi

Nuget

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

  • MidiFile for reading Standard MIDI Files (SMF)
  • MidiEventCollection and MidiEvent hierarchy (NoteEvent, NoteOnEvent, ControlChangeEvent, PatchChangeEvent, TempoEvent, TimeSignatureEvent, MetaEvent, SysexEvent, …)
  • MidiFileWriter helpers to produce MIDI files from a MidiEventCollection
  • Enumerations for General MIDI patches, drum notes, controller numbers, etc.
  • Windows only: WinRTMidiIn / WinRTMidiOut — live MIDI input and output backed by the WinRT Windows.Devices.Midi API (present only in the net9.0-windows build; the cross-platform net9.0 build 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.

Showing the top 20 packages that depend on NAudio.Midi.

Packages Downloads
NAudio
NAudio, an audio library for .NET
 21
NAudio
NAudio, an audio library for .NET
 19
NAudio
NAudio, an audio library for .NET
 18
NAudio
NAudio, an audio library for .NET
 17
NAudio
NAudio, an audio library for .NET
 15
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.
 15
NAudio.WinMM
winmm.dll-based Windows audio APIs (WaveOut, WaveIn, MidiIn, MidiOut, ACM) for the NAudio audio library.
 15
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
NAudio.WinMM
winmm.dll-based Windows audio APIs (WaveOut, WaveIn, MidiIn, MidiOut, ACM) for the NAudio audio library.
 12
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.
 12
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.
 11
NAudio.Wasapi
WASAPI playback and capture (including loopback and process loopback) and WinRT MIDI for the NAudio audio library.
 11
NAudio.WinMM
winmm.dll-based Windows audio APIs (WaveOut, WaveIn, MidiIn, MidiOut, ACM) 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

.NET 9.0

Version Downloads Last updated
3.1.1-preview.2 1 09/22/2026
3.1.1-preview.1 4 09/10/2026
3.1.0 4 09/09/2026
3.1.0-preview.2 4 09/05/2026
3.1.0-preview.1 6 09/04/2026
3.0.2-preview.2 9 08/31/2026
3.0.2-preview.1 8 08/20/2026
3.0.1 9 08/18/2026
3.0.1-preview.1 6 08/18/2026
3.0.0 10 08/16/2026
3.0.0-preview.20 10 08/10/2026
3.0.0-preview.19 13 07/28/2026
3.0.0-preview.18 14 07/16/2026
3.0.0-preview.17 13 07/16/2026
3.0.0-preview.16 17 07/01/2026
3.0.0-preview.15 17 07/01/2026
3.0.0-preview.14 14 06/26/2026
3.0.0-preview.10 16 06/12/2026
3.0.0-preview.9 24 05/30/2026
3.0.0-preview.8 17 05/30/2026
3.0.0-preview.7 20 05/30/2026
3.0.0-preview.6 12 05/30/2026
3.0.0-preview.5 18 05/30/2026
3.0.0-preview.4 18 05/30/2026
3.0.0-preview.3 16 05/30/2026
3.0.0-preview.2 21 05/30/2026
2.4.0 10 09/01/2026
2.3.0 17 05/30/2026
2.2.1 14 05/30/2026
2.2.0 18 05/30/2026
2.1.0 17 05/30/2026
2.1.0-beta.1 18 05/30/2026
2.0.1 19 05/30/2026
2.0.0 19 05/30/2026
2.0.0-beta2 17 05/30/2026
2.0.0-beta1 19 05/30/2026