Congregation Screen Issues
| Symptom or Error Message | Root Cause | Step-by-Step Remedy |
|---|---|---|
| Clicking "Open as window" does nothing | The browser blocked the pop-up window from opening automatically. | Look at the right side of your browser address bar for a blocked pop-up icon. Click it, select Always allow pop-ups from this site, and click the projection button again. |
| External projector does not appear in "Project to" menu | Window Management permission was denied, or the external display is set to Duplicate mode instead of Extend in Windows. | Press Win + P in Windows and select Extend. In Chrome or Edge, click the site settings icon next to the address bar, ensure Window management is set to Allow, and reload the console. |
| "Congregation screen active" shows, but screen is blank | Blackout mode (B) is active, or the current slide has no visible text elements. | Press B on the keyboard or click Blank in the console to restore active slide projection. |
Guest HDMI Capture Issues
| Symptom or Error Message | Root Cause | Step-by-Step Remedy |
|---|---|---|
| "Permission denied" when arming capture | Camera permission was refused in the browser, or the page is running over unencrypted HTTP. | Ensure the application is accessed over HTTPS or localhost (the browser blocks media device access over plain IP addresses like http://192.168.x.x). Click the padlock icon in the address bar and allow camera access. |
| Capture device dropdown is empty | The USB UVC capture card is disconnected, or Windows Camera Privacy Settings blocked desktop apps. | Unplug and reinsert the USB capture card. Open Windows Settings → Privacy & Security → Camera, and ensure Let apps access your camera is toggled On. |
| Guest video projects, but no sound is heard | Audio routing through the browser is deliberately unhandled to prevent audio latency and drift. | Connect a physical 3.5 mm audio cable from the guest laptop directly into the church sound system or audio mixer. |
Phone Remote Issues
| Symptom or Error Message | Root Cause | Step-by-Step Remedy |
|---|---|---|
| "Invalid or expired pairing code" | The 6-digit code expired (codes are valid for 60 seconds) or was mistyped. | Click the Remote code badge in the operator console header to generate a fresh 6-digit code, and enter it into your phone browser within 60 seconds. |
| Phone browser shows "Unable to connect" | The phone is on mobile data instead of church Wi-Fi, or client isolation is active on the router. | Connect the phone to the same church Wi-Fi network as the WorshipDeck computer. Verify your router allows peer-to-peer traffic between wireless devices. |
| Remote controls do not respond on desktop installer | The desktop installer binds to 127.0.0.1 (loopback only) and does not accept external network connections. | To use the phone remote over Wi-Fi, run WorshipDeck on your server computer via npm start, which binds to 0.0.0.0. |
Parser and Regex Errors
| Symptom or Error Message | Root Cause | Step-by-Step Remedy |
|---|---|---|
| "invalid regular expression: lookaround not supported" | The pattern contains lookahead or lookbehind assertions (e.g. (?<=...)), which are rejected by the RE2 engine. | Rewrite the expression using standard capturing groups (e.g. Prefix:\s*(?<value>.+)) instead of lookbehind assertions. |
| Field extracted as empty string | The regular expression matched the line, but did not populate a group named value or a valid first capture group. | Test the pattern in the Rundown Test Area & Sandbox (Card B) and verify that the target content is wrapped in (?<value>...). |
| "missing required placeholder" | A layout element is marked required, but the corresponding parsed token had no value. | Open the service form and enter the required value manually, or uncheck the required flag in the layout canvas editor. |
PowerPoint Export and Fonts
| Symptom or Error Message | Root Cause | Step-by-Step Remedy |
|---|---|---|
| Warning: "Font does not permit embedding" | The uploaded font's TrueType OS/2 table prohibits embedding under its commercial license. | WorshipDeck automatically substitutes Inter in the exported presentation to avoid licensing violations. To use custom fonts, install open-source fonts under the SIL Open Font License or Apache 2.0. |
| Exported slides open with shifted line breaks | The destination computer uses a different display scaling factor or lacks the required font. | Ensure the font was embedded during export, or check Enforce exact canvas line breaks in the PowerPoint download dialog on the Run Sheet. |