Access Remote Control Surfaces and HTTP API Remotely

The Remote Control Surfaces and the HTTP API use a webserver built into mimoLive for communications. In order to access this from a remote location, the mimoLive webserver would have to be made accessible from the Internet using a public IP number. This is not such a good idea for security reasons.

Enter ngrok, a system that allows you to create a secure tunnel to your mimoLive host from anywhere in the world. This can be used to remotely issue API commands, remotely produce a show or have an assistant update lower thirds via a Remote Control Surface from their home office.

Installing ngrok

• Sign up for a free ngrok account. At time of this writing, the free account is sufficient for controlling mimoLive.

• Download and install the command line tool to your mimoLive machine following the instructions from the ngrok website.

*Make sure to connect your account using the correct authentication token as pictured in the screenshot.

• Now it is time to create the tunnel. It should end at the port for the HTTP API which you can set in mimoLive Preferences. The default is 8989, so that the command looks like this:

• Once the tunnel is established ngrok will return the URL under which you can now connect remotely to your mimoLive. Look for the line with “Forwarding”:

• Entering the address in your browser window will take you to the Remote Control Surface start:

That’s it! Now you can control mimoLive from remote using Remote Control Surfaces or the HTTP API.