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    

Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Introduction Video

The following video is an introduction to mimoCall. In case you need in depth information please read the instructions further below.

mimoCall Overview

The mimoCall source is a way to bring in one or more remote correspondents for an interview or a panel discussion.

  • In mimoLive, set up a mimoCall source for each correspondent.
  • Share the URL of the mimoCall source with your correspondents. mimoLive provides a handy invite function that allows you to use Messages, Mail and many more services for sharing.
  • Your correspondents then open the URL in Google Chrome or any other supported web browser (unfortunately Safari is not yet supporting the necessary WebRTC standard).
  • Your correspondents will connect to mimoLive on your Mac where you can use their video and audio in any layer that supports a video or audio source. There are several layers for interviews and panel discussions, for example the Video Switcher.
  • The correspondents will receive the mimoLive program output and a N-1 audio mix, so they can hear everything but themselves.

mimoCall Source And Video Switcher

When using mimoCall Sources in a Video Switcher layer, don't forget to add Audio Only layers for each mimoCall source because otherwise you won't hear the callers.

Authentication

Boinx ID

Using mimoCall requires a Boinx ID. If you have not yet created a Boinx ID, click here to get started.

In order to be able to create a mimoCall source and initiate a mimoCall you need to log into your Boinx Connect account in the mimoLive Preferences. This login is needed to let our backend do the handshake between the host and the caller.

You have multiple choices to sign up with Boinx Connect:

  • Google account
  • Twitter account
  • Facebook account

Or you can create a Boinx Connect account with your own login credentials as shown below.

After you successfully logged in, you need to authorize mimoLive to create mimoCall channels on your behalf:

Creating a mimoCall Source in mimoLive

Now that you are sucessfully logged into your Boinx Connect account you can create a mimoCall source in mimoLive:

  • Click the + button on the top right of the Source Library on the far left in the mimoLive document window. A list of source types will pop up in a window.
  • Find the mimoCall source template and drag it into the Source Library.

Settings

A mimoCall source has several options to control its features:

Revoke mimoCall ID

Each mimoCall source has a global unique mimoCall channel represented by a mimoCall ID consisting of three random words. If you think that you need a new mimoCall channel and the old one shouldn't be used anymore for any reasons, you can revoke the mimoCall ID by clicking on the reload button right next to the mimoCall ID. After a moment a new mimoCall channel will be opened and you receive a new mimoCall ID. The old one gets archived and can't be used anymore.

Audio Gain

You can adjust the audio level of each mimoCall source individually to level out all the callers. Use the slider to adjust the gain level.

Inviting a Correspondent

The correspondent needs to get a mimoCall ID in order to establish a connection. This ID is transmitted as part of a HTTP link. This link can be clicked by the caller and the mimoCall web client will open automatically.

To send this link you have two options:

  • Copy Invitation Link: Copies the link to the macOS paste board. Now you can paste the link into any communication channel you prefer.
  • Share Invitation Link: Opens a popup with the standard sharing destinations on macOS.

Providing Audio To The Moderator

While your mimoCall correspondent receives the program mix minus their own audio, the moderator in the studio needs to be set up differently. The best way to do that is to use the Monitor Mix and feed it into an earpiece. You can set up the Monitor Mix to not include the moderator's audio by choosing Configure Monitor Mix from the action wheel button next to the volume meter:

Then, Mute the audio from the moderator. This will remove the audio from the Monitor Mix but the Program Mix will still include it.

Using the mimoCall Web Client

TDB because it's a moving target :-)

Troubleshooting the Connection

The mimoCall Web Client provides a full range of information about the connection quality that is available

Outgoing vs. Incoming

The right hand column (Outgoing) describes the connection from your computer to mimoLive. The left hand column (Incoming) gives information about the connection from mimoLive to your computer.

Bandwidth

Image Dimensions

Frame Rate

Supported Clients

Currently, we recommend to use Google Chrome as the client for mimoCall. WebRTC is mainly sponsored by Google, Mozilla and Opera. Safari is not yet supported, but its WebRTC implementation is in the works. See the list of supported browsers.


What's Next

Please read the following article to learn how to work with sources in mimoLive:

Sources and the Sources Repository
Audio Output and Monitoring
Audio Only

mimoCall