mimoLive User Manual

The mimoLive User Manual Developer Hub

Welcome to the mimoLive User Manual developer hub. You'll find comprehensive guides and documentation to help you start working with mimoLive User Manual as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Remote Control Surfaces

mimoLive can be remotely controlled from any web browser using a built-in, freely customizable remote control user interface. Watch this demo to learn how to use it:

Creating a Remote Control Surface

In order to enable Remote Controls for mimoLive you need to switch them on in mimoLive -> Preferences -> Remote Controls: Check the "Allow Remote Control Access" option.

To open the mimoLive Remote Control Surface on the same machine, click the Open in Browser button in the Remote Control preferences or click on the toolbar button in a certain mimoLive document window:

To open the mimoLive Remote Control Surface on your tablet or on another computer, enter the URL shown below the "Allow Remote Control Access" option of the Remote Control Preferences.

After you opend the Remote Control in an internet browser of your choice you can choose which mimoLive document you want to control:

If you open the Remote Control Interface of a certain document for the first time, you will be prompted to create a new control surface:

The new surface will suggest a button grid size for your device. You can either change it here or later on in the Remote Control Surface Settings.

To keep an overview when using multiple control surfaces for a single document, we suggest giving them a short name.

After the creation of a control surface, you are presented with an empty grid which you can use to create your personal layout of buttons:

Adding a Button

In the Add Button column on the left, choose a layer from your document for which you want to add control buttons to your Remote Control Surface. As an example we chose the Video Switcher Layer. Now you will see different layouts this specific layer provides:

The suggested layouts for each layer may vary depending on settings you made in the mimoLive document. Thats why its important to finalise the mimoLive document before you design the Remote Control surface.

Drag a layout of your choice from left to right onto the Remote Control Surface:

You can add more buttons to the surface with the "+ Add Button" menu in the top left corner.

Edit Action Button

To change properties of each button you can select the action gear icon on that specific button to bring up the Edit Action Button panel:

To make the button easier to recognise, you can now give it a title, choose the background color and add an icon.

If you want to make it bigger, you can set the Height and Width of the button.

The Actions list lets you choose the actions the button will perform when pressed.

The Live State Indictor lets you select a layer or video source to show the live state of.

With Source Preview, you can select a video source of the mimoLive document to display a thumbnail from. Please note that this option effects the overall performance of mimoLive!

Setting up a Button to Trigger Multiple Actions

The most powerful feature of the Remote Control Surface is the ability to have a button trigger multiple actions, for example, to turn on a specific lower third each time you switch to a certain camera in the switcher or to turn off several layers and turn on other layers when ending a show.

To add an additional action, click on Add Action in the Edit Action Button panel seen above. To remove an action you no longer need, press the "x" next to it.

Deleting a Button

To delete a button you need to click the action gear icon of that button to reveal the Edit Button Action panel. At the bottom of this panel, you'll find the delete button. To keep you from accidentally deleting a button, you have to confirm the deletion a second time.

Save your mimoLive document to make the Remote Control Surface persistent!

The configuration of the Remote Control Surfaces is stored inside the mimoLive document. Make sure to save the mimoLive document after you created the surface or made changes to it otherwise those changes gets lost!

Using the Remote Control Surface

After you have modified the control surface to your convenience, you can enter Live Mode on the top right of the screen. A click (or tap) on a button triggers the associated action in mimoLive.

A Word On Performance

Some layers, like the video switcher, contain previews of their used sources which are displayed right in your browser. This can place a heavy load on the browser of the device you use for remote control. If you are experiencing performance problems on your remote control device, try to use fewer of the buttons that contain source previews.

Using Multiple Remote Control Surfaces

You can use more than one Remote Control Surface at the same time for one document. This allows you to distribute tasks among a team of editors. In a school, for example, you could have one student control the switcher, one the audio, one the graphics and lower thirds.

You can also use the same Remote Control Surface on multiple devices at the same time. Changes to one instance of the Remote Control Surfaces will automatically and instantly be propagated over all instances. This is especially useful for updating the Remote Control Surface when the layer stack in the mimoLive document is changed.

Remote Control App For iOS

If you want to use the Remote Control Surfaces on iOS devices, there are two ways:

  1. Open the URL in Safari or Chrome as described above
  2. Download the mimoLive Remote App from the App Store

mimoLive Remote App for iOS

Using mimoLive Remote App

When you start the mimoLive Remote App, it will look for running instances of mimoLive on the same network as your iOS device:

Select the mimoLive instance you want to control. After that, the app behaves just like the web-based remote control app.


What's Next

The Remote Control Surfaces are based on an HTTP API that allows you to create your own automation tools. See the HTTP API documentation for more details.

HTTP API

Remote Control Surfaces


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.