Q-SYS Plugin for SpinetiX players
Introduction
The SpinetiX Elementi plugin for Q-SYS Designer allows users to trigger content on DSOS players directly from a Q-SYS Core, using Shared Variables stored in the player's local storage. This enables seamless control of digital signage content from a Q-SYS touch panel or UCI without additional middleware.
The plugin communicates with the player over the network using the Web Storage REST API and is compatible with all DSOS players that support the Network API (requires firmware 4.3.0 or later).
The SpinetiX Elementi plugin is available in the Q-SYS Designer Asset Manager. For more details, demos, and documentation, visit www.spinetix.com/qsys or contact our pre-sales team.
Prerequisites
- A DSOS player (except for HMP300 and DiVA) running firmware 4.3.0 or later
- Elementi 2023 or later
- Q-SYS Designer Software with the SpinetiX Elementi plugin installed from the Asset Manager
- Player and Q-SYS Core on the same IP subnet
Step 1 — Configure the player
Open the Control Center of the player.
Update the firmware
From the Control Center home page, check the current firmware version. If an update is available, click Update Now and wait for the player to restart.
Configure the network
Go to the Network settings page and ensure that the player and the Q-SYS Core are on the same IP subnet, or routable to each other with the relevant ports accessible. Make changes if needed.
Enable the Network API
Navigate to Advanced Applications → Network API and enable the following options:
- Enable secure server
- Enable legacy unprotected server
Set the interactivity latency
Navigate to Advanced Applications → Interactivity and set Maximum rendering latency to 250 ms.
Note:Step 2 — Create the Elementi project
Open Elementi and create a new project.
Add the Action to Switch widget
From the Widgets tab in the Browse panel, open the Interactivity collection and drag the Action to Switch widget and drop it into the Edit panel. The widget is automatically copied within your opened project.
Double-click the widget's layer to open it.
In the widget Properties tab, set the Shared Variable name, for instance sv.
You must use the same name later in the Q-SYS plugin.
Add content to the Mappings
Open the Mappings tab. Each row associates an action name (left column) with a content layer (right column):
- The first row defines the default content — no action name is required, but assigning one (e.g.,
default) allows Q-SYS to return to it explicitly. A transparent text layer or a looping video are common choices for the default content. - Add one row per content layer to trigger. In this example, add two video layers and name their actions
video1andvideo2.
Supported layer types include video, image, audio, HTML, streaming, and alpha channel content.
Optional: Test with the Developer Console
If you have Elementi X, you can verify the setup before publishing:
- Close your Elementi project.
- Open the Developer Console using Menu ▶ Settings ▶ View on the toolbar.
- Re-open the project.
- Click on the Shared Variables tab in the Developer Console.
- Locate the variable (e.g.,
sv) and set its value to each of the action lables set above (e.g.,video1,video2) — the corresponding content should be triggered.
Publish the project
Publish the project to the player directly from Elementi or send it to Arya.
Step 3 — Configure the Q-SYS plugin
Add the plugin
In Q-SYS Designer, add the SpinetiX Elementi plugin from the Plugins panel (right side). The plugin is available in the Q-SYS Designer Asset Manager.
Connect to the player
Open the plugin block and go to the Setup tab. Enter:
- IP Address: the player's IP address
- Username and Password: the Control Center credentials
Once connected, the plugin displays the player model, serial number, firmware version, and device name under Device Status.
Open the Shared Var 01 tab and enter:
- Shared Variable: the name used in the Elementi project (e.g.,
sv) - Action Names: one per row —
default,video1,video2
Each action name gets an Update button and a State indicator.
Step 4 — Test and deploy
Press F6 in Q-SYS Designer to start emulation.
Click the Update button next to each action name — the corresponding content should trigger on the player in real time.
Once verified, add the Q-SYS Core and touch panel to the design and copy the Update buttons into a UCI.
Notes
- The plugin communicates over the local network. Devices must be on the same IP subnet, or routable to each other with the relevant ports accessible.
- Static IP addresses are recommended for players used in production installations.
- Up to 50 action names can be configured per Shared Variable slot in the plugin.
- Multiple Shared Variable slots can be added to control independent Action to Switch widgets within the same project or across projects.