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
- 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.
- In the screen inspector, in the source section, click
Detect sourcesand select the source from the list again. - Turn on
Render statistics(Project settings → Render → Image quality). In the overlay, in theVideo sourcespart, checkinput fps. Zero means frames are not arriving. - 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. - Run
Help → System diagnostics…and check theSyphon (macOS),NDI runtimeandLocal networkitems.
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 scalingto a lower value (max 1280 px,max 1920 px,max 2560 pxormax 3840 px). By default the app scales the frame down to 2560 px on the longer side. Thefull resolutionoption 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:
- Select the Syphon source in the screen inspector again. This starts reception from scratch.
- If the image does not come back, close and reopen the project.
- 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
Warningfor theLocal networkitem 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 sourcessection clickRefresh NDI sourcesto try again.
