Repository navigation
In-box Preview 14
Pre-releaseThis preview is open to all customers who would like to try out the features and functionality before it is officially released in Windows. Installing these components will not break your existing Windows MIDI Services OS-delivered components install. Please read the installation instructions. The installers are at the end of these release notes.
Nothing in these releases is required for use of MIDI on Windows. The Windows MIDI Services service and transports for USB MIDI 1.0, USB MIDI 2.0, MIDI 2.0 loopbacks is already in Windows 11 25h2 and higher. This is all additional to what is already in the operating system, for advanced and curious customers to try out. If you are not comfortable with installing and uninstalling apps on Windows, please stop here.
This release updates the apps and the transports only. There is no new Windows.Devices.Midi2 NuGet package, and Preview 11 is still the API to build against. See API below.
GitHub Copilot generated most of the release notes here based on the actual work checked into the repo.
Packages and Installation Instructions
YOU MUST UNINSTALL THE PREVIOUS TOOLS BEFORE INSTALLING THIS
Windows MIDI Services works only on Windows 11 25h2 and later. Installing these packages on older versions of Windows, like Windows 10, will not work properly and is not supported.
If you are running any of the older rc4 or similar SDK Runtime and Tools, or any of the older preview transports, fully uninstall them from Settings > Apps > Installed Apps before installing anything here. If you were using the old Network MIDI 2.0 from the rc4 timeframe, you will need to delete your midiconfig.json file from %allusersprofile%\Microsoft\MIDI. You can also back up that version and manually remove the Network MIDI 2.0 entries if you are familiar with json files. Restart the MIDI service after editing.
In general, uninstalling the old via Windows Settings > Apps > Installed APps before installing the new is the safest choice. Either way, close all MIDI apps before installing the service plugins. (See note above. Due to a Preview 13 installer bug, this is a requirement)
Install the Tools package to have access to all the in-box tools required to configure endpoints, customize, route MIDI endpoints, create controller surfaces, and much more. Everyone will want this package. The tools are documented on the tools page.
The two installers (x64 if you are on Intel/AMD devices, Arm64 if you are on Qualcomm/NVIDIA silicon) are at the end of the release notes.
Install the Transports package to have access to preview versions of
- General MIDI Synth
- Basic MIDI 1.0 Loopback Transport
- RTP-MIDI Transport
- Network MIDI 2.0 Transport
- Bluetooth LE MIDI Transport
You can turn the individual transports on or off on the Transports page of MIDI Troubleshooting and Repair, which is in the Tools package.
Key Updates
- Windows MIDI Sequencer has a Key and chords row. Set the key, pick chords with suggestions that follow music theory, hear them, and have generators, clips and the arpeggiator follow them. An AI assistant of your choice can write a whole song plan for the row.
- Windows MIDI Sequencer has note tools, a Strum generator and a Meter row. Quantize, humanize, legato, clean up and more in the piano roll. Strum chords like a guitar, ukulele, piano or harp. Clips can now be made longer without looping (#1326).
- Windows MIDI Sequencer runs much lighter while playing (#1324). It draws less, the playhead moves smoothly on high refresh rate screens, and it never sends clock to the General MIDI Synth.
- Windows MIDI Monitor has an advanced mode. Watch many devices and groups in one list, see which ones are sending, and filter with the same choices as Windows MIDI Patchbay.
- Windows MIDI Patchbay can show the messages on a connection in a small window of its own, live while routing or from Test.
- MIDI Troubleshooting and Repair opens on an Overview that runs every check at once, and it now checks the Windows MMCSS settings that "tweak" guides sometimes break.
- Bluetooth LE MIDI timing is steadier. Incoming messages are smoothed by default, so notes played evenly arrive evenly. We tested this with real Bluetooth MIDI devices. Bluetooth MIDI Setup warns about a slow Bluetooth link. This PC publishes both BLE MIDI 1.0 and BLE MIDI 2.0 as a peripheral.
- The General MIDI Synth's Compatible mode sounds much more like the older Microsoft GS Wavetable Synth (#1336), and both modes now play the sound set's pitch envelopes.
- New app: Windows MIDI Calculator (preview) for tempo, note lengths, pitch and tuning, chords and scales, timecode, MIDI 2.0 values and Windows timestamps.
- The apps reopen at the right size on a second monitor with a different scale. Before, a window could reopen too big, hang over onto the main monitor, and grow a little more every time.
Installers
Each platform still has two installers, Tools and Transports.
- Windows MIDI Services Tools (
0.99.103-preview.14) adds Windows MIDI Calculator, with a Start menu shortcut and crash dump settings like the other apps. - Windows MIDI Services Transports (
1.0.52-preview.14). - Windows MIDI Patchbay now closes without asking when an installer, or Windows, ends it. Before, it asked "Stop routing and close?", often from a window hidden in the notification area, so the installer waited and then asked for a restart.
API
Preview 11 is still the current Windows MIDI Services API. Build and test your app against the Windows.Devices.Midi2 NuGet package from Preview 11, version 0.99.92-preview.11. Everything in the Preview 11 release notes about the API, including how you may use and distribute it, still applies.
Preview 11 with API nuget package and samples. This is only for developers and is only for the API and samples. Always use the latest apps and transports.
The Tools package installs a copy of Windows.Devices.Midi2.dll next to the apps, for the apps' own use. Don't build against that copy, and don't copy it into your app. It's an interim build for the tools, and its ABI is not locked, so it can change in any release without notice. An app built against it may fail when the next release, or the version in Windows, replaces it.
This set of release notes only covers the delta from Preview 13. Please refer to Preview 13 and earlier for everything before that.
Transports
Transport package version for this release is 1.0.52-preview.14.
General MIDI Synth
- Compatible mode is much closer to the older Microsoft GS Wavetable Synth (#1336). Songs written for that synthesizer should now sound the way their authors heard them:
- Drums respond to pitch bend, modulation, the damper pedal, pitch bend sensitivity and fine tuning. Only coarse tuning leaves them alone.
- A tuning change applies to the notes after it, not to notes already playing.
- Channel 10 has the highest priority when the synth runs out of voices, then channels 1 to 9, then 11 to 16, so drums are the last thing cut off. A burst of notes can briefly use 8 extra voices.
- Pitch bend glides to its new value over about 10 milliseconds instead of jumping.
- Bank select and the GS part messages wait for a GS Reset. Mono and poly mode, GS Scale Tuning and GS Rx. Channel work. Reset All Controllers and a few other messages work the way the older synthesizer read them.
- Modern mode still follows General MIDI 2. Every difference is listed in Compatible mode.
- Both modes play the pitch envelope from the sound set. More than 100 sounds were missing their pitch movement. For example, Synth Drum now falls after the hit, and Bagpipe is no longer about a semitone flat.
- Both modes: choosing an NRPN (CC 98 or 99) now stops the data entry after it from changing the pitch bend range or tuning by mistake. Files written for GS devices often send these.
- The new synth is unlikely to sound exactly the same as the old synth, but we're trying to get as close as possible with this clean-room implementation of the synth.
Bluetooth MIDI
- Incoming timing. Bluetooth sends MIDI in packets on a schedule set by the radio, so notes you played evenly can arrive in uneven bunches. Now, by default, Windows holds each incoming message for a few milliseconds and passes it on at the time the device stamped on it. Timing comes through much steadier, at the cost of a few milliseconds of latency. Choose As soon as possible per device, or as the default, to pass each message on the moment it arrives, as before. See Incoming timing.
- Tested with real devices. On a keyboard with a 15 ms connection interval, smoothing settles at about 16 ms of delay. A few percent of messages on a real link miss a connection event and arrive a whole interval late. Those are passed on as they arrive, rather than holding every message an extra interval to cover them.
- A device whose clock can't be trusted isn't smoothed. If a device's timestamps keep jumping, or even the 50 ms maximum delay can't cover its timing, Windows stops smoothing that device until it reconnects and passes its messages on as they arrive. Details for device makers are in Bluetooth Low Energy MIDI Transport Architecture.
- Slow Bluetooth link warning. Bluetooth MIDI needs a connection interval of 15 ms or less, and Windows tends to choose a slower one when it's saving power. Bluetooth MIDI Setup now warns about a slower link, and a failed connection says so too. Both offer Open power settings, so you can set the power mode to Best performance.
- This PC as a peripheral publishes both BLE MIDI 1.0 and BLE MIDI 2.0. The device that connects picks one, so a BLE MIDI 1.0 device can always connect. There's no protocol choice anymore. As a BLE MIDI 2.0 peripheral, this PC also answers the UMP Endpoint Discovery and Stream Configuration Request messages.
- BLE MIDI 2.0 Jitter Reduction (JR) timestamps are now handled in the Bluetooth transport, both directions, and incoming BLE MIDI 2.0 is smoothed the same way as BLE MIDI 1.0. Apps never see JR messages from a Bluetooth device. This follows the draft BLE MIDI 2.0 specification and Working Group discussion, so it's provisional and expect it to change.
BLE MIDI 1.0 Device Compatibility tracking is here
In-box service and transports
These parts ship in Windows. The fixes below reach customers through a Windows update in 2027, not through the preview packages.
- USB MIDI 1.0 through the new MIDI driver. When a device sent a packet the driver couldn't read, the driver also skipped the message after it. Now only the bad packet is dropped.
- The MIDI service records the stream configuration an endpoint reports, instead of the one the service asked for, and doesn't send its own to an endpoint that declined it.
Applications
Tools package version for this release is 0.99.103-preview.14.
All apps
- Window placement on monitors with different scales. A window closed on a second monitor with a different scale from the main one reopened too big, by the ratio of the two scales, and hung over onto the main monitor. It then saved that bigger size, so it grew every time. Every app now reopens at the size and place it was closed at. Fixes bug #1342.
Windows MIDI Calculator (new, preview)
A new calculator for music and MIDI. See Windows MIDI Calculator. Middle C is C3 by default, like the rest of Windows MIDI Services, and Settings has a choice for other octaves.
- Tempo and beats, with tap tempo, note and beat lengths in milliseconds, and samples.
- Notes and pitch, in five tunings.
- Chords and scales. The notes in a chord, on a piano keyboard and voiced the way Windows MIDI Sequencer plays them. Name a chord from keys you click. The chords in a key, with Roman numerals.
- Timecode and samples, with a running tape, conversion to frames, real time, samples and bars, the same moment at another frame rate, and sample and buffer lengths. Ten frame rates, including drop frame at 29.97 and 59.94.
- MIDI 2.0 values and Windows timestamps, for developers.
- History of what you've worked out.
Playing notes, and listening to a MIDI keyboard, come in a later preview.
Windows MIDI Sequencer
Key and chords
An optional row under Tempo and meter (File > Key and chords) with key changes along the top and chords under them. See Key and chords.
- Chords are spelled in the key and show their Roman numeral. A chord from outside the key gets a star. Chords move and stretch like clips.
- Help picking chords. The chord picker suggests likely next chords from music theory rules, more colorful choices such as borrowed chords, and whole progressions. Suggest fills empty bars.
- Play chords plays the row on the new Default output, which falls back to the General MIDI Synth. Copy chords to new track turns the row into notes.
- Generators, clips and the arpeggiator can follow the row. A melodic generator can play in the song's key and move notes onto the chord that's playing. Notes clips and melodic patterns can follow key changes. The arpeggiator can play the row's chords.
- Ask an AI assistant copies a starting prompt for the assistant you use, then reads its song plan back: key, chords and sections. Check says exactly what's wrong, if anything, and Apply puts it in place as one undo step. You can hide it in Settings. The guide for assistants is Windows MIDI Sequencer song plans, a guide for AI agents.
- Find key on a clip's menu suggests the three likeliest keys for its notes.
- Scale highlight lights the rows in the key in the piano roll. Scale snap puts notes you draw or drag in the key. Hold Alt for any note.
- Standard MIDI Files: export writes each key as a key signature, and import brings key signatures in.
Notes and clips
- Note tools in the piano roll: Quantize with strength and swing, Humanize, groove from another clip, ratchet, Legato, note lengths, pitch and velocity tools, and Clean up for overlapping, duplicate and very short notes. Each applies as one undo step.
- Strum generator. Plays chords from the Key and chords row or another track, voiced for guitar, ukulele, piano or harp, on a pattern of down and up strokes, with many styles, fingerpicking and glissandos. It can play keys you hold. Make notes turns it into notes you can edit.
- Strum in the piano roll. Strum selected chords, or drag across one with the Strum tool, and remove the strum again exactly.
- Glide and Vibrato as MIDI 2.0 per-note pitch bend, and Ctrl+drag in the velocity lane draws a velocity line.
- A clip can be longer without looping (#1326). Right-click a clip and pick Loop or Linear. Dragging the end of a linear clip makes it longer or shorter. New notes clips on the timeline start linear, and clips made in the launcher still loop.
- Meter row. An optional row with a flag at every meter change. Drag a flag to another bar, double-click to add one, or press Delete. Notes keep their time when bar lines move.
- Back to timeline now works on a track that was stopped from the launcher.
Playback and drawing (#1324)
- Much less drawing while playing. On some PCs, one processor core was at 100% with only a couple of clips playing.
- The playhead moves on every screen refresh, so it no longer stutters at 100 Hz and up. It sits on whole pixels, so it doesn't seem to fade in and out at scaling like 150%. Frames come evenly even on a PC that has no pro audio driver running.
- Clock is never sent to the General MIDI Synth, which doesn't use it. Sending it clock was a main cause of the lag. Devices added in Studio setup now start with clock off.
- Windows MIDI Sequencer no longer answers its own MIDI-CI Discovery on a loopback. Windows MIDI Keyboard has the same fix.
Windows MIDI Monitor
- Advanced mode (Ctrl+Shift+A) watches as many groups, on as many devices, as you like, in one list. A Sources list replaces the device, group and channel pickers. Each checked group gets its own color, and a From column says where each message came from. See Advanced mode.
- Activity lights show which devices and groups are sending, even before you start listening. Play a note to find out which device and group your keyboard really uses.
- Filter with the same choices as a Windows MIDI Patchbay filter step. Fold repeats puts repeated identical messages on one row, with a count.
- When another app opens MIDI Monitor on one device, your saved sources are set aside, not changed.
- Ctrl+L and a new Clear button clear the list, and the clear question has Don't ask me again. Ctrl+C copies messages as UMP words.
- Simple mode remembers the device, group and channel you watched last.
- Saved text and CSV files say which source each message came from.
Windows MIDI Patchbay
- Watch a connection. Right-click a connection and select Watch messages, or press Ctrl+M, to open a small window listing every message going along it, live while routing and from Trace messages.... Watch output on a step or endpoint watches all of its connections at once. Each window has a number and color that match a dot on the cord. Watching never slows routing down. See Watching a connection.
- Memories and tags on the toolbar lists every memory and tag a patch uses, which steps set and read each one, and what each memory holds now. Point at a name to light up its steps. A name nothing sets, or nothing reads, is marked, since it's usually a spelling mistake. Reset empties a memory without stopping routing.
- The inspector opens only on a click. Pressing, dragging or right-clicking a node or connection selects it without opening the inspector, so it no longer covers the node you're dragging. Edit settings on a step's right-click menu opens it.
- Message mask filter settings show the message as rows of bits, with the bits each condition looks at filled in and field names for common messages under them. Drag across the bits, or click a field name, to set what a condition looks at. Try a message shows a message's bits and what the step does with it.
- Show live routing moved from the Test menu to a toolbar button next to Test, and slows down while the window is minimized.
- In a message type filter, the Channel messages and System messages sections turn off until a message type they apply to is on.
- OSC: a rule's Argument box only shows when it applies (OSC coming in), and the panel warns about a rule that can never send because a rule above it already covers the same MIDI. The TouchOSC preset's toggles now send to the right address.
- Closes without asking when an installer or Windows ends it. See Installers.
Windows MIDI Troubleshooting and Repair
- Overview, a new first page. Every check runs in the background when the app starts, and colored cards show the MIDI service, transports, registry, USB MIDI devices and drivers, apps using MIDI, recent crashes, API mode and MMCSS. A banner lists what needs attention, with a link to the page that fixes it, and those pages get a dot in the navigation. See Overview.
- MMCSS check. Tweak guides and "optimizer" apps sometimes set Windows multimedia scheduling (MMCSS) values that Windows rejects, and then some apps can open MIDI ports but get no input. The Registry page now tests the Audio and Pro Audio tasks and shows anything changed from the Windows defaults. It reports only, and doesn't change these. See MIDI apps get no input after Windows tweaks.
- Legacy MIDI mode aware. In Legacy mode, the Overview leads with the API mode, and the MIDI service, Transports and Active sessions pages say they aren't used instead of reporting a problem.
- Every page has the same look. Active sessions shows the transport for each connection and has a button to copy an endpoint's id. Transports are grouped into those in Windows and the preview ones. On the Drivers page, the button for the driver a device already uses is turned off and says so.
Bluetooth MIDI Setup
- Incoming timing for each device, and a default on Transport settings. While a smoothed device is connected, Details shows how many milliseconds smoothing is adding.
- Slow Bluetooth link warning, with a button that opens the power settings.
- The peripheral page no longer asks for a protocol, and shows which one the connected device picked.
Windows MIDI File Player
- The position and progress update evenly, even on a PC that has no pro audio driver running.
Windows MIDI Console
midi bluetooth customize --incoming-timingand the newmidi bluetooth defaultsset incoming timing.midi bluetooth listandstatusshow it.- Fix:
midi bluetooth customizeoptions such as--name,--description,--imageand--keep-when-offlinewere only saved for the next service start. They now apply right away too. midi bluetooth peripheral startpublishes both protocols.--protocolis still accepted, so scripts keep working, but does nothing.
Documentation
- New: What the MIDI entries in Device Manager are, and which ones are safe to disable.
- New: MIDI apps get no input after Windows tweaks (MMCSS task settings).
- New: Windows MIDI Calculator tool page, with a quick start and a section for each page.
- New: Windows MIDI Sequencer song plans, a guide for AI agents, with a script that checks a song plan.
- The General MIDI Synth has a new Compatible mode section listing every difference from Modern mode.
- Bluetooth Low Energy MIDI Transport Architecture covers incoming smoothing, measured results from a real keyboard, devices whose clocks can't be used, BLE MIDI 2.0 JR timestamps, and what device makers can expect for timing.
- Updated tool pages for Windows MIDI Sequencer, Windows MIDI Monitor, Windows MIDI Patchbay, MIDI Troubleshooting and Repair, Bluetooth MIDI Setup and the
midiconsole.
Installers
YOU MUST UNINSTALL THE PREVIOUS TOOLS BEFORE INSTALLING THIS VERSION
Expand the section below if it is collapsed. The installers are there. See the instructions at the top of the release notes for how to install.