SuperSource and Macros

Learn how to incorporate macros with SuperSource.

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.

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.

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.

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.

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.

Last updated