Docs/Features/QR Live Tracking

QR Live Tracking

New feature (Feb 2026)

QR Live Tracking allows spectators to view real-time tournament standings and fight results by scanning a QR code with their phone. No app installation required — just scan and view.

Internet Required

QR Live Tracking requires an internet connection on both the Derby host computer and spectators' phones. The data syncs every 30 seconds.

How It Works

  1. Enable live broadcast — Derby publishes tournament data to the cloud
  2. QR codes appear automatically — On PDF reports and in the Match Presenter
  3. Spectators scan — Using any phone camera, they scan the QR code
  4. View live data — A mobile-optimized web page shows rankings and fights

Where QR Codes Appear

PDF Reports

All PDF reports (Teams, Fights, Scores, Stripes) include a QR code in the footer. When printed, spectators can scan from the physical report.

Match Presenter

The Match Presenter displays a QR code in the bottom-right corner. Spectators in the audience can scan directly from the projected screen.

Enabling Live Broadcast

Open your tournament

Ensure you have teams, cards, and a generated schedule.

Start broadcasting

Go to View > Start Live Broadcast or click the broadcast icon in the toolbar. Derby will connect to the cloud and begin syncing.

Generate reports or open Presenter

QR codes will automatically appear once broadcasting is active.

Stop broadcasting

When the tournament ends, go to View > Stop Live Broadcast to stop syncing and remove the live page.

What Spectators See

The live tracking page (derby.com.mx/live/{id}) displays:

  • Tournament name and location
  • Current rankings — Teams sorted by cumulative score
  • Recent fights — Latest results with outcomes
  • Current phase — Which phase the tournament is in
  • Last update time — When data was last synced

The page auto-refreshes every 30 seconds. Spectators can also manually refresh.

Privacy Considerations

Public Data

Live tracking data is publicly accessible via the QR code URL. Anyone with the link can view rankings and fights. Do not enable live broadcast if you need to keep tournament data private.

Data published includes:

  • Tournament name and location
  • Team names and rankings
  • Fight results (Green Win, Red Win, Tie)
  • Weight differences (deltas)

Data NOT published:

  • Player/owner names
  • Contact information
  • Exact card weights
  • Internal IDs or metadata

API for Developers

The live tracking data is available via a REST API for custom integrations:

GET https://www.derby.com.mx/api/live/{tournamentId}

Response:
{
  "tournamentId": "abc123",
  "name": "Championship Derby",
  "location": "Mexico City",
  "timestamp": "2026-02-05T14:30:00Z",
  "phase": 1,
  "rankings": [
    { "team": "Team Alpha", "score": 12, "wins": 3, "losses": 1 },
    ...
  ],
  "recentFights": [
    { "green": "Team Alpha", "red": "Team Beta", "outcome": "GreenWin", "delta": 15 },
    ...
  ]
}

Troubleshooting

QR code not appearing

  • Ensure live broadcast is active (View > Start Live Broadcast)
  • Check internet connection on the Derby computer
  • Regenerate the report after starting broadcast

Page shows old data

  • Data syncs every 30 seconds — wait for the next update
  • Try manually refreshing the page
  • Check that Derby is still running and connected

Spectators can't access the page

  • Ensure they have internet access
  • The URL should be derby.com.mx/live/{id}
  • Try scanning the QR code again

Related Features