How kinkpedil/frlcast works
FRLcast is a race-control and broadcast system for FR Legends leagues. An operator manages an event in the console; race state and timing feed live classification, race-control actions, overlays, and driver information. Optional inputs include official game-server timing and minimap vision tracking. Hosted mode adds public audience pages and cloud-linked drivers; desktop mode adds local commentary and the timing API. The graph preserves documented capabilities, but some connections are documented only at product level because their implementation was not excerpted.
Main entry points: race-state.js Race control · index.js Local server · MainActivity.java Driver phone app · vision.js Vision tracking
Components 24
Race console
- Operator console
public/js/panel.js - Race control
public/js/race-state.js
Race and timing
- Championship scoring
public/js/points.js - Race timing
public/js/timing.js - Position tracking
public/js/tracker.js - Vision tracking
public/js/vision.js - Vision worker
public/js/vision-worker.js - Official timing API
server/timing-api.js - Local server
server/index.js - Local state store
server/file-store.js - Driver authentication
server/drivers-auth.js
Broadcast features
- OBS overlays
public/overlay/overlay.js - Spoken commentary
public/js/commentary.js
Hosted services
- Audience poll
site/app.js - Cloud event linking
server/cloud-link.js - Cloud updates
public/js/cloudbus.js - Hosted data access
public/js/supabase-store.js
Driver app
- Driver phone app
android/src/com/frl/driver/MainActivity.java - Floating flag window
android/src/com/frl/driver/OverlayService.java - Driver backend client
android/src/com/frl/driver/Backend.java
Other components
- Race operator
- FR Legends server
- Drivers
- OBS audience
Connections 23
- Race operator → Operator console: operates
README.md - Operator console → Race control: controls race
README.md - Race control → Race timing: records timing
README.md - Race control → Championship scoring: scores rounds
public/js/race-state.js - Vision tracking → Vision worker: runs worker
public/js/vision.js - Vision tracking → Position tracking: uses tracking
public/js/vision.js - FR Legends server → Official timing API: provides laps
README.md - Official timing API → Local server: feeds timing
README.md - Local server → Race control: serves race state
server/index.js - Local server → Local state store: persists state
server/index.js - Race control → OBS overlays: supplies race data
README.md - OBS overlays → OBS audience: renders broadcast
README.md - Race control → Spoken commentary: drives commentary
README.md - Drivers → Driver phone app: uses app
README.md - Driver phone app → Driver backend client: sends requests
android/src/com/frl/driver/MainActivity.java - Driver backend client → Local server: calls driver API
android/src/com/frl/driver/Backend.java - Local server → Driver authentication: authenticates drivers
server/index.js - Driver phone app → Floating flag window: starts overlay
android/src/com/frl/driver/MainActivity.java - Floating flag window → Local server: polls race state
android/src/com/frl/driver/OverlayService.java - Audience poll → Cloud event linking: links hosted events
README.md - Cloud event linking → Hosted data access: uses hosted storage
server/cloud-link.js - Cloud updates → Hosted data access: syncs cloud data
public/js/cloudbus.js - Audience poll → Cloud updates: votes in poll
README.md