MixEffect Documentation

MixEffect

MixEffect Newsletter

MixEffect Community

SuperSource

MixEffect offers the most powerful and configurable way to control SuperSource on supported ATEM switchers.

SuperSource Requirements

SuperSource is a feature on the following ATEM switchers:

If your ATEM switcher is not one of the switchers listed above, the SuperSource feature will not be available when you connect to your switcher.

That said, you will be able to create SuperSource layouts within the ATEM Simulator. Then, if and when you get one of the above switchers, you’ll be able to enjoy SuperSource.

Interface

The SuperSource section in MixEffect has four main components:

The first three map to the picker interface at the of the three sections. You access the View All Presets page by tapping on the filled-grid icon in the upper-right corner.


Presets

The presets tab allows you to switch between layouts and adjust the settings for each box.


Default Presets

MixEffect comes with a number of pre-built SuperSource layouts for you to use in your video productions. You don’t need to create macros or mess with the box settings. And you can create your own layouts and share them with other people.

When you open up the SuperSource section, tap on the Add Default Presets button to install the default layouts.

Add default SuperSource presets

Tap on a layout and watch your SuperSource come to life as it transitions from one layout to the other.

NOTE: If you do not see the default presets when you first install MixEffect, you can recall them by going to MixEffect Settings > Reset > Reset Presets. This will delete any existing presets you have created in MixEffect, so export your presets if you want to keep what you already made.


Highlight Bar


Transition Style

The transition style determines the look of the animation between preset layouts.

Adjust the mathematical style of the transition from the following options:

Experiment with each style to find one that looks and feels the best for your production.


Transition Speed

Adjust the speed of the animated transitions from one layout to another. Tap on the SuperSource options menu and choose Transition Speed. Select a speed from one of the following six options:


Grow Highlighted Box

When you highlight a box, you can grow the size of the box to emphasize it in relation to the other boxes. Choose a value from 1.0 to 1.5 times the original size of the box.


Shrink Other Boxes

When you highlight a box, you can shrink the size of the other three boxes at the same time. Choose a value from 1.0 to 0.5 times the original size of the boxes.


Updating a Preset

If you have modified the SuperSource layout and want to update an existing preset, long-press on the preset in the SuperSource section main screen and choose Save Layout in the menu that appears.

The currently selected preset can also be updated by pressing Command-S. Any box changes will be copied to the preset highlighted in orange. The preset thumbnail will spin and change from its previous layout configuration to the new layout.

NOTE: Versions of MixEffect prior to 1.2.0 required just a long-press on the preset in the SuperSource section to save. Version 1.2.0 introduced a menu of additional options when long-pressing on a preset.


Visual Editor

Below the presets, preview scale, and highlight bar is the SuperSource visual editor. Here you see an accurate recreation of your SuperSource layout. If SuperSource is currently set to the Program selection, a red box will outline the visual editor. If SuperSource is the current Preview selection, the visual editor will be outlined in green.

SuperSource

Tap and drag the boxes around, or pinch and expand to resize the box. Use the visual editor to get your boxes in roughly the position you want them. Then use the box controls below to fine-tune your layout.

NOTE: To reposition the boxes, you must first unlock the visual editor by tapping on the red lock icon.


Box Arrange Bar

Unlocking the visual editor will reveal the Box Editing Bar (available in MixEffect 1.0.3 and later) that features the following buttons:

SuperSource Box Arrange Bar

Toggle Grid Mode

Turns on an off grid alignment mode. Dragging boxes will align the box to a grid size specified in the Grid Size menu.

Grid Size

A menu allowing you to specify the grid size used when aligning boxes. This menu is visible when you have enabled Grid Mode.

Constrain Movement

Tap this button to cycle through three movement constraints when tapping and dragging your boxes:

Box Selector

Select which box the Box Size and Aspect Ratio commands will operate on. You can select an individual box to modify or choose to modify every box.

When To All Boxes is chosen, the icons for Box Size and Aspect Ratio will turn green to reflect that all boxes will be modified.

Box Size

Change the size of a box or all the boxes. You can also enter a custom size between 0.07 and 1.0 by choosing Custom.

Aspect Ratio

Choose the aspect ratio of a box from a list of commonly used aspect ratios, from 1:1 (Square) to 16:9 (HD), to 3:2 (35mm), and more.


