Troubleshooting

Resolve live presentation, hardware capture, phone remote, and parsing issues quickly using diagnostic tables based on real application error messages.

Written for WorshipDeck 0.1.2

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.