Macros

Display

All of ATEM's macros are available for running from the switcher page. You can display your macros in a grid, button or list view.

Macros Button

Tap the Macros button to display the Macros sheet. Long-press to bring up the Macros Action menu and choose one of the following actions:

• New Macro: Create a new macro in an empty macro slot.

• New Macro With Details: Create a new macro in an empty macro slot. Before recording, you can enter metadata about the macro, such as its name, description, icon, and color.

• Replace Macro: Replace an existing macro with a new one. This operation cannot be undone.

Macro Button

Tap a macro to run or edit it depending on your Macro On Tap preference in Settings. Long-press to reveal the Macro Action menu and choose one of the following actions:

• Run Macro: Runs the selected macro.

• Edit Macro: Edits the selected macro.

• Re-record Macro: Replace the selected macro with a new macro. This operation cannot be undone.

• Delete Macro: Delete the selected macro. This operation cannot be undone.

Macros View

The Macros View is where you can search, sort, and manage your macros. There are two ways to access it:

• Tap on Macros from MixEffect Home.

• Tap on the Macros button on a switcher page.

The Macros View is organized as follows:

• Toolbar

  • Loop: Toggle to turn looping on and off when playing back macros.

  • Options: Menu allowing you to change the display mode and sort the list of macros.

  • New: Create a new macro.

• Search Bar: Filters the list of macros based on text found in the macro's name or description.

• Macros: The filtered and sorted list of macros on the ATEM switcher, shown as a grid, button list or text list.

Search and Sort

MixEffect allows you to search your macros by name or text contained in the notes field. It also allows you to search by the following criteria:

• Index

• Name

• Icon

• Color

This provides unparalleled ability to organize your macros exactly the way you want them.

You could add a keyword in the Notes field and use search in MixEffect to quickly view all macros associated with a particular show or stream.

Customization

By adding custom metadata in the Notes field in your macros, you can add colors, icons, and custom labels to your macros when viewed by MixEffect.

• Label: This is a short string to be displayed in a button.

• Icon: The SF Symbol to be displayed in place of the macro index or in a button. An icon will not be shown in a button if a label has already been specified.

• Icon Color: the color of the icon. Defaults to either white or black depending on the color scheme of your device.

• Color: the color of the macro when displayed in the Macros view or sheet.

• Text Color: the color of the text when displayed in the Macros view or sheet.

All metadata fields follow the same format. You can enter these fields manually in the ATEM Software Control app from Blackmagic or visually within MixEffect.

Label

{l#LABEL}

For instance, adding {l#PIP} to the Notes field of a macro will cause the button to be labeled PIP when the macro display mode is set to grid.

Icon

{i#SF_SYMBOL}

For instance, setting the icon to be: {i#house.fill} will use the SF Symbol house.fill in this macro.

A list of valid symbol names can be found in the SF Symbols app from Apple. There are over 2400 symbols available, so you can customize your macros in many ways.

Icon Color

{ic#ICON_COLOR_HEX}

This sets the color of the icon. If left blank, the color will alternate between white and black depending on the color of the macro.

Color

{c#COLOR_HEX}

Entering {c#00FF00} will make your macro appear on a green background when seen in the Macros view or sheet in MixEffect.

Text Color

{tc#TEXT_COLOR_HEX}

This sets the color of the text when the macro display mode is set to Button. If left blank, text will be either white or black depending on the color of the macro.

Macro Record Floating Panel

When recording macros, a floating panel with the following buttons will appear:

• Stop Recording

• Add Pause: Displays a sheet allowing you to add a pause step to the currently recording macro.

• Wait For User Input: Causes the macro to wait for the user to press the Continue button when running.

Macro Run Floating Panel

When you run a macro, a floating panel will appear in MixEffect with the following buttons:

• Loop: Run the macro over and over.

• Continue: If the macro is waiting for user input, tapping the Play button will cause the macro to go to the next step.

• Stop: Stop the currently running macro.

NOTE: The Macro Run panel will not appear if your macro finishes quickly.