Open Stage Control
Open Stage Control is a free and open-source software, distributed under the GNU/GPLv3 license, for creating control interfaces that interact with software and devices that use the Open Sound Control message protocol.
We include an executable version of Open Stage Control, with minor modifications to work with the Igloo Core Service, in our Igloo Core Service installer. See the Credits section for more info.
Sessions
Please read the open stage control documentation for help with creating sessions using its editor.
Sessions can be authored using another copy of Open Stage Control on any device, and then provided to the service to load them. The included version is hosted on the media server’s port 802 by default (see below for configuration options), and so is accessible in native browsers at http://localhost:802 for debugging, or to custom Igloo Control Panel browsers at the same address.
A default session is provided as an example, but any Open Stage Control session can be loaded. In the current version, only one session can be loaded per machine.
See https://docs.igloovision.com/documentation/1.4.0/configuration#id-(1.4.0)Configuration-openStageControl for details.
Themes
A default Igloo theme is applied to Open Stage Control sessions loaded through the service. This provides default values to any session - if any auto values are overridden while authoring a session, then the theme won’t be applied to these styles.
See https://docs.igloovision.com/documentation/1.4.0/configuration#id-(1.4.0)Configuration-openStageControl for details about configuring themes.
Authoring
Refer to the Open Stage Control documentation for help with creating sessions.
Igloo Control Panel
A pre-configured, non-default Igloo Control Panel application is provided for viewing and interacting with Open Stage Control sessions. This can be shown in the apps tab by adding the openStageControl key to your config.json. The default session is configurable, as described above.
You can also create custom browsers, or override the default browser, to change how the app is presented to the user. See Igloo Control Panel browsers for more details.
Credits
Open Stage Control License: Copyleft © Jean-Emmanuel Doucet @ AMMD 2014-2022. This program is a free software released under the GNU/GPL3 license.
Contributors: https://github.com/jean-emmanuel/open-stage-control/graphs/contributors
How It’s Included
Launcher Utility: our binary does not contain the full source code of Open Stage Control. Instead, it includes a utility that launches an executable version of the modified Open Stage Control.
Executable Creation: We use pkg to package the Node.js version of Open Stage Control into a standalone executable, eliminating the need for a separate Node.js installation.
Modifications Made
Our modifications to the original Open Stage Control include:
Port Limitation Removed: The restriction that required ports to be ≥1024 has been lifted.
mDNS Advertisement Removed: mDNS advertisement functionality has been removed.
Logging Changes: Logging has been updated; for example, QR codes are no longer displayed in logs.
Argument Handling: We override argv to ensure arguments are passed reliably.
These changes enable a seamless integration with our api communication module, default theme, and session within the Igloo Core Service.
Licensing & Source Availability
The executable is still covered under GNU/GPLv3.
Our modifications and integration process are tracked in our public fork of the Open Stage Control repository (v1.21.0).