# Session Files

MIDI Mimic saves your entire session, all macros, groups, settings, and output assignments, to a single JSON file.

**Format:** JSON **Location:** `Documents/MIDI Mimic/Sessions/`

**When it saves:**

* Every time you save a Macro or Group
* When you switch to Live Mode
* When you quit the app cleanly

**Device reconnection:** If a physical MIDI device disconnects mid-session:

* All its Macros are preserved and flagged inactive
* Its virtual device (mm-prefixed) persists so your VJ software doesn't lose the port
* When the device reconnects, it reattaches automatically by name

{% hint style="success" %}
Until I make Save/Load an actual feature - Just store copies of your Session.JSON in a subfolder! As long as the live one is called "session" it will load.
{% endhint %}

{% hint style="danger" %}
Future Feature Spec: Exporting of Macros, Macro and Toggle Groups etc so that you can mix n match into new Sessions\
Session Merging, same idea but maybe useful for setting up one Device at a time to mix n match?!
{% endhint %}


---

# 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/session-files.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.