StageDesigner

Black screen with a Syphon or NDI source

What to do when an LED screen in the scene stays black even though a Syphon or NDI source is assigned.

3 min read
Documentation contents ▾

A screen in the scene displays whatever the source sends. A black image means that frames are not arriving or the graphics card cannot accept them. Syphon works only on macOS. In the Windows release, NDI and Spout sources are not available; there you get video from Resolume through the REST API.

Check in order

  1. Make sure the source program is sending video. In Resolume turn on the Syphon or NDI output and check that the composition is playing something.
  2. In the screen inspector, in the source section, click Detect sources and select the source from the list again.
  3. Turn on Render statistics (Project settings → Render → Image quality). In the overlay, in the Video sources part, check input fps. Zero means frames are not arriving.
  4. If the overlay shows the warning over GPU limit, the source has a higher resolution than the graphics card accepts in a single texture. See the section below.
  5. Run Help → System diagnostics… and check the Syphon (macOS), NDI runtime and Local network items.

Source too large for the graphics card

Every graphics card has a maximum texture size. A Resolume output for a wide LED wall can be more than 10,000 pixels wide. Such a frame does not fit in the card’s memory and the screen stays black with no other message. In that case the app skips uploading the frame and shows the source name in the statistics overlay.

  • In the statistics overlay change source scaling to a lower value (max 1280 px, max 1920 px, max 2560 px or max 3840 px). By default the app scales the frame down to 2560 px on the longer side. The full resolution option turns scaling off.
  • Lower the output resolution in the source program or split it into several outputs for separate screens.

Syphon: what the app does on its own

Syphon reception runs in a separate process. If that process stops responding or closes, the app restarts it on its own and restores the connections to the sources. Usually you only see a short break in the image. Video from Resolume also comes back when you reopen the project, without restarting the app.

When the reception process crashes many times in a row, the app stops restarting it so it does not overload the computer. In that case:

  1. Select the Syphon source in the screen inspector again. This starts reception from scratch.
  2. If the image does not come back, close and reopen the project.
  3. As a last step, restart StageDesigner, and then the source program.

NDI: the source does not appear in the list

  • The sending and receiving computers must be on the same local network. Diagnostics shows Warning for the Local network item when there is no active interface.
  • On macOS allow the app to access the local network when the system asks. The Local network permission (macOS) item in diagnostics reminds you about this permission.
  • NDI discovery takes a few seconds. A source that disappears briefly is marked as offline and is not removed from the screen assignment right away.
  • If the NDI module caused a crash on the previous launch, the app skips it at startup. In the NDI sources section click Refresh NDI sources to try again.
Did not find the answer?
Describe the problem and we will reply with a solution or add an article.