MixEffect Documentation

MixEffect

MixEffect Newsletter

MixEffect Community

Troubleshooting

Here is a list of troubleshooting tips and known issues with MixEffect.

Frequently Asked Questions

  1. Simulator not appearing. Go to Settings and toggle Enable ATEM Simulator off and on.
  2. Connection drops when switching apps in iOS: MixEffect works best when it is the frontmost application. iOS is very aggressive at suspending applications when they are sent to the background. This causes the connection between MixEffect and the switcher to be interrupted. Simply reconnect MixEffect to the switcher to start over again. Alternatively, you can turn on Guided Access and run MixEffect in single app mode. This improves performance by devoting more computing resources to the app. And, if the app does crash, it is automatically relaunched from the Home Screen.
  3. Choosing a server in the Live Stream tab of the Output palette ATEM Software Control on macOS and Windows does not pre-populate the stream key field if there is a matching server found in MixEffect with a set stream key. Shouldn’t MixEffect detect this and update the stream key for me? This is by design. Because other controllers may be connected to the same switcher, this could result in multiple controllers trying to change the stream key settings at the same time. The solution is to set the server used by the switcher from MixEffect.
  4. How many devices can be connected to an ATEM switcher? A single ATEM switcher has a limit of about five connected devices. This could be one copy of ATEM Software Control three copies of MixEffect, and one copy of Companion, for instance, or four copies of MixEffect and one copy of ATEM Software Control. If you find that MixEffect cannot connect to your switcher, verify that the number of connected controllers is below five.
  5. I installed MixEffect, but I don’t see any SuperSource presets. Go to the SuperSource, tap the View All Presets button (grid icon), tap the second grid icon in the View All Presets page, and choose Reset Presets. This will install the default presets back onto your device.

Known Issues

  1. Images with alpha channels uploaded to the Media Pool get their alpha channels stripped out. Known issue. Working on a solution, but no timetable.
  2. Images uploaded to ATEM switcher causes the switcher to get into a state requiring restart. Images uploaded to ATEM must be formatted to the exact size of the switcher’s video mode (e.g. 1920x1080 for 1080p). If the ATEM switcher cannot handle the uploaded image, it may reach a state where no button pushes are possible. Remedy is to restart the ATEM switcher.
  3. Keyboard Shortcuts stop working. When navigating between views, such as the SuperSource section page and the View All Presets page, occasionally keyboard shortcuts stop working when you return to the SuperSource home. To resolve, go to a different switcher section and return to SuperSource.
  4. Off-screen and enabled SuperSource boxes. If you have placed your boxes off-screen but still enabled, the touch target grows beyond the bounds of the preset thumbnail. This can lead to inconsistent tapping in the presets bar or the View All Presets page. Workaround is to make the boxes small to reduce the tap target or have them hidden.
  5. Unable to set labels for sources. On certain ATEM switchers, such as the older 1 M/E Production Studio 4K, users have reported an inability for labels to be set and saved properly by the switcher. Workaround is to set the labels in the ATEM Software Control app on macOS or Windows.
  6. When tapping the options menu from the Macros section, the menu appears and disappears. Here is a temporary workaround until the source of the bug has been identified: From the Switcher section, tap the Macros button. A sheet will appear that looks similar to the Macro section. Tap the options menu in the sheet and configure your Macro sort settings.
  7. Audio Meters are not showing up or updating. If this is happening for you, try going to the Audio section and tapping on the Audio Monitoring toggle in the upper-right. This will start or stop audio level monitoring from the ATEM switcher. If levels continue to not show up, please send a feedback request from the app in MixEffect Settings.

Network Stability

Under the hood, Blackmagic ATEM switchers employ the UDP protocol for communicating with controllers such as ATEM Software Control or MixEffect. Here is a brief explanation of UDP from its Wikipedia page:

UDP uses a simple connectionless communication model with a minimum of protocol mechanisms…. It has no handshaking dialogues, and thus exposes the user’s program to any unreliability of the underlying network; there is no guarantee of delivery, ordering, or duplicate protection…. UDP is suitable for purposes where error checking and correction are either not necessary or are performed in the application; UDP avoids the overhead of such processing in the protocol stack. Time-sensitive applications often use UDP because dropping packets is preferable to waiting for packets delayed due to retransmission, which may not be an option in a real-time system.

The connection between MixEffect and your ATEM Switcher may drop due to any number of factors, but one of them is too many unacknowledged packets. When this happens, MixEffect will disconnect. If you are viewing a switcher feature page such as a Switcher Page, Macros, Output, etc., the screen will go blank and say that you have been disconnected.

If you have Auto Reconnect enabled in MixEffect’s settings, MixEffect will automatically try to reconnect every five seconds.

Alternatively, you can go to the MixEffect Home and reestablish a connection by tapping on the desired connection.

There’s more tips on resolving connection problems on this page.


Reporting Bugs

If MixEffect is crashing consistently when performing a particular function, post a bug report in the MixEffect Community of your choice or send an email using the Feedback link in MixEffect’s Settings page.