StageDesigner

Live sources: NDI, Syphon, Spout

A live image from a media server, Resolume or another program: requirements for NDI, Syphon and Spout, NDI diagnostics and sharing sources with team members.

3 min read
Documentation contents ▾

Which protocol to choose

ProtocolSystemNotes
NDImacOS and WindowsImage over the local network, also from another computer. Requires an installed NDI runtime (NDI Runtime or NDI Tools).
SyphonmacOSImage from another program on the same Mac. Lowest latency.
SpoutWindowsImage from another program on the same Windows computer.

All three work only in the desktop app. In the browser you use a shared screen, a window or files.

Connecting a source

  1. Turn on the NDI, Syphon or Spout output in the sending program. In Resolume you do this in Advanced Output by choosing the appropriate output device.
  2. Open the Video Sources panel (⌘ 8) and click the refresh icon, or click Detect sources in the screen Inspector.
  3. Click the source in the panel with a screen selected, or choose it in the Inspector in the Source type and Source fields.
  4. Check Signal preview in the Inspector: the Signal indicator and the resolution mean that frames are arriving.

NDI detection runs in the background every few seconds. A source that briefly disappears from the network stays in the list as unavailable, so its assignment to a screen survives short interruptions. After a longer absence the source disappears from the list.

Resolume outputs are recognized by name and shown in the Resolume Arena group and in the group of their protocol. For a Resolume output the Inspector shows Signal status. The No new frames warning usually means that no clip is playing in the active column, or the NDI or Spout output is not sending.

NDI diagnostics

Set Source type to NDI in the screen Inspector. The NDI Sources list shows sources marked Available or Unavailable. The NDI Diagnostics group reports:

Status
NDI active, NDI module ready, scanning… or NDI unavailable.
NDI runtime
Whether the NDI runtime library has been loaded.
Library
Whether the app NDI module is available.
Detected sources
Number of available sources out of all those seen.
Last scan, Platform
Time of the last search and the operating system.

When there are no sources, the app suggests the causes: no NDI runtime (install NDI Runtime or NDI Tools and restart the app), Resolume not sending over NDI, or the Windows firewall blocking NDI traffic on the private network.

Resolution and smoothness

Large sources, for example the whole output of an LED wall, are downscaled before they are sent to the scene view. The default limit for the longest side is 2560 px. Very large frames also get a lower frame rate, because the 3D scene preview is not a playout path. The limit settings are described in the article Screen and video source performance.

Live sources in a team

When you work together on a cloud project, a source assigned to a screen physically works only on the computer that receives it (its NDI, its window, its file). The app sends the image of such sources to collaborators present in the project over WebRTC. Their screens start playing on their own, with the same assignment.

PawełOlaYouIn projectOLPWYOUVersion historyv18Paweł · lightingv17AI · seatingv16Ola · barsv15You · stage
Working together on a scene: collaborators present in the project. Sources used in the project are streamed to the other people.
  • Only sources that run locally and are used in the project (on screens, LED screens and equipment with a screen) are published.
  • When a source also runs locally on the receiving computer, it takes priority over the remote stream.
  • The connection sets itself up without extra configuration on the same company network or behind a simple router. A restrictive firewall can block the image streaming, although collaboration on the scene itself keeps working.
  • Each receiver gets a separate stream from the sender, so this works well for a few people.
Did not find the answer?
Describe the problem and we will reply with a solution or add an article.