Quick Start

1. Go to the Players tab and type player names into the roster. Press Enter after each name to move to the next row.

2. Check the Absent box next to any player who is not playing today. Absent players will automatically receive a BYE each round.

3. Go to the Courts tab to verify or edit your court names. Add or remove courts as needed to match your venue.

4. Go to the Rounds tab and click Generate Next Round to create court assignments.

5. Click Display Mode (or press D) to show the current round full-screen for TV casting.

Players Tab

The roster has 50 blank rows. Simply type a name and press Enter to advance to the next row. To remove a player, clear their name and click away. Players cannot be added or removed after rounds have been generated — use Reset Event first.

Mark players as Absent at any time. Absent players are always assigned a BYE and are given the lowest BYE Order numbers so they sit out first. Absent players appear with an "(A)" marker in the round display.

The BYE Order column shows each player's position in the BYE rotation queue. This is assigned automatically when Round 1 is generated.

Courts Tab

Courts can be renamed to match your venue (e.g., "Court 3", "North Court"). Use the Add Court button to add more, or the × button to remove one. The number of courts determines how many groups of 4 play each round — any remaining players receive a BYE.

Rounds Tab

Generate Next Round — Creates the next round of court assignments. The algorithm ensures no player is ever paired with the same partner twice. It also balances opponents and alternates serve/receive sides.

Reset Current Round — Removes the most recent round and immediately regenerates it. Useful if you changed Absent status and want to redo the latest round.

Reset Event (New Day) — Clears all rounds, history, and BYE Order while keeping your player list and Absent settings. Use this at the start of a new session or event day.

Round history is shown below the buttons. Click any round header to expand and view its court assignments.

Display Mode (TV Casting)

Press D or click Display Mode to enter a full-screen view of the current round, optimized for casting to a TV via Chromecast or AirPlay. Court cards are displayed with large, high-contrast text readable from a distance. Press Esc to return to the admin view.

For best results, cast the browser tab to your TV and then enter Display Mode.

How the Round Generator Works

The rotation algorithm assigns 4 players to each court (2 per side) and gives a BYE to any remaining players. It enforces these rules:

No repeat partners — A player will never be paired with the same partner twice across all rounds. This is a hard constraint.

Opponent balancing — The algorithm minimizes repeat opponents. When choosing court assignments, it scores each combination and prefers matchups with fewer previous meetings.

Side balancing — Players alternate between Side A (serving) and Side B (receiving) across rounds as evenly as possible.

BYE rotation — Players take turns sitting out in a fair sequential order. Absent players always sit out first (receiving the lowest BYE numbers), so present players get maximum court time. The BYE queue carries forward across rounds.

Round rollback — When you reset the current round, the BYE queue position is restored so the regenerated round uses the same BYE slots.

Keyboard Shortcuts

D — Toggle Display Mode on/off

Esc — Exit Display Mode or close confirmation dialogs

Enter (in player roster) — Move to the next player name field