Transition Speed Menu

If you have enabled Show Transition Speed Menu in MixEffect Settings > User Interface, a menu will appear in the upper-right corner of the Visual Editor. The icon will indicate the current speed.

SuperSource Transition Speed menu

Tap the speed indicator to change the SuperSource Transition Speed:


Box Sources

You can quickly adjust the box sources using a crosspoint selector.

SuperSource Box Sources


Box Controls

Tap Show Box Controls to adjust the following settings for each box:

With the slider controls, a clockwise-arrow button will appear when the slider value has changed from its default. Tap on the button to reset the setting back to its default value.

Each box control also has buttons to Set All Settings (used when recording macros) and Reset settings back to the defaults.


Cascade

If you have an ATEM Constellation, you can combine the two SuperSources into one by enabling the Enable Cascade toggle at the bottom of the Presets section.

When enabled, an orange Cascade indicator will appear atop the SuperSource Visual Editor window.

NOTE: Performing transitions from MixEffect only sets the layout for the currently selected SuperSource. If you want to animate both SuperSources when Cascade is enabled, you will have to use Shortcuts or OSC. Also note that the animations currently happen sequentially, rather than concurrently. So, the first SuperSource preset layout will change, followed by the second SuperSource preset layout.

If you have a keyboard attached to your device, you can also press Command-Option-C to toggle cascade. This will display the word “Cascade” in orange at the top of the SuperSource Visual Editor.


Cascading Both SuperSources at the Same Time on the ATEM Constellation 8K

If you have an ATEM Constellation 8K, you can use a shortcut or Companion to change the layout of your cascade SuperSources at the same time. See the documentation in the Shortcuts section on the Set SuperSource Cascade Layout and the SuperSource Cascade Presets command in the OSC docs for more details.


Art

Change the foreground or background source for the SuperSource.

Note: Border is not available on all ATEM switchers.


Copy Boxes

This section allows you to copy position, enables, size, and crop settings from one box to the other three boxes.

Note: The input source is not copied to the other boxes.

SuperSource Copy Boxes


View All Presets

Tap the View All button or press Command-O in the Presets section to go to the View All Presets page.

SuperSource

Tap the button in the upper-right to access the following menu:

View All Presets Shortcut

You can also access the View All Presets page directly from the Switcher Navigation section by tapping the chevron icon on the SuperSource row.

SuperSource View All Presets Shortcut


Setting Layouts

When in Grid or Detail mode, you can tap on a preset to set its layout.

SuperSource Grid View

SuperSource Detail View

When in List mode, you will tap on the Play button on the far right to set the SuperSource layout to the selected preset. This is done to prevent accidental triggering.

SuperSource


Highlight Bar

The same highlight bar from the SuperSource section main page is present on the View All Presets page.


Filtering Presets

Use the search bar to filter your presets by text contained in the preset name or description. The filtered list of presets will be shown on the main SuperSource section.

Use the description to place tags to identify collections of layouts used for a particular show or event.


Use Box Sources

From the View All Presets page, you can mark presets to use the box sources defined in the preset.

  1. Go to the View All Presets page.
  2. Long-press on a preset you want to modify.
  3. Tap Use Box Sources. If enabled, a checkmark icon will appear next to the Use Box Sources menu option.

When Use Box Sources is enabled, the box sources defined in the preset will be used when transitioning to that preset. For instance, if the currently SuperSource layout had the following box sources:

  1. Camera 1
  2. Camera 2
  3. Camera 3
  4. Camera 4

And you switched to a preset that had Use Box Sources enabled and the following boxes defined:

  1. Camera 5
  2. Camera 6
  3. Camera 7
  4. Camera 8

Going to this second preset will change the box sources. If you went to another preset that has Use Box Sources disabled, the box sources would remain Cameras 5-8.

A preset that has Use Box Sources enabled will be indicated by an icon of a lock inside a rectangle below the preset name.

Use Box Sources


Specifying Individual Locked Box Sources

You can specify which box sources should be locked in a preset. For instance, you may want Boxes 1 and 2 to be locked but 3 and 4 to be able to change based on other presets.

Locked Box Sources

  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 Use Box Sources.
  6. Check the boxes that you want to lock.

When you enable Use Box Sources for the first time, all the boxes will be locked.


Setting Custom Animation Speed

