Troubleshooting
The designer
The preview is black or the page says WebGL is not available. The designer needs WebGL2. Use a current Chrome, Edge, Firefox or Safari, and make sure hardware acceleration is on in the browser's settings. A remote desktop session or a very old integrated GPU may not offer WebGL2.
Playback stutters. Open the Timeline's Settings panel: lower the Live resolution, set Quality mode to Balanced or Performance, turn on Preview videos from proxies, and check the playback stats panel for the effect that costs the most. Renders and the projector window are not affected by the preview size.
An effect looks tiny, or huge. Set the real house size in Setup, then use the effect's own Effect size slider.
Light is landing on the sky, the hedge or the windows. The silhouette is the house model: anything outside it is black. Trace the missing wall, mark the windows as openings, or widen the face. Show full frame in Align temporarily ignores the silhouette so you can see the whole output.
The picture is off the building by a little. Fix it in Align with the corner pin, not by moving the model. If the projector has been bumped, that is all that changed.
Another tab or an AI assistant changed this show. A show open in two places shows a notice beside the save status. Load latest takes the other version, Keep mine keeps yours, and every version stays in Revisions.
The projector window
The projector window is a mirror of the designer, with the panels. That is the wrong window. Open it from Display → Open projector window, drag that window onto the projector and press F.
It stops when the laptop lid closes or the screen dims. Turn off sleep and screen dimming while the show runs, or use a player box.
The player box
The pairing code never appears. Give the box a minute after the installer finishes; on a desktop install it reboots once first. If the projector shows the Ubuntu console instead, the box did not switch to booting to a console: run the install line again. On Windows, make sure the PC is signed in; the player runs as the signed-in user.
The display shows Offline. The box cannot reach the internet. It keeps following its schedule on its own, and your changes arrive once it is back. Check the Wi-Fi or cable, and that the box is on. Settings → General shows its local IP for SSH when it was last seen.
A playlist does not start, or an old one keeps playing. A new playlist plays only once every file is on the box and checked. Open Settings → Logs to watch the download. A big render on a slow connection can take a while; the previous playlist keeps playing meanwhile, and the switch happens between items.
The projector does not wake for the show. The box turns the HDMI signal off between shows. A projector that does not wake when the signal comes back needs Forced start in Screens & sound. See HDMI off and waking the projector.
No sound, or sound from the wrong place. Screens & sound → Sound: pick HDMI (the projector's own speaker), the headphone jack, or a Bluetooth speaker, and press Test to hear a tone on the chosen output.
The wrong show plays at the wrong time. Check the display's time zone in Settings → General and the Clock line in Now. The schedule runs in the box's time zone.
Cast this show, TV & web or the Turtle card say the box has no browser.
The box was installed with --no-live. Run the install line again without it.
Games or Live Mode say the agent is too old. Press Update now in Settings → General. A box too old to update itself needs the install line run on it once more.
Removing a player from the box. See Remove a player.
The desktop app
Windows protected your PC / cannot be opened because it is from an unidentified developer. The app is not code-signed yet. Windows: More info, then Run anyway. Mac: System Settings → Privacy & Security → Open Anyway. See Desktop app.
Signing in does nothing. Choose File → Sign in with your browser… and finish the sign-in in the browser page that opens; the app picks it up when the page says so.
Still stuck
Ask in the Discord: say which browser or box, what you expected and what happened, and attach a screenshot or the lines from Settings → Logs. Help → Send feedback in the designer reaches us too.