# SuperSource and Macros

## Recording Presets as Macros

You can record SuperSource transitions as macros on your ATEM switcher.

First, you need to enable the following preference:

* Go to the **MixEffect Home**.
* Tap **Settings** (gear icon) in the upper-left.
* Tap **Macros**.
* Enable **Add Pause Steps When Recording Macros**.

This will add a pause step of 1 frame after each step of the animation transition between layouts.

To record a macro from MixEffect, do the following:

1. Go to the **Macros** section.
2. Tap **+**.
3. Choose the **macro slot** you wish to record.
4. Enter your name, description, icon, color, etc.
5. Tap **Record**.
6. Go to the **SuperSource** section.
7. Tap a **preset**.
8. Tap the **Stop** button in the Macro Record floating panel.

<mark style="color:red;">**NOTE: When recording a macro that contains a SuperSource transition, sometimes the macro stops recording. One workaround is to use a faster (i.e. Extra Fast or Instant) speed. This is a result of the ATEM not being able to record all the commands that go into a slower transition.**</mark>

### Macro Recall of a Preset Disclaimer

It is important to note that the macro you just recorded will perform the preset transition animation based on how the current SuperSource boxes were when you started the transition. If your SuperSource is configured to display another preset and you run the macro, you will see the boxes jump to the same starting position they were in when you recorded the macro.

As a result, it is almost always better to run your SuperSource presets from the SuperSource section (or via Companion on your Stream Deck) instead of through a macro. Doing it in this fashion will ensure your box transitions operate smoothly from preset to preset.

## SuperSource Macros

In version 1.2.0 of MixEffect, you can now have a macro run when recalling a preset and when leaving a preset.

In order to make use of this feature, you must toggle the Enable SuperSource Macros in each switcher connection entry in MixEffect:

1. Go to **MixEffect Home**.
2. Tap on a **switcher connection** entry.
3. Turn on **Enable SuperSource Macros**.

<div><figure><img src="/files/9jMxo6LXWPeNtXSqjwKT" alt=""><figcaption></figcaption></figure> <figure><img src="/files/PQX8X2YThcFJDwUpUJwg" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0EH4uK0W5dfXgNi1IkUY" alt=""><figcaption></figcaption></figure></div>

### **Attaching Macros to Presets**

There are two types of macros that can be assigned to a preset:

* **Run Macro**: A macro will run when transitioning to a preset.
* **Exit Macro**: A macro will be run when leaving the current preset.

To assign a run macro, perform the following:

1. Go to the **SuperSource** section.
2. Tap the **View All Presets** button in the upper-right.
3. Long-press or right-click on a preset.
4. Choose **Edit Preset**.
5. Enable **Run Macro**.
6. Tap **Macro** and select the macro you wish to run when recalling the preset.

A scroll icon will appear next to the preset name when a macro has been assigned.

To assign an exit macro, perform the following:

1. Go to the **SuperSource** section.
2. Tap the **View All Presets** button in the upper-right.
3. Long-press on a preset.
4. Choose **Edit Preset**.
5. Enable **Run Macro on Exit**.
6. Tap **Macro** and select the macro you wish to run when leaving the preset.

<div><figure><img src="/files/KunBQpAo8J4xcJ5FzibP" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4QionNYXAqHh9DZ0oXbW" alt=""><figcaption></figcaption></figure> <figure><img src="/files/f6klyR3yrKil3B42P6xz" alt=""><figcaption></figcaption></figure></div>

A filled scroll icon will appear next to the preset name when an exit macro has been assigned.

### **Recalling the Same Preset**

Run and exit macros will not run if you recall a preset if it is the currently selected preset in MixEffect.

### **Macro Timing**

ATEM switchers can only run one macro at a time. If a macro is currently running when another macro is executed, the current macro will terminate before finishing all of its actions.

If you are transitioning from a preset that has an exit macro defined to a preset with an entrance macro defined, there will be a small delay between calls to execute the macro.

### **SuperSource Macros and Multiple Switchers**

If you use multiple SuperSource-capable switchers with MixEffect, you will have to spend extra time making sure that either (1) your macros are in sync or (2) you identify which presets with macros work with which switchers. Otherwise, you can run into a situation where the wrong macro runs when you recall a SuperSource preset.


---

# 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://docs.mixeffect.app/explore/supersource/supersource-and-macros.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.