SETUP & INSTALL GUIDE
Three pieces: one host phone to run the race, one phone per team as the timer, and a TV showing the live leaderboard. No accounts, no app store installs for phones - everything runs in the browser.
1. Host: Create The Race
- On any phone, open RACE CONTROL (the start page of this site).
- Enter a race name and press CREATE RACE. You get a 4-letter race code and two QR codes.
- Keep this page open - it is your start button and team list.
2. Teams: Phones Become Timers
- Each team scans the TEAMS: SCAN TO JOIN QR code with their own phone camera (or goes to this site, enters the race code and taps JOIN AS A TEAM).
- Enter a team name and pick a division (Singles, Doubles or Relay).
- That phone is now the team's timing chip. Keep it with the team for the whole race - in the Roxzone, a pocket, or with a supporter following along.
- After every run and every station, tap the big COMPLETE button. 16 taps = race finished. Mistapped? Use UNDO LAST.
If a phone dies or the page reloads, reopen the same link - the phone remembers its team and rejoins automatically.
3. TV: The Live Leaderboard
ANDROID TV / GOOGLE TV / FIRE TV (EASIEST)
- Open a browser on the TV. If none is installed, get one free from the TV's app store (Google TV: "TV Bro" or "BrowseHere"; Fire TV: "Silk Browser" - all free).
- Go to this site's address and open TV VIEW.
- Type the 4-letter race code with the remote and select SHOW LEADERBOARD.
- Done. The board updates itself every 2 seconds - no further interaction needed. Before the race starts it shows the join QR code so teams can register straight off the TV.
No TV browser? Cast a Chrome tab from any laptop/phone: open the TV VIEW page in Chrome, menu, Cast, pick your TV.
ROKU (SIDELOAD THE FREE CHANNEL)
Roku has no web browser, so a small channel is included in the project download. One-time setup, about 10 minutes:
- Enable Developer Mode: on the Roku remote press Home 3x, Up 2x, Right, Left, Right, Left, Right. Note the IP address shown, choose "Enable installer", accept, and set a developer password.
- Get the channel: download the project from the README link (or ask the host for the
hyrox-roku.zipfile). Inroku/source/config.brs, set the site address, then zip the contents of therokufolder. - Install: on a computer on the same Wi-Fi, browse to
http://<roku-ip>, log in asrokudevwith your developer password, upload the zip and press Install. - Run: launch "HYROX Race Sim" from the Roku home screen and type the race code with the on-screen keyboard. Press OK any time to change the code; it is remembered between launches.
Alternative with zero setup: most Roku TVs support AirPlay or screen mirroring - mirror a phone or laptop showing the TV VIEW page.
4. Race Day Flow
- TV on the leaderboard, teams registered (they appear on the host phone and the TV lobby).
- Host presses START RACE - a wave start: every team's clock starts together, synced to the server. Teams joining late can SELF START from their own phone.
- Race. Teams tap COMPLETE at the end of each run and station; the TV re-ranks live - finished teams first by time, racing teams by progress.
- When a team finishes Wall Balls, their phone shows the official result with every split.
5. Results & Export
- DOWNLOAD CSV - saves a spreadsheet-ready file with every split (formatted time plus raw milliseconds). Opens directly in Excel, Numbers or Google Sheets.
- SAVE RESULT ON THIS PHONE - stores the result in the phone's browser so you can compare races over time, and EXPORT ALL AS CSV later.
- Results stay available on the race code afterwards too - reopen the TV view or phone page with the same code.
Troubleshooting
| Problem | Fix |
|---|---|
| Team doesn't appear on the TV | Check the phone joined the right race code; the board updates within 2 seconds of registering. |
| Tapped COMPLETE twice | UNDO LAST on the phone removes the last split and the TV corrects itself. |
| Phone locked / browser closed mid-race | Reopen the join link - the team resumes where it left off. The clock runs on the server, so no time is lost. |
| TV shows READY after the start | That team joined after the wave start - they can SELF START from their phone. |
| Wrong division picked | Division is a label only - it does not change timing. Rejoin as a new team before the start if it matters. |
| Race over, want a rematch | Host presses RESET RACE - teams stay registered, all times clear. |
Need the race format, station standards, weights and penalties? See the RULES & COURSE GUIDE.