A TV display is a small monitor or smart TV mounted near each pool table that shows the live scoreboard, table info, and a QR code players can scan to pair their phone to the table for live scoring. The display is just a web URL — anything that can run a fullscreen browser (smart TV, Apple TV, mini PC, Fire TV) works.
Enable the TV Displays feature
- Open Account & Settings.
- Scroll to the FEATURES section.
- Make sure TV Displays is set to ON.
Get your TV URL
Each table has its own public TV URL.
- Open Account & Settings → TV Displays (under Features).
- You’ll see a list of your tables, each with a per-table URL and a QR code.
- Toggle Enable for each table you want a display on.
- Copy the URL or scan the QR code — that’s the URL you’ll open on the TV.
The URL pattern is:
https://phmapp.io/{your-venue-slug}/table-display/{Table-Label}?orientation=landscapeFor example:
https://phmapp.io/downtown-billiards/table-display/Table-5?orientation=landscapeOpen that URL in fullscreen on the TV’s browser and the display is live — no pairing or login needed. The page subscribes to your Firestore data and updates in real time.
What the TV shows
The display has several states it cycles through automatically:
- Idle (no players) — your venue logo and a Scan to Keep Score QR code that links to the player phone flow.
- Players seated, no game started — Ready to Play / Start a match from your phone.
- Active match — a full scoreboard with player names, scores, race numbers, timers, and a shot clock.
- OTP reveal — see below.
- Connection successful — Connection Successful! with the connected player’s name (visible for ~60 seconds).
- End of game — Thanks for Playing! / See you next time.
How players keep score from their phone
When a party wants to keep their own score, they scan the QR code on the TV.
- The player scans the Scan to Keep Score QR with their phone camera.
- The phone opens
phmapp.io/{slug}/play/{table}. - The player sees “Pairing with your table…” then “Look at the TV display for your access code”.
- The TV reveals a 6-digit access code displayed as XXX XXX, with a 30-second countdown bar.
- The player enters the code on their phone and taps Start Scoring.
- The TV briefly shows “Connection Successful!” and the player’s phone redirects to the live scoring dashboard.
Sending the dashboard URL by SMS instead
Sometimes a player can’t (or won’t) scan the QR. You can send them the dashboard link directly by SMS from the iPad.
- On the Floor, select the table.
- From the sidebar, choose Send Dashboard URL.
- Enter the player’s phone number and tap send.
- They receive a text containing
https://phmapp.io/t/{token}— and, if you’ve already revealed an access code, the code itself.
The short /t/{token} link takes them to a similar Welcome screen
that asks them to enter the 6-digit access code from the TV before opening
their dashboard.
Pairing an Apple TV (separate flow)
For native Apple TV displays (rather than a browser-based TV), there’s a separate pairing flow under Settings → TV Displays → Pair Apple TV. Open the Pool Hall Master app on Apple TV, note the on-screen pairing code, and enter it in the iPad — the Apple TV is then bound to your tenant.
This is independent from the per-player scoring access code described above.
Resetting all displays
If a TV looks stale or is showing the wrong table, you can force every paired display in your venue to reload.
- Open Account & Settings → Danger Zone → Reset All TV Displays.
- Confirm.
Each TV will refresh and re-subscribe to its table’s data.