In version 1.2.0 of MixEffect, you can now set a custom animation speed to use when recalling a preset. This custom speed will override whatever animation speed you have set in MixEffect.

  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 Use Custom Speed.
  6. Tap Speed and select the animation speed you wish to use with the preset.

The icon associated with the custom speed will be displayed next to the preset button.

Assigning a custom speed to a SuperSource preset

Custom Animation Speed with Cascading Presets

If you have an ATEM Constellation 8K and make use of the Cascade SuperSource Layout OSC command or Shortcut action to recall two presets at the same time, use the following guide to determine the speed of the preset transitions:


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.

Enabling SuperSource Macros

Attaching Macros to Presets

There are two types of macros that can be assigned to a 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.

Assigning a macro to a SuperSource 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.


Bulk Editing Presets

Switch to List view to access editing controls for managing your presets. Tap the Edit button and select the presets you wish to manage.

SuperSource Edit Presets bar

The highlight bar will transform into an editing bar with the following commands:


Importing and Exporting Presets

You can share presets with other people, or save copies of your presets to your computer. The preset export file is a simple JSON text file that contains information about your preset, including:

Note: The Run Macro and Run Macro Exit flags are not set when importing a preset export file. This is to prevent accidental triggering of macros when importing presets from a third-party.

There are two primary ways to import a preset into MixEffect:


Import File

Use the Import Presets command from the View All Presets page in the SuperSource section. Navigate and select the presets file that you wish to import.

Presets with the same UUID (unique identifier) will be replaced by the imported preset. Any new preset will be added to MixEffect.


Import Presets Using Shortcuts

The Import Presets shortcuts action can take your presets JSON text and import presets directly into MixEffect. Follow these steps to create a shortcut:

  1. Open Shortcuts.
  2. Tap the + button.
  3. Add a Text action.
  4. Paste the contents of a MixEffect presets export file into the Text action.
  5. Add an Import Presets action.
  6. Run the shortcut or share it with others.

Naming Presets

It’s important to have unique names for your presets. MixEffect does not prevent you from having duplicate names, but keep in mind the following things:

  1. The preset name will be used to identify the currently active preset. If you have multiple presets with the same name, you may see multiple presets highlighted in orange.
  2. Video Follows Audio uses the preset name to determine which preset to switch to. If multiple presets exist with the same name, the wrong preset may be chosen.

Differentiate Box Colors

By default, the box colors are displayed in the accent color specified in MixEffect’s Settings. You can change this so the boxes are differentiated by color by following these steps:

  1. Tap Settings (gear icon) from the MixEffect home.
  2. Tap User Interface.
  3. Under SuperSource, tap to enable Differentiate Boxes with Color.

The colors below will be used to identify each box:

Colored SuperSource boxes


Sticky Current Preset

You can affix the currently selected preset in the Presets tab by enabling the Sticky Current Preset in MixEffect’s Settings.

  1. Tap Settings (gear icon) from the MixEffect home.
  2. Tap User Interface.
  3. Under SuperSource, tap to enable Sticky Current Preset.

The current preset will be displayed on top of the list of presets when MixEffect is displaying its compact (e.g. portrait) interface. Otherwise, the preset will be stuck on the left-hand side of the presets bar.

Sticky Current Preset


Show Transition Speed Menu

You can display a menu button in the SuperSource Visual Editor to allow you to quickly adjust the transition speed:

  1. Tap Settings (gear icon) from the MixEffect home.
  2. Tap User Interface.
  3. Under SuperSource, tap to enable Show Transition Speed Menu.

Shortcuts Integration with SuperSource

MixEffect’s deep integration with Siri and Shortcuts allows you to automate your SuperSource presets.

Default Boxes Shortcut

The Default SSRC Boxes shortcut sets the inputs for Box 1, 2, 3, and 4 to Inputs 1, 2, 3, and 4.

SuperSource Box Helper Shortcut

The SuperSource Box Helper shortcut assists with the creation of boxes of a certain size and aspect ratio.

SuperSource Box Helper

Using Siri

Create a shortcut that sets a particular SuperSource preset and recall it with your voice. Here is an example shortcut that sets the Four Grid preset. Run it by saying, “Hey Siri, Four Grid Preset” when MixEffect is running in the foreground.


Recording Presets as Macros

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

First, you need to enable the following preference:

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.

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.