# Installation

### System requirements

* **Windows 11** (macOS will come if the app gets some real traction)
* A MIDI controller... :)
* A Downstream app!

### Download and Install

1. Download MIDI Mimic from [https://jsvideodesign.com/product/midi-mimic-v0-1/](https://jsvideodesign.com/?post_type=product\&p=785\&preview=true)
2. Extract and run the installer
3. The installer will bundle and install:
   * **VC++ Redistributable:** a runtime library required by the application
   * **Windows MIDI Services (WMS):** if you're on Windows 11 23H2 or earlier. On 24H2+, WMS is pre-installed on your system.
   * **BugSplat:** automatic crash reporting (see below)

### <img src="/files/GXnNjohxmVhVh1YoogGD" alt="" data-size="original">

### After installation

When you launch MIDI Mimic for the first time:

* If Windows MIDI Services is missing, you'll see an error dialog. This is rare on Windows 11 24H2+, but can happen on earlier builds. The installer handles it automatically.
* Otherwise, Mimic will open to the Session view, any connected controllers that are not being grabbed by another app will be enabled as standard, as will any you plug in while Mimic is open.
* Go to Settings via cogwheel if you need to change which devices are enabled.

## Automatic crash reporting

MIDI Mimic includes [**BugSplat**](https://www.bugsplat.com/) for automatic, silent crash reporting. If the app encounters an unexpected error:

* A crash report is sent to my server to help me identify and fix the issue
* **No personal data is collected.** Only the crash log and system version
* You won't see any prompts or notifications

## Troubleshooting

**"Windows MIDI Services not found"**

* This shouldn't happen post-installation, but if it does, try updating Windows 11 to the latest build.

**Virtual MIDI devices not appearing in Resolume or other software**

* Restart both MIDI Mimic and your downstream software (Resolume, etc.)
* Make sure the devices are enabled (green) in MIDI Mimic Settings

**Installation fails**

* Ensure you have administrator rights
* Close any antivirus software temporarily and retry


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://midi-mimic.gitbook.io/midi-mimic/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.