PITWALLOSdocs

Leaderboards, events & TV display

Every lap driven at your venue lands in a leaderboard. This page covers the three surfaces that read from it: the admin leaderboards, hotlap competitions (“events”), and the public TV mode you point at your lobby television.

Where laps come from

The rig agent uploads every completed lap into your venue's Postgres tenant: circuit + vehicle + driver + lap time + session context. Laps arrive within a few seconds of the chequered flag. Invalid laps (spun off, cut penalties) get flagged but stored anyway — the leaderboard hides them by default; you can un-hide them from Laps.

Admin leaderboards

/admin/leaderboards has three tabs:

  • Circuit records— per-track top-10 list, optionally filtered by vehicle. Great for answering “who's the fastest around Monza in our GT3?”
  • All-time bests— the top laps across every circuit, in overall order. Useful for the “venue heroes” wall.
  • Hotlap events— timed competitions. Set a window (start & end datetime), pick a circuit and vehicle, and the platform aggregates every eligible lap in that window into a dedicated event leaderboard.

Hotlap events

Events are how you run promotions: “Fastest Silverstone GT3 lap this weekend wins a free session.”

  1. Create the event from the Hotlap eventstab. Enter start and end datetimes in your venue's timezone — the form uses your local wall-clock, not UTC.
  2. Pick a circuit and (optionally) a vehicle. Leaving vehicle blank creates an open-car event.
  3. Publish. The event auto-appears on the customer-facing /eventspage during its window, and shows up in each customer's portal.

Every valid lap driven inside the window on the chosen content counts automatically — drivers don't need to opt in. When the window closes, the leaderboard freezes.

TV display mode

https://<your-slug>.pitwallos.com/tvis a public, no-login “kiosk” view of your leaderboards. Point a Raspberry Pi, an old laptop, or any Chromium browser at that URL and stick it on the lobby TV — the page auto-rotates through however many boards you configure, at whatever cadence you set.

Configuring the rotation

Settings → TV display. You configure two things:

  • Rotation seconds— how long each board stays on screen before the next one rolls in. 8-15 seconds usually reads best for a lobby crowd.
  • Boards— the ordered list of screens to cycle through. Each board is one of:
    • All-time records— top laps across every circuit.
    • Circuit— a specific circuit's top-10, optionally filtered to one vehicle. Add one board per circuit you want to feature.
    • Hotlap event— a live event leaderboard. Only shows up on the TV while the event window is open; auto-drops out when the event ends.

Zero-config default

A freshly-installed venue with no boards configured shows the all-time records board on the TV, so a Pi you plug in on day one displays something meaningful even before you touch settings.

Setting up the Pi

Any device that can run a modern Chromium works — Pi 4, an old NUC, a Firestick with a browser side-load. The TV page is 1080p-first and re-lays out for 4K. To make the setup fully hands-off:

  1. Install Raspberry Pi OS Lite + Chromium, or use a purpose-built kiosk image.
  2. Set the browser to auto-launch on boot pointing at your venue's /tv URL.
  3. Disable the screensaver / display-off timer so the TV stays lit through the day.

Public leaderboard

Customers browsing your marketing site see the same data on /leaderboard. It's indexed by search engines — a fast Silverstone lap by one of your regulars is the kind of page Google surfaces to prospective customers.