Manual
What this is
GPI-Psychic is the "brain" that sits between your video switcher (like vMix) and physical tally lights on your cameras. When a camera goes live (program) or gets selected next (preview), this app notices and tells the correct tally light to turn on — over a radio connection, not venue Wi-Fi. You interact with it entirely through this dashboard: see every device, rename things, change colors, and wire inputs to outputs.
The radio link is the point. Venue Wi-Fi is the thing that fails on show day, so nothing on the tally path depends on it: the coordinator and the transceivers talk to each other directly, and keep doing so whether or not the building's network is having a good night.
How it fits together
Five words cover almost everything in this app. They are worth reading once, because the whole dashboard is built out of them.
- Tally Transceiver — the camera-side hardware: a light and a button, talking over the radio mesh. One per camera.
- Coordinator — the USB radio stick plugged into this computer. It relays between this app and every Tally Transceiver, and it is the only piece of radio hardware attached to the PC.
- Device — anything with inputs or outputs: a Tally Transceiver, an external connection like vMix/OBS/TSL, or a virtual device you made up. Each one gets a card on the Devices page.
- Input — something that reports a state. A switcher's program bus, a button on a transceiver, or a virtual input you drive from a Stream Deck over a webhook URL.
- Output — something that shows a state. Usually an LED on a Tally Transceiver.
Wiring is what connects them: you wire one or more inputs to an output, and the output turns on when its inputs say it should. Which inputs have to agree is the output's gate — OR (any input on), AND (all of them), NOT (inverted), or XOR (exactly one). OR is the default and is what you want almost always; the others exist for the cases where it isn't.
Wiring is many-to-many on purpose. One switcher input can light several transceivers, and one transceiver's light can be fed by several sources — a camera that is live on two switchers, say. Do it a pair at a time on the Matrix page, or in bulk from an input's or output's editor.
Troubleshooting
- Radio mesh won't connect — check the USB radio is plugged in, then open Setup → System and read the Coordinator line: it names the port in use and the reason it last failed. If the port is wrong, "Reconfigure Server & Hardware" reopens the setup screen, where you can rescan and pick the right one.
- Server unreachable — the backend process isn't running or crashed; restart it from a terminal (or the desktop app, which restarts it automatically).
- An external connection shows "disconnected" — check that the host/IP and port in its device settings still match the real device, and that it's reachable on the network.
- A transceiver shows "offline" — it hasn't been heard from in a while. Check it has power, then that it is on this system's radio network: Setup → Radio shows the mesh's identity, and a brand-new board has to join through a pairing window before it can report in at all.
- A light is on and nothing explains why — open that output in its editor and look at what's wired to it. An output shows the result of its gate, so an unexpected light is nearly always an input you forgot is wired, or a gate that isn't the OR you assumed.