Temple B'nai Israel
TBI Overlays
Help
Short, maintained instructions for setup, services, accounts, and recovery.
How the three parts fit together
Which of centralreform.live, the web siddur and Overlays you actually need.
- centralreform.live is where the service is planned — the setlist, the charts, the band.
- The web siddur is what the congregation reads on their own phones.
- Overlays is what the congregation sees on the screen and on the stream.
- You need Overlays. You need centralreform.live only if you import a planned service. The web siddur needs nothing from you.
Set up a computer once
Pair Companion and connect the graphics browser, once per computer.
- An owner or editor opens Set up this computer, names the Companion computer, and presses Pair this Companion. Enter the six digits in Companion’s Pairing code field within 10 minutes: the module stores a Device token itself and clears the code. A code is single use and expires after ten minutes.
- Name the output computer and press Create an output connection, then Copy the graphics URL and paste it into a 1920 × 1080 browser input with transparency on. It keeps working after restarts, so nobody re-enters a key after a restart.
- Control key is the older shared key. Where it is set it is used instead of the device token, so a connection made before pairing existed keeps working untouched. Copy private output URL likewise still works, as the transitional path.
- A refused pairing code changes nothing: the previous credential stays and the refusal is shown as the connection status. Ask for a fresh code and try again.
Before a service
Confirm the system while the graphics input is off air.
- Open Companion and confirm the congregation’s Overlays connection says OK.
- Open the graphics browser input and check Health for a connected output.
- Inspect checks a graphic only in the browser. For the real signal check, keep the graphics input off air, then use Show on one short graphic and one long graphic, followed by Animate Out and Clear Now. Confirm the graphics input and composite monitor after each action.
- Keep the existing Singular input available until the physical rehearsal has passed.
During a service
Use the controls operators already know.
- Use the congregation-labeled Companion pages or Live control to select a graphic.
- Preview before Show whenever the service pace allows.
- Use Animate Out for a normal exit. Use Clear Now only when the picture must disappear immediately.
- If Library synchronization says pending, use the last known live graphics and resolve publishing after the service.
The scan card
The card with a QR code in the corner of the output.
- The scan card is set up for each congregation. Where it is not set up there is no card, and Live control does not show the control at all.
- On Live control, use Show scan card to put it up and Hide scan card to take it down. Page is an optional short label — at most twelve characters — shown beside the card.
- Clear now removes the scan card along with the graphic. Animate out leaves the card alone, because it acts on the prayer layer only.
- The card sits under the graphics, so a panel or lower third that reaches that corner covers it. It shows through wherever the graphic is transparent.
- From Companion, the actions are Bug on, Bug off and Set page, and the Scan card preset toggles the card and lights while it is visible.
Names for this service
Put a list of names on air for one service, without touching the library.
- An editor opens Prepared services, chooses the prepared service, and fills in Names for this service. Type one name per row. These names are not saved to the library and are removed when this service is archived.
- Name this list (for example, Mi Shebeirach). That title is what appears on air.
- Type a Hebrew name, an English name, or both. Either may be blank; both blank is refused.
- Names per panel is a whole number from 4 to 12, 8 by default. It decides how many people appear on one panel.
- Press Put these names in the library. Each panel is measured first: if one is too full the button stays disabled and the page names it, so shorten a name or lower Names per panel.
- The panels appear in the library as the title followed by 01 of 03, 02 of 03 and so on. Show them like any other graphic, and use Next panel to walk the set.
- Remove these names takes them out again. Archiving the service removes them in the same write, and restoring the service does not bring them back.
Return to Singular
A calm fallback when a new graphics path is not ready.
- Take the Overlays browser input off air.
- Use the unchanged Singular browser input and its existing Companion pages.
- Do not troubleshoot accounts, publishing, or provider settings during the service.
- Record what failed and the time, then check Health after the service.
After a service
Leave the next operator a known state.
- Clear the graphic and confirm the output is empty.
- Record any unavailable, pending, or fallback result in Service log while the context is fresh.
- Publish library edits only after reviewing their exact preview.
- Once a month, review provider usage and the latest recovery package with an administrator.
Accounts and handoff
Give each person their own access.
- An administrator opens Account and creates a one-use invitation for the person’s exact email address.
- Choose Operator for live use, Editor for library work, or Administrator only for people who manage access.
- The recipient opens the link within 24 hours and sets a password.
- Disable an account promptly when a person no longer needs access. Keep at least one administrator enabled.
- Companion installations and graphics outputs hold their own credential and are listed under Paired devices. Revoke one there when a computer should no longer control graphics; it stops at that device’s next reconnection, not instantly. To stop a picture at once, take the browser input off program at the switcher.
Backup and restore rehearsal
Prove recovery without touching the live service.
- An administrator runs the recovery export after material changes and before a major service. Store the package in restricted congregation storage.
- Run the bundle verifier before accepting the backup. It confirms the version and every file checksum.
- Restore only into a separate rehearsal database. The restore tool refuses production and refuses the live database URL.
- Open the rehearsal catalog, inspect at least one custom graphic and one source-linked graphic, and record the date and result. Never include passwords, sessions, invitation links, relay secrets, or output URLs in a bundle.
Recovery commands and file retention are documented in docs/RECOVERY.md for the administrator maintaining the deployment.