tsh Wallboard
A live results board for the TV in your tournament room, for directors who run tsh. It's one file, works offline and fits any screen.
The board is the one HTML file. The zip also includes these instructions as a text file.
What it shows
For each division, all on one screen:
- The current round, with unreported games highlighted and a count like "5 of 8 reported"
- The next round's pairings as soon as they're made
- Live standings that move as each result comes in, with tsh's estimated rating change
The text sizes itself to fill the screen, from a laptop to a big TV. If everything won't fit at a readable size, the divisions go on pages that rotate. A very large division gets one page for pairings and another for standings.
It only reads a file that tsh writes. It never changes tsh or your event files, and needs no internet connection or web server.
Setup
Do this once per event. It takes about two minutes.
- Tell tsh to save its data after every score and pairing.
Add these two lines to the event's
config.tsh:If your config already has either of these hooks, addconfig hook_addscore_flush = 'savejson' config hook_autopair = 'savejson';savejsonto the end of the existing line instead of adding a second copy, e.g.config hook_autopair = 'phonefeed;savejson'. Then restart tsh, which reads the config only when it starts. - Write the data file once.
In tsh, type
savejson(short form:json). That createstourney.jsin the event'shtmlfolder. - Put the board next to it.
Copy
wallboard.htmlinto that samehtmlfolder. - Open it on the display computer.
Double-click
wallboard.html. It opens in your browser (Chrome or Edge recommended). Press F11 for full screen.
If tsh runs on a different computer from the TV, the TV's computer needs to see the
event's html folder, e.g. a shared network folder or a synced Dropbox/OneDrive
folder. Open wallboard.html from there.
During the event
- The board checks for new data every 10 seconds and redraws only when something changed. The small box in the bottom-right corner shows when it last checked, and turns red if it can't read the file.
- Scores and automatic pairings update it by themselves. After anything that doesn't run the hooks,
type
savejson(json) in tsh. That includes pairing by hand withpair, forfeits withforfeitloss(floss), and some corrections. - The current round is the earliest one with a missing score. The board stays on it until every game is in.
- Keys:
rchecks now,spaceor→goes to the next page,←goes back.
Options
Add options after the file name in the browser's address bar. Start with ? and join
more than one with &, for example
wallboard.html?div=A,B&theme=dark. Once it looks right, bookmark it.
div=A,B | Show only these divisions. With two screens, give one div=A,B and the other div=C,D. |
min=20 | Smallest text size (in pixels) before the board splits into pages. The default is 16 on a 1080p screen. Raise it if people read the TV from across the room. Lower it to keep everything on one page. |
rotate=30 | Seconds per page when there's more than one page (default 20). |
theme=dark | Light text on a dark background. |
history=1 | Also show every earlier round's results. Good for short events. |
ratings=0 | Hide the rating-change column. |
numbers=0 | Hide player numbers after names (saves width). |
refresh=5 | Seconds between checks for new data (default 10). |
src=… | Where tourney.js is, if it isn't next to wallboard.html. |
Good to know
- Standings are kept simple: wins (ties count half), then spread. They don't apply spread caps, Gibson marks or special ranking rules. tsh's own standings reports remain the official ones.
- Board numbers, "1st/2nd" and repeat-matchup tags appear only when your event uses them.
- Nothing is sent anywhere. The board reads one file from your computer.