Troubleshooting

Troubleshooting

The app

• macOS says the app is damaged: see Installation (xattr -cr).
• Windows shows "protected your PC": choose More info, then Run anyway.
• The window does not appear (from source): run npm start and read the terminal for errors.
• cargo: command not found: run source "$HOME/.cargo/env" or open a new terminal.

Links and other computers

• A link stops working after a restart: links contain a secret token that changes every launch. Copy the links again from Outputs.
• A link stops working when the network changes: the address in the link is this computer's address on the old network. The app updates its own links and shows a notice; paste the new link into OBS or wherever you used it.
• The remote display does not load: both computers must be on the same network. Re-copy the link and allow TCP ports 5510, 5511 and 8087 through the firewall. Guest Wi-Fi and router "client isolation" block it.
• Another copy holds the ports: the app moves to the next free ports, so the link changes. Quit the other copy to keep the same link.
• Other computers cannot be listed: the discovery port (UDP 5530) may be busy or blocked.
• The Network list has several addresses: pick the one on the same network as the other device.

OBS

• No sound from the Media link: tick Control audio via OBS on that Browser Source. Without it, the sound plays on this computer only.
• Sound plays twice: Sound in this app (Settings, Media and wall) should be off, so the sound comes from OBS only. Also check the Wall/LED is not playing the same media, and that no other source has &media=1.
• The Media link shows nothing: it stays empty until you press Play on stream in the Media workspace. Refresh the source in OBS after a restart.
• The verses do not show over media: media covers everything on its own source. Going live with a verse stops the media.
• A web page in Media is black or does not start: wait a moment; pages load in two steps. Pages from a pasted link run in a locked-down frame; pages from your own files can use their own storage.
• To see what a link's page is doing, add &debug=1 to its address.

Display and screens

• A screen was unplugged: the Wall/LED and output windows close cleanly and return by themselves when the screen comes back.
• Use Identify screens (Outputs, Screens) to see which screen is which, and Show test pattern to line up a projector.

Reporting a problem

Open an issue on GitHub. Say what you did, what you expected, and which system you use.