← NewTon DC Tournament Manager

User Guide

Everything you need to run a darts tournament with NewTon DC Tournament Manager.

Quick Start

NewTon DC Tournament Manager runs entirely in your browser — no installation, no account, no internet required after the first download.

  1. Download — Get the latest release from the releases page. Unzip and place the folder anywhere on your computer.
  2. Open — Launch tournament.html in your browser. No server needed — double-clicking the file works.
  3. Configure — Visit the Config tab to set your club name, logo, point values, and leg counts. You only need to do this once.
  4. Create — Click New Tournament and enter a name and date.
  5. Register — Add players by name. Mark payment status as players arrive. NewTon DC Tournament Manager remembers names across tournaments via the Saved Players registry.
  6. Generate — Choose Single or Double Elimination and the bracket size, then click Generate Bracket. The draw is randomised automatically.
  7. Run — Manage matches from the bracket view. Assign lanes, record results, and track the tournament in real time.

Tournament Formats

Double Elimination (DE)

Every player gets two chances before they are eliminated. The bracket is split into a Frontside (winners) and a Backside (losers). A player who loses on the Frontside drops to the Backside and can still win the tournament.

Single Elimination (SE)

One loss and you're out. Straightforward bracket where winners advance and losers are eliminated immediately.

Which to Choose?

When in doubt, use Double Elimination. It rewards consistency, keeps more players engaged throughout the evening, and produces a more meaningful result. Single Elimination is the right call when you're short on time or boards.


Configuration

The Config tab stores global settings that apply across all tournaments. Changes take effect immediately and persist across browser sessions.

Club Identity

Point System

NewTon DC Tournament Manager calculates tournament standings automatically from tournament results. Configure point values to match your club's rules:

Match Configuration

Set the number of legs per round independently for both formats:

Chalker

These settings are included in the QR assignment payload sent to the Chalker:

Lane Management


Managing a Tournament

Creating a Tournament

In the Tournament Setup tab, enter a tournament name and select a date, then click Create New Tournament.

Previous tournaments are listed and can be loaded or deleted from the same screen. Tournaments can also be exported and imported as JSON — useful for backups or moving to another device. Docker users can enable Automatic Backup to save tournaments to disk and upload to a remote instance at the moment of completion.

Registering Players

Add players from the Player Registration tab before generating the bracket. Type a name and press Enter or click Add. New players are added to the register of Saved Players.

Saved Players Registry

Player names are saved to a persistent registry to keep names consistent across tournaments. Players can be removed from Saved Players.

Tournament exports include the Saved Players registry. To transfer it from another device, use the Import Saved Players button in the Saved Players panel.

Payment Tracking

Each player has a payment status indicator on the Players list. Toggle it to mark who has paid the entry fee. Payment status is visible at a glance and included in the player list — useful for the person collecting fees at the door.

A payment QR code image can be displayed on the Registration page — place a payment.png file in the images/ folder. Need to generate one? Use NewTon's QR Code Generator.

Generating the Bracket

Navigate to the Tournament Bracket tab. Match Controls open automatically if Automatically open Match Controls is enabled — otherwise click the Match Controls button to open them.

Match Controls in setup mode shows the player list, current configuration, and a Setup Actions panel on the right. The bracket size is determined automatically from the player count. Players can still be added from this screen.

Choose your format in the Setup Actions panel: click Generate Bracket under Double Elimination Cup or Single Elimination Cup. The draw is randomised automatically and empty slots are filled with byes.

The bracket cannot be regenerated once matches have started. Double-check your player list before generating. If a player arrives after the bracket is generated, Late Registration can place them into an empty bye slot — provided no live or completed matches exist downstream of that slot.


Running Matches

The Bracket View

The bracket is the main view during an active tournament. It displays the full draw — Frontside and Backside — with all matches and their current status.

Navigation

The left-hand panel provides quick access to all sections:

Pan & Zoom

The bracket can be panned freely by clicking and dragging. Use the mouse wheel or the + / buttons in the top-right corner to zoom in and out. The home button between them resets the view to the default zoom and position.

Match Status

Matches progress through four states:

Status Panel

The bottom-right corner shows a live summary of the tournament: name, elapsed time, completed match count, bracket size, total matches, player count, date, application version, and current status (Active / Completed).

Match Controls

The Match Controls panel is the command center for running the tournament. Open it by clicking the Match Controls button at the top of the bracket view, or enable Automatically open Match Controls to have it open whenever a match completes and new ones become ready.

The panel shows all active and ready matches in two columns — Frontside on the left, Backside on the right — sorted by round. Live matches appear at the top, sorted by lane number. Each match card shows the match ID, where the winner and loser will advance to, and the Best of X format configured for that round.

Everything you can do in Match Controls — starting matches, assigning lanes and referees, declaring winners, entering scores and stats — can also be done directly from the bracket view by clicking individual match cards. The one thing exclusive to Match Controls is the Referee Suggestions panel.

Starting a Match

Ready matches show a lane dropdown, a referee dropdown, and a Start Match button. Select a lane and optionally a referee, then start the match. The match moves to Live status and lane is locked in.

NewTon DC Tournament Manager flags conflicts with a ⚠️ warning on the player's name — for example, if a player is currently serving as referee for another match and has a new match ready to start. The conflict is informational; you can still proceed once the referee situation is resolved.

Lane & Referee Conflict Management

NewTon DC Tournament Manager tracks all lane and referee assignments in real time:

Referee Suggestions

The right-hand panel shows referee suggestions in priority order:

This makes it easy to pick a fair referee quickly without having to track who's free manually.

