# Macro Editor

The Macro Editor is a full-screen interface where you configure everything about a single Macro.

{% hint style="success" %}
Cues handle the conditions required for the Actions to happen, Actions handle how the input signal is represented e.g. to Match or Invert it, and where to send it, i.e. to a new CC or to trigger a Ghost Parent.
{% endhint %}

<figure><img src="/files/XGhJsxTgHr7cG0tuaem4" alt=""><figcaption></figcaption></figure>

### Header

Save and Discard buttons at the top, beneath which is the main info panel. Here you can rename the Macro, set it as a standard Parent or Multi Parent. If your Macro is linked to a button, you'll be able to choose Cycle Cues.

<figure><img src="/files/rux7awNmKi8bNNOdbdWw" alt=""><figcaption></figcaption></figure>

You can relink your Macro to a different input, which once Macro duplication has been integrated will be especially handy. Please note, relinking to a different control type will remove/alter the options available to you in Cue and Actions, but these are non-destructive until Saving.

To relink, press the Listen button, it will turn orange. Interact with your new control and it will return to green, your input indicator will update.

<div align="left"><figure><img src="/files/8CKtFebkaf9zEwNwq5Wy" alt="" width="250"><figcaption></figcaption></figure></div>

The Add Cue button adds another Cue and it's accompanying Action.

### Cue & Action Stack

Cues and Actions are displayed in collapsible blocks vertically, you can scroll once there are too many to fit into Mimics workspace.

Both Cues and Actions are made of a Header strip and a collapsible body. The Header strip displays metadata relating to the settings you configure below, so that when collapsed, you get a quick rundown of what's going on.&#x20;

#### Three ways to interact:&#x20;

1. Use the collapse/expand toggles independently.
2. Shift+click the Cue collapse/expand toggle to set both to the same state
3. Double click the Cue or Action headers to toggle collapse/expand

### **Cue Editor**

<div align="left"><figure><img src="/files/EUA4Mmv88jbQ8b2ZQjSd" alt=""><figcaption></figcaption></figure></div>

Cue Input States change for Buttons and Continuous. For Buttons, "Both" means the press and release will route to the new address, for the others, you can choose to Pulse On, or Pulse Off, otherwise you send just an On or just an Off.

{% hint style="success" %}
*Cues = when, Actions = what + where.*
{% endhint %}

See [Cues and Conditions](/midi-mimic/cues.md) for more details.

### **Action Editor**

<div align="left"><figure><img src="/files/w63BFobRoKuD0gT9KYH7" alt="" width="375"><figcaption></figcaption></figure></div>

Actions handle what to do with the signal and where to send it. Actions are carried out only when all Cue Conditions in it's Cue are met.

Saving a Macro exits the Editor and saves the Session, returning you to the Session View.

### Related Pages

* [Cues](/midi-mimic/cues.md) how to set up conditions
* [Actions](/midi-mimic/actions.md) what happens when a cue fires
* [Cue Cycling](/midi-mimic/cycle-cues.md) step through cues on each trigger
* [Parents & Children](/midi-mimic/parents-and-children.md) make macros depend on other macros


---

# 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/macro-editor.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.