Upstream Keyers

Control the look of your Upstream Keyers (USK) completely using MixEffect. No more digging around palettes in ATEM Software Control when they are right there at your fingertips.

MixEffect lets you change the current keyer style and toggle its On Air status.

With MixEffect Pro, you have full access to the settings behind each keyer and can also customize the position of the Next Transition panel within each layout.

  • Panel

  • Sheet and View

  • Luma

  • Chroma

  • Pattern

  • DVE


The Next Transition panel holds information about your upstream keyers and can be added to your switcher interface.

The panel lists all of the available upstream keys from your ATEM switcher for the current Mix Effect bus. For instance, an ATEM mini will display one available USK and three disabled ones whereas an ATEM Mini Extreme will show four active USKs.

Section and Sheet

You access the USK settings in one of two ways:

  1. Tap Upstream Keyers from the MixEffect Home.

  2. Long-press the Key 1, Key 2, Key 3, or Key 4 button in the Next Transition panel and choose USK Settings in the context menu that appears.


Refer to the section on Keying using ATEM Switchers in your ATEM's manual on how to configure each setting in the Luma tab of the Upstream Keyers settings page.


Refer to the section on Keying using ATEM Switchers in your ATEM's manual on how to configure each setting in the Chroma tab of the Upstream Keyers settings page.


Refer to the section on Keying using ATEM Switchers in your ATEM's manual on how to configure each setting in the Pattern tab of the Upstream Keyers settings page.


Refer to the section on Keying using ATEM Switchers in your ATEM's manual on how to configure each setting in the DVE tab of the Upstream Keyers settings page.

Visual DVE Editor

When you are on the DVE tab, or have enabled the flying key in Luma, Chroma, or Pattern, you gain access to an advanced positioning system for the DVE frame. Use drag and drop or multitouch to position the frame on the virtual screen. You can continue to fine-tune your size, position, and rotation settings using the sliders or text-entry fields in the sections below the visual editor.


Five convenient buttons allow you to position the current DVE or Flying Key box in the four corners or center of the viewport.


Add padding around the DVE box for better positioning when aligned in the corners of the viewport.

Preview Scale

Adjust the size of the Visual DVE Editor in MixEffect. This helps with positioning of the DVE or Flying Key or when using MixEffect on difference iOS or iPadOS devices.


Tap the Lock icon to lock or unlock the Visual DVE Editor. If the lock icon is covered by the DVE or Flying Key, you can long press in the visual editor box for 1.75 seconds to toggle the lock status.

Flying Key

Controls for setting and running the flying key. This allows you to move the DVE box around the screen. For more complex movements, refer to the section on Automations below.

  • Set: Set the A and B positions of the Flying Key.

  • Rate: Adjust the rate at which the flying key moves between the A, B, Full, and Infinity positions

  • Run: Run the Flying Key between the A and B positions, Full, or various Infinity settings.

Reposition in Box

Take the guesswork out of figuring out the right values for the x, y, and top, bottom, left, and right crop values with the new Reposition in Box feature of MixEffect 1.8.0. You can now reposition an input source within the Upstream Keyer DVE or Flying Key.

NOTE: Adjusting the size of the input source is not allowed when the Reposition in Box feature is enabled.

After you have tapped the Unlock icon to enable repositioning of the DVE/Flying Key, another icon will appear to the left of the lock icon. This is the Reposition in Box button. Tap it to enable it and turn the icon red. Tap again to disable Reposition in Box.

Tap and drag the DVE/Flying Key to reposition the input sources position within the crop boundaries.

Caveats When Using Reposition in Box with DVE and Flying Key

When using the Reposition in Box feature with the DVE and the Flying Key, you may encounter a situation when the size of the DVE/Flying Key gets slightly larger or the position of the box changes.

This is because MixEffect has to do the calculations and send two commands to the ATEM to adjust the crop and position of the Flying Key. They are separate actions, and sometimes the ATEM doesn’t update its status quick enough to MixEffect. It is recommend that you have a macro, shortcut, or Companion button that sets the position, crop, and crop values of your DVE and Flying Key presets so you can quickly recall their original values during adjustment.

Splitting the Visual Editor and USK Settings

Tap on the Split Controls command in the toolbar to create two columns in the Upstream Keyers section. This provides an easy way to edit your Flying Key or DVE settings when editing the upstream keyers.

  • Column A: Luma, Chroma, Pattern, and DVE settings.

  • Column B: Flying Key and DVE editor

Note: This feature only works on iPadOS or on iPhones in Landscape orientation running MixEffect 1.7.0.

Set All Settings and Recording Macros

When you are recording a macro, the Set All Settings button will appear at the bottom of the page. Tap to record all settings for the selected USK into the macro.


In MixEffect 1.4.0, an Automations link appears at the bottom of the USK section or sheet. You can use this to quickly create a USK preset for the current keyer selected.

NOTE: This option will only appear if you have Enable Automations active in MixEffect Settings and if you have Enable Shortcuts or Enable OSC turned on.

  • Set Luma Details / Set Chroma Advanced Details / Set Pattern Detals / Set DVE Details: Tapping the Add to Siri button will create a shortcut that uses appropriate action for the currently selected keyer.

  • Send OSC Message: Tapping the Add to Siri button will create a shortcut that uses the Send OSC Message to send the appropriate USK message to MixEffect.

  • OSC: If you prefer to enter the OSC commands directly into Companion, this section shows you exactly what you need to enter. For commands with multiple arguments, be sure to choose the Send message with multiple arguments action when using the Generic OSC module.

  • Use Custom Animation: Toggle this on if you want to animate between the current settings to the saved settings in the shortcut or OSC call.

  • Duration: Specify the amount of time to perform the animation in milliseconds from 0 to 10000 (i.e. 10 seconds).

  • Style: Choose an animation style that will be used to perform the transition. These styles are the same as in the SuperSource Transition Style.

Last updated