Control Your Show Remotely
Sometimes, it is convenient to control your show from an interface other than Millumin on your computer. Or even using a specific interface to easily access certains features.
This tutorial shows a few examples, but of course the possibilities are endless.
Simple Interactions
Millumin supports various protocols and standards : MIDI, OSC, DMX, Artnet, sACN, gamepads, … More info on this article : Interactions
For example, if you want to control Millumin via a MIDI device, interactions should be sufficient for you.
You could also use a small PowerPoint remote, a gamepad (such as the Nintendo Switch JoyCon), or a more sophisticated system such as the DSAN PerfectCue.
Scripts
The scripts in Millumin are quite powerful to control it.
For example, you can use the onOSCEvent function to get OSC message in your script, then performs a complex task. You can also get content from Internet with getURLContents function.
There a few examples in Millumin’s library. More info in this article : Scripts
TouchOSC
TouchOSC is a cross-platform application to create custom interfaces. It shows its true power on your iPhone/iPad/Android, and allows you to control Millumin from there. So no need to be in the front of your computer any more !
Installation
We will use an iPhone in this tutorial, but the same applies to an iPad and an Android :
- First, be sure your computer and your iPhone are on the same Wifi network. If you do not have one around you, create your own from your computer.
- Download TouchOSC for your iPhone
- Download the templates below :
- Connect your iPhone to your computer, then upload the template for iPhone :
![]()
- Open TouchOSC on your iPhone, then load the template :
![]()
![]()
![]()
- Setup OSC connection in TouchOSC :
![]()
- Setup OSC connection in Millumin :
![]()
- Then press the
▶︎icon to play the template (you may have to scroll with your finger on the toolbar) and control Millumin !
Customize
While you can edit your template within the TouchOSC version for iPhone, it is far more convenient to do so from the desktop application :
Please refer to the OSC documentation here to learn more about messages to control Millumin.
Legacy Versions (MK1)
If own an old version of TouchOSC, also called TouchOSC Mk1, you can use these templates with Millumin V2 (or later) :
🔗 TouchOSC_MilluminV2_templates.zip
For Millumin V1, use these templates :
🔗 TouchOSC_MilluminV1_templates.zip
StreamDeck + Companion
The Elgato Stream Deck is an USB keypad : each button is programable with its own action and display. Thus, this is a handy device to control your show.
If you are using one, you probably want to use Bitfocus Companion to easily program it. It offers a lot of possibilities !
Also, it has an emulator, so you could quickly check if the Stream Deck may be useful for your workflow. Here are a quick tutorial.
First, launch Companion and Millumin. They should be configured as below :
Companion is web application, so it opens in your browser.
Add a connection called Millumin (if not present in the list, install the module from the tab called “Module”) :
And configure this connection as below :
Now, go to Buttons tab and select a button :
Set this button as a regular button then type next in the action field, so this button will launch the next column in Millumin :
Your action should look like this :
Lastly, click on emulator in the menu on the left to open it, and test your layout :
Of course, Companion can do so much more. For example, it has a variables section : these evolve in realtime and can be use to name your buttons.
Or use an expression such as secondsToTimestamp($(millumin:media_layer_elapsedTime),"mm:ss") to convert raw timestamp into a more human-readable format :
Note that you can also send custom OSC message : thus you could build interactions between your Stream Deck and Millumin, or use the OSC API.
Add the connection OSC Generic to do so :
Open Stage Control
Open Stage Control is a libre and modular OSC / MIDI controller, that can be used as a standalone application as well as on a mobile device's browser. In the same fashion as TouchOSC.
Installation
First, set the ports/IP in Open Stage Control. Here is an example if you run it locally :
Set the ports/IP accordingly in Millumin :
Then, click the ▶︎ icon and open one of the templates below :
🔗 OpenStageControl_templates.zip
The ColumnControl template is a simple show-control :
The LayerClock template shows the progression of a media :
The LayerClock (multiple layers) template shows the progression of multiple medias.
You can customize this template by duplicating a panel and changing its variables :
Please note that you can access the interface in a brower : try http://127.0.0.1:8000/
Customize
Press CMD+E to edit a template : you can add some more widgets as well as create variables and scripts. In brief, you can do a lot !
Please refer to the OSC documentation here to learn more about messages to control Millumin.
Chataigne
Chataigne is a free and open-source modular software by Benjamin Kuperberg. It supports a wide range of protocols to create simple to complex interactions.
To get a quick overview of Chataigne, you can read this tutorial : Setup a Backup Machine