Recording Results

Click a winner button on a Live match. The Confirm Match Winner dialog appears, showing the declared winner, the opponent, and the match ID. A Match Progression box confirms exactly where each player goes next — the winner's next match and the loser's next match — so you can verify before committing.

Below that, enter the Final Score (optional) — the number of legs won by each player (e.g. Christian: 2, Timothy: 0). The score must give the winner more legs than the loser.

Player names in the dialog are clickable — clicking a name opens the Statistics dialog for that player:

Stats are saved per player. Click Confirm Winner when done — NewTon DC Tournament Manager advances the winner and loser to their next matches automatically.

Leaderboard

The Leaderboard button at the bottom of the Match Controls panel opens the current standings mid-tournament. Click any player to open their Statistics dialog and add stats that were missed when the match result was recorded. Players with lollipops show a 🍭 icon next to their name.


Chalker QR Workflow

NewTon DC Tournament Manager can send match assignments directly to the Chalker scoring app via QR code — no typing player names, no verbal handoff, no mistakes.

Generating the QR Code

On any live match card in Match Controls, click the QR button (to the left of "Stop Match"). A modal appears with the assignment QR code. The subtitle shows the match details: players, format, and lane/referee if assigned.

Lane and referee are optional — the QR code can be generated without them. Whatever is assigned at the time is included in the payload.

Scanning in the Chalker

On the Chalker, tap QR in the "New Match?" dialog. The camera opens immediately — no intermediate screens. Point it at the QR code on the TM screen. The moment a valid code enters the frame, it's captured automatically.

Every scan is verified with a CRC-32 signature. Corrupted or invalid codes are rejected with a clear error message, and the camera stays open to try again.

Confirmation & Match Start

After a successful scan, a confirmation screen shows the full assignment:

The operator confirms, selects the starting player, and the match begins. The Chalker displays the lane and referee in its info bar throughout the match.

Sending Results Back

When the match finishes, tap Stats in the Chalker, then Result QR to display the result QR code.

At the Tournament Manager, click Scan QR Results in the Match Controls footer. Point the camera at the Chalker's result QR. A preview appears — winner, score, and achievements. Click Apply Result and the bracket advances.

Configuration

These settings are found in the Tournament Manager's Global Settings → Match Configuration → Chalker and are included in every QR assignment payload:

Best-of legs is determined by the match round and your match format configuration. All values travel in the QR — the Chalker receives everything it needs.

Requirements

For the full technical specification of the QR payload format, integrity checking, and score encoding, see the QR Protocol documentation.


Results & Export

Live Standings

The Leaderboard shows current standings and point totals as the tournament progresses. It is accessible from Match Controls, the Tournament Bracket, and the Player Registration tab. Final placements are confirmed when the Grand Final (DE) or Final (SE) is completed.

Tournament Setup also shows a running Match History — a log of all completed matches in chronological order.

Export Results

Results — player names, placements, points earned, and achievement counts — can be exported from the Player Registration tab and from the celebration screen when the tournament is complete. Choose Export CSV for spreadsheets and season standings trackers, or Export JSON for structured data.


Developer Console

The Developer Console provides two categories of tools: diagnostics that monitor tournament health in real time, and commands that act directly on the bracket structure and transaction history. Because these commands can modify the actual tournament data, the Developer Console is deliberately hidden from the normal operator workflow — it must be enabled in Global Settings first, then opened by clicking the version number in the bottom-right corner of the bracket view.

Statistics — updated live as the tournament runs:

Commands — diagnostic and recovery tools:


Tips & Tricks

Undo

Made a mistake recording a result? NewTon DC Tournament Manager supports surgical undo — you can reverse a match result without affecting the rest of the tournament. Click the undo button on a completed match to revert it. Matches that have already fed players into subsequent completed matches cannot be undone.

Late Registration

A player arrives after the bracket has been generated? Use Late Registration — accessible from the Players tab via the amber "Player arrived late?" button (visible on active tournaments). NewTon DC Tournament Manager finds a suitable bye slot and places the late arrival without disturbing existing matches.

Built-in Help

Press F1 at any time inside the tournament manager to open context-sensitive help. The help panel explains the current view and available actions.

Offline Use

NewTon DC Tournament Manager works entirely offline. Download the release once, copy it to a USB drive, and run it at any venue without internet. All data is saved automatically in your browser's localStorage — it survives browser restarts and reboots and new versions brought in on the next USB drive.

Multiple Tournaments

NewTon DC Tournament Manager supports multiple tournaments side by side. Switch between them from the tournament list on the home screen. Each tournament has its own isolated data — deleting one doesn't affect the others.

Data Safety

LocalStorage is tied to your browser profile. Export tournaments regularly and keep the JSON files somewhere safe — treat exports as your permanent backup and localStorage as working storage. Clearing your browser data will clear localStorage too. See the Privacy page for full details on how NewTon stores and handles your data.

Self-Hosting

Want to run NewTon DC Tournament Manager for your whole club from a central server? See the Docker Quick Start guide. Self-hosting enables shared tournament access across devices via the optional REST API, and Automatic Backup can push completed tournaments to a public Analytics instance.

Lollipops 🍭

Scoring a 3 — three ones — in darts is known as a lollipop. Many clubs mark the occasion by handing the guilty player an actual lollipop. NewTon DC Tournament Manager supports this tradition: open any player's Statistics dialog during or after a tournament and use the Lollipops counter to record their shame. Players with one or more lollipops will have a 🍭 icon and count displayed next to their name in the Leaderboard.


Documentation