PitRadar — How to Use
PitRadar is a live FRC event dashboard built for pit crews. It pulls real-time data from The Blue Alliance, Statbotics, and FRC Nexus so your team always has the most up-to-date match, queue, and standings information — readable from across the pit.
Getting Started — Team Setup
When you first open PitRadar (or after clearing your session), you'll land on the Team Picker. This is also where you return if you tap Switch Team in the settings menu.
- Enter your team number and click Find Events (or press Enter). PitRadar will look up your team name and list your registered events for the current season.
- Select your event from the dropdown. The currently active event is auto-selected if one is found.
- Optionally check Enter alternate Nexus ID if your event uses a different key in FRC Nexus than in TBA.
- Click Start PitRadar. Your selection is saved for the session — you won't need to re-enter it on every visit.
To switch teams or events during a session, use the ⚙ Settings menu in the top-right corner of the nav bar and choose Switch Team.
Dashboard
The main dashboard is a live overview of your team's event, refreshing automatically every few seconds.
- Next Match — your team's upcoming match number, colour-coded by alliance (red/blue).
- Now Queuing — the current Nexus queue position. The tile changes colour and pulses as your match approaches.
- Upcoming Matches — all remaining scheduled matches for your team, with predicted times.
- Event Rankings — your team's current rank, record, and ranking points at this event.
- Season Rankings — your Statbotics world EPA rank and percentile for the season.
- Leaderboard — the full event standings for all teams, with EPA colour coding.
- Live Stream — if the event has a registered stream (YouTube or Twitch), an embedded player appears at the top of the page.
Blue › Green › Yellow › Grey
Blue = top performers • Grey = lower tier
Bright yellow = being queued now
Fading yellow = approaching
Grey = queue has passed your match
Schedule
The Schedule page shows every match at the event in a sortable table — Qualifications, then Playoffs, then Finals.
- Use the level tabs (Quals / Playoffs / All) to filter by match type.
- Toggle Our Matches Only to show only matches involving your team.
- Completed matches show actual scores; upcoming matches show Statbotics win/loss predictions in a muted style.
- Click any team number to open that team's detail page.
Scenarios
The Scenarios page helps you answer "what finishing rank do we need, and can we still get it?" before quals end.
- The left column shows the current standings.
- The centre column lists remaining matches — each match is pre-loaded with the Statbotics win/loss prediction, but you can click to toggle between win, loss, or tie based on your own hunches.
- The right column shows the projected final ranking based on your selected outcomes, updating instantly as you make changes.
All calculations are done in the browser — no data is saved. Refresh the page to reset all outcomes back to the Statbotics predictions.
Pit Display
The Pit Display is a full-screen dashboard designed to be mounted on a monitor in the pit and visible from across the workspace. It automatically advances through five screens as the competition progresses — no manual intervention required.
- Click Launch Pit Display in the nav bar (or check Open in Pit Display Mode on the Team Picker and click Start PitRadar).
- On launch, choose Landscape (widescreen monitor) or Portrait (vertical/rotated monitor). Your last choice is remembered and pre-selected.
- After choosing orientation, you'll be prompted to tap for fullscreen — one tap enters fullscreen mode; Esc skips it.
Pit Display Screens
The pit display has five screens that follow the flow of an FRC event. It will automatically move to the next screen as the competition advances.
- Pre-Competition — shown before the match schedule is published. Displays your team's season stats (EPA, world rank, record) and a ranked list of every team at the event sorted by EPA — a scouting overview of the field before quals begin. The team list auto-scrolls if it doesn't fit on screen.
- Qualifications — the primary screen during quals. Shows real-time queue status, next match, upcoming match cards, event rankings leaderboard, season stats, and an optional live video stream. Identical data to the main dashboard but formatted for pit-monitor readability.
- Alliance Selection — appears automatically once all qualification matches are complete. Shows the 8 alliance pick cards updating in real time as captains make their picks, an available teams sidebar, and combined alliance EPA. Uses the FIRST API for faster updates during live selection.
- Playoffs — appears when alliances are finalized and the first playoff match is queued. Displays the full double-elimination bracket (or round-based bracket for district championships), real-time match status tiles, and an alliance sidebar. Scores update live as matches complete.
- Event Summary — appears after the final match is complete. Congratulates the winning alliance (with a blue banner graphic if your team won), thanks your alliance partners, shows the final 1st–8th standings, and highlights notable matches from the event (highest score, highest combined score, highest losing score). If any of these were season-wide records, that is noted as well.
Pit Display Settings
Click the ⚙ gear icon in the bottom-right footer to access pit display settings:
- Orientation — switch between Landscape and Portrait at any time.
- Video — control the live stream embed: Off (never show), My Matches (show only when your team is on the field), or Always (always visible).
- Auto-align Pit Display to Comp State — when checked (default), the display automatically advances between screens as the competition progresses. Uncheck this to stay on the current screen and navigate manually.
Pit Display Navigation
- Click the ☰ hamburger icon in the footer to manually jump to any pit display screen (Pre-Competition, Qualifications, Alliance Picks, Playoffs, or Event Summary).
- The hamburger menu also provides Toggle Fullscreen, Exit Pit Display (returns to the regular dashboard), and Submit Bug options.
- Click the countdown timer in the footer to force an immediate data refresh.
The display auto-scales to fill any screen size. It refreshes on the same interval as the main dashboard during quals, and every 30 seconds during alliance selection and playoffs.
Mobile View
On phones and small screens, PitRadar automatically redirects to a mobile-optimised layout. You can also access it manually via ⚙ Settings → Mobile View.
- Shows field status, queue position, next match, rankings, and a link to the live stream (if available).
- Includes a mobile-friendly Schedule and Scenarios view accessible from the mobile nav.
- To return to the full desktop view from a phone, tap Desktop View at the bottom of the mobile page.
Demo Mode
Enter team 99999 on the Team Picker to launch Demo Mode. This creates a synthetic 30-team event with a full schedule, results, alliance selection, and playoff bracket — no API keys or live event required.
- The demo event progresses based on clock minutes, cycling through quals, alliance selection, and playoffs.
- Use the Demo Jump controls (visible in the pit display hamburger menu) to skip forward or backward through the event timeline.
- Demo mode is a great way to explore all of PitRadar's features, including the pit display auto-advancement between screens.
Data Sources & Refresh
PitRadar pulls live data from three external sources:
- The Blue Alliance — match schedule, scores, rankings, team info, alliance selections, and event webcasts. Cached for 5 minutes.
- Statbotics — EPA ratings, win probability predictions, world rankings, and season-wide notable match records. Cached for 5 minutes.
- FRC Nexus — live field status and queue position. Refreshed every 15 seconds.
- FIRST API — used during alliance selection for faster real-time pick updates.
The countdown timer in the top-right nav shows seconds until the next full refresh. Click it to refresh immediately.
