StageDesigner

Connecting to Resolume

Connecting through the Resolume Web Server, automatically matching an Advanced Output preset to the playing composition, inserting screens from slices, assigning a slice to a screen and controlling columns from the project.

6 min read
Documentation contents ▾

What the integration gives you

The Resolume integration is optional. Once connected, the app reads the composition name and resolution, layers, columns and clips from Resolume, and takes the screen geometry from Advanced Output presets (XML files). The image reaches the app over NDI, Syphon or Spout.

Everything is in the Resolume panel (⌘ 9, or ⌥ 9 in the browser), arranged in working order: Connection, Live Matching and Advanced Output File (XML).

Connecting through the Web Server

  1. In Resolume, open Preferences → Webserver and turn on the server. The default port is 8080.
  2. In StageDesigner, open the Resolume panel, Connection section.
  3. In the Address field, enter 127.0.0.1 when Resolume runs on the same computer, or the network IP address of the computer running Resolume.
  4. Check the Port and click Connect (Enter in the address field also connects). The status changes to Connected with the Resolume name and version.
Connect automatically
Connects to Resolume when the project opens.
Refresh composition data
Fetches the name, layers, columns and clips again.
Disconnect
Ends the connection.
Composition
Name, Layers, Columns, Clips, Outputs, Slices.
Live sources
Status of NDI and Syphon (macOS) or Spout (Windows).

The same form is in the Resolume Connection tab that sticks out from the bottom of the window on the right. A dot on the tab shows the connection status, and once connected the composition name appears next to it. Clicking slides the panel out, Esc or a click outside hides it.

Once connected, the app refreshes the composition every few seconds, so column changes in Resolume show up in the project without manual refreshing.

Smart import: live matching

Once connected, the Live Matching section searches the Advanced Output presets in the default Resolume folders (in Documents: Resolume Arena or Resolume Avenue, subfolders Presets/Advanced Output) and matches them to the playing composition. It looks at matching resolution, name similarity and how recent the file is.

  • When the match is certain, the preset loads on its own. You see its name and the loaded automatically tag.
  • When no preset matches, a warning appears. Save the layout in Advanced Output (Save) or load the file in the section below.
  • When the loaded preset has a different composition resolution than the one playing in Resolume, a warning says the layout may be out of date.
  • The app detects the Resolume video source (Syphon, Spout or NDI) and assigns it to the screens automatically.

Comparing the preset with the scene gives these buttons and tags:

Insert screens (N)
Inserts only the slices that are not in the scene yet, in the Advanced Output layout and with the source connected.
Update (N)
Applies the new preset geometry and slices to existing screens. The screen positions in the scene stay the same.
in scene
Slices that already have an unchanged screen.
deleted in Resolume
Screens whose slice has disappeared from the preset.

Every dozen or so seconds the app checks whether the preset has been saved again, and if so, reloads it in the background. The Rescan presets and match again icon forces a scan right away.

Advanced Output File (XML)

The Advanced Output File (XML) section also works without a connection and in the browser. The Recently saved in Resolume list shows presets from the Resolume folders, and the load button lets you pick a file manually.

After loading, the outputs and slices appear as tiles with resolution, aspect ratio and approximate size in meters. Click selects a slice, dragging a tile onto the scene creates a screen at the drop point. The Add to scene button on a tile inserts the screen immediately.

Importing a whole preset is also in the menu:

FileImportResolume Layout (XML file)…

The Import Screens from Resolume (Advanced Output) window turns each slice into a screen. Choose the Preset (or Choose file…), the Video Source for all screens and the Enabled slices only toggle. The Add N screens to scene button adds the screens, and Replace all screens… deletes the existing screens and their source assignments (the operation can be undone).

Slice on an existing screen

In the screen Inspector, set Source type to Resolume Arena. Without a connection, use the Advanced Output (XML file) group:

  1. In the File field, choose a saved preset.
  2. In the Full output signal field, choose the NDI, Syphon or Spout source with the full Resolume output image.
  3. In the Slice field, choose a slice or click it on the map in the Slice mapping preview group. The app crops the signal to the slice region, and the screen name and aspect ratio are set automatically.

The mapping preview shows the composition size, the slice, its position, the UV range and Cropped live image. A screen with a slice has a Slice from Resolume file group in the Video Source section, with the XML file name, slice, output and resolution.

The context menu of such a screen has the Refresh from Resolume, Change slice…, Next column and Previous column commands.

Column control

When the connection works and the composition has columns, a Resolume column bar appears at the bottom of the window. A column tile shows the name, the number of clips and a LIVE tag on the active column. Clicking a tile triggers the column in Resolume.

  • The bar has collapsed, compact and expanded modes, plus an option to hide at the edge.
  • The arrows at the ends of the bar and the mouse wheel scroll the columns. The previous and next column (LIVE) buttons switch the active column.
  • Skip red skips columns marked red in Resolume. The color is read directly from Resolume.
  • The sync and refresh buttons reconnect and fetch the composition again.
← / →
Previous / next column (also while editing, outside the drawing tools)
S
Skip red columns (in presentation mode)
⌘ Shift P / Ctrl+Shift+P
Start presentation

In presentation mode the bar turns into a floating operator console with an option to hide after 5 s of inactivity. The client watches the 3D scene while you run the show from one window.

Did not find the answer?
Describe the problem and we will reply with a solution or add an article.