# Windows MIDI Services

> Windows MIDI Services is the MIDI 1.0 and MIDI 2.0 system in Windows 11. It includes apps for musicians, such as Windows MIDI Glass, which makes touch control surfaces, and Windows MIDI Patchbay, which connects MIDI devices to each other.

If someone asks you to make a Windows MIDI Glass layout, a Windows MIDI Glass theme, or a Windows MIDI Patchbay patch, read the matching guide from start to finish before you write anything. Each guide says what to ask, gives the whole file format with a working example, and has a script that checks the finished file. The apps ignore keys they don't know without an error, so use only the keys and values the guide lists.

## Guides for AI agents

- [Windows MIDI Glass layout files, a guide for AI agents](https://microsoft.github.io/MIDI/kb/midi-glass-layouts-for-agents/): How to design a `.midilayout` file for Windows MIDI Glass. What to ask, the file format, the built-in themes, and how to show the customer a mockup.
- [Windows MIDI Patchbay patch files, a guide for AI agents](https://microsoft.github.io/MIDI/kb/midi-patchbay-patches-for-agents/): How to plan a `.midipatch` file for Windows MIDI Patchbay. What to ask, the file format, and how to show the customer the plan.
- [How Windows MIDI Glass themes work](https://microsoft.github.io/MIDI/kb/midi-glass-themes/): The `.miditheme` file format, the built-in themes, and how to design a theme for someone.

## The same guides as markdown

Links inside these files start with `{{ site.baseurl }}`, which stands for `https://microsoft.github.io/MIDI`.

- [Windows MIDI Glass layout guide](https://raw.githubusercontent.com/microsoft/MIDI/main/docs/kb/midi-glass-layouts-for-agents.md)
- [Windows MIDI Patchbay patch guide](https://raw.githubusercontent.com/microsoft/MIDI/main/docs/kb/midi-patchbay-patches-for-agents.md)
- [Windows MIDI Glass theme guide](https://raw.githubusercontent.com/microsoft/MIDI/main/docs/kb/midi-glass-themes.md)

## Optional

- [Windows MIDI Glass](https://microsoft.github.io/MIDI/tools/midiglass/): The app's documentation for customers.
- [Windows MIDI Patchbay](https://microsoft.github.io/MIDI/tools/midipatchbay/): The app's documentation for customers.
- [Windows MIDI Sequencer](https://microsoft.github.io/MIDI/tools/midisequencer/): The app's documentation for customers. A very early preview.
- [Knowledge base](https://microsoft.github.io/MIDI/kb/): Every article, for customers and developers.
- [WinRT API reference](https://microsoft.github.io/MIDI/sdk-reference/): For developers writing apps that use MIDI on Windows.