LMU PIT WALL

🌐 Language: English · Русский

WEC-style real-time telemetry dashboard for Le Mans Ultimate (rFactor 2 engine). Built for endurance racing — your remote strategist watches the same data as a real pit-wall engineer.

A self-hosted alternative to services like mylmu. Reads the rF2 Shared Memory Map Plugin sections directly, streams a compact JSON snapshot over WebSocket at 50 Hz, and renders it as a hardcore monospace dashboard that mirrors the look of a real WEC pit wall.

Features

• Live telemetry @ 50 Hz — gear, RPM, speed, throttle/brake/clutch, steering
• 4-wheel tire panel — inner/center/outer temperatures with cold→optimal→hot colour mapping, pressure (PSI + kPa), wear, carcass and brake temps
• Car status — fuel (with low/critical warning), water temp, oil temp, turbo boost
• Timing tower — position, lap, current/last/best times, full S1/S2/S3 table with delta column, session-best (magenta) highlighting, active sector indicator
• Strategy assist — rolling fuel-per-lap, laps-left estimate, stop count, penalties, gap to ahead/leader
• Flag strip — LIVE / PIT / SPDLIM / OVERHEAT / FUEL! / YELLOW
• Auto-reconnect WebSocket with exponential backoff
• --demo mode — runs without LMU, perfect for testing the UI on macOS/Linux
• Single-file frontend — no build step, no npm, no framework

Architecture

┌──────────────┐    Shared Memory    ┌──────────────┐   WebSocket 50Hz   ┌──────────────┐
│ Le Mans      │ ──────────────────► │  server.py   │ ─────────────────► │  index.html  │
│ Ultimate +   │   $rFactor2SMMP_    │  FastAPI +   │      ws://         │  Vanilla JS  │
│ rF2 SMMP     │     Telemetry$      │  ctypes      │     /ws            │  Monospace   │
│ Plugin       │     Scoring$        │  parser      │                    │  Dashboard   │
└──────────────┘                     └──────────────┘                    └──────────────┘
                                                            ngrok / cloudflared
                                                                   │
                                                                   ▼
                                                       Strategist's browser anywhere

Prerequisites

1. Le Mans Ultimate installed (Windows).
2. rF2 Shared Memory Map Plugin (TheIronWolfMod) — required so that the $rFactor2SMMP_Telemetry$ / $rFactor2SMMP_Scoring$ sections exist:
   • download rF2SharedMemoryMapPlugin64.dll from the original repo
   • drop it into <LMU install>\Bin64\Plugins\
   • enable the plugin inside the game (Settings → Plugins)
3. Python 3.10+.

Install

git clone https://github.com/<your-user>/le-mans-ultimate-telemetry.git
cd le-mans-ultimate-telemetry

python -m venv .venv
.\.venv\Scripts\Activate.ps1

pip install fastapi "uvicorn[standard]"

Run

# Demo mode — synthetic data, no LMU required (great for UI checks)
python server.py --demo

# Production — LMU is running, plugin is loaded
python server.py

# Custom port / rate
python server.py --host 0.0.0.0 --port 8000 --hz 60

Open http://127.0.0.1:8000/ — you should see the full dashboard. If LMU is in the main menu the UI will display AWAITING TELEMETRY; the server itself will not crash.

Remote access for your strategist

The backend must stay on the racing PC — only that machine has access to LMU's Shared Memory. Two pieces have to be live during a race:

1. Local Python server + ngrok tunnel

# terminal 1
python server.py

# terminal 2
ngrok http 8000
# → https://<random>.ngrok-free.app

For 24h races, reserve a fixed ngrok subdomain so the URL never changes:

ngrok http --domain=your-reserved-name.ngrok-free.app 8000

2. Frontend (hosted on Cloudflare Pages)

The dashboard is already live at https://lmu-pitwall.pages.dev/. Your strategist opens that URL from anywhere. On the first visit they enter the WebSocket address once (or you send them a pre-baked link):

https://lmu-pitwall.pages.dev/?ws=wss://your-reserved-name.ngrok-free.app/ws

The URL is remembered in localStorage, so refreshes / reboots Just Work. A ⚙ CONNECTION button in the footer lets them change it at any time.

For the strategist

A complete operating manual lives in two languages: STRATEGIST_GUIDE.md (English) / STRATEGIST_GUIDE.ru.md (Russian). Each covers the screen layout, tire-colour cheat sheet, lap-time colour code, 7 typical race scenarios and what to radio in each, troubleshooting, and a pit journal template. Send the right language to your engineer before the race.

Inside the dashboard, the ? GUIDE button (footer) opens an in-app condensed version of the same cheat sheet — strategist never has to leave the screen during a stint.

Deployment (Cloudflare Pages)

After cloning the repo:

npm install                # one-time, installs wrangler locally
npx wrangler login         # one-time, opens Cloudflare OAuth in browser
npm run deploy             # deploys static/ to https://lmu-pitwall.pages.dev

Useful follow-ups:

npm run list               # list past deployments
npm run tail               # live tail logs (HTTP requests, errors)
npm run deploy:preview     # deploy to a preview branch URL

Custom domain (optional)

1. In the Cloudflare dashboard: Workers & Pages → lmu-pitwall → Custom domains → Set up a custom domain.
2. Enter pitwall.your-domain.com (or apex your-domain.com).
3. If the domain's DNS is already on Cloudflare, it's wired automatically. If not, add a CNAME record pointing to lmu-pitwall.pages.dev at your registrar.

Layout

┌──────────────────────────────────────────────────────────────────────────────┐
│ ● LMU PIT WALL  · CKT · CAR · DRV · CLS · AIR/TRK/WET · sessionclock         │
├────────────────────────────┬──────────────────┬──────────────────────────────┤
│           VITALS            │      TIRES       │      TIMING TOWER           │
│                             │  ┌────┐  ┌────┐  │  ┌──────────┐ ┌──────────┐  │
│   ┌───────────────────┐    │  │ FL │  │ FR │  │  │ POSITION │ │   LAP    │  │
│   │                   │    │  └────┘  └────┘  │  │    03    │ │    47    │  │
│   │        6          │    │  ┌────┐  ┌────┐  │  ├──────────┴─┴──────────┤  │
│   │                   │    │  │ RL │  │ RR │  │  │ CURR  3:31.423        │  │
│   └───────────────────┘    │  └────┘  └────┘  │  │ LAST  3:30.124        │  │
│   [████ shift lights]      │                  │  │ BEST  3:28.912        │  │
│                             ├──────────────────┤  ├──────────────────────────┤
│   THR  BRK  CLT             │   CAR STATUS     │  │ S1 / S2 / S3 / Δ       │  │
│                             │  FUEL 84.3L      │  │ ...                    │  │
│   [── STEERING ──]          │  WATER 88° OIL 96│  │ GAPS · FLAGS           │  │
└────────────────────────────┴──────────────────┴──────────────────────────────┘

Project layout

le-mans-ultimate-telemetry/
├── server.py                 # FastAPI + ctypes SMMP reader + WebSocket stream
├── static/
│   └── index.html            # Monolithic frontend (HTML + CSS + JS)
├── package.json              # npm scripts for wrangler deploy
├── wrangler.toml             # Cloudflare Pages config
├── STRATEGIST_GUIDE.md       # Full strategist manual (English)
├── STRATEGIST_GUIDE.ru.md    # Full strategist manual (Russian)
├── README.md                 # This file (English)
├── README.ru.md              # This file (Russian)
├── LICENSE
└── .gitignore

Tuning

Variable	Where	Default	What it controls
STREAM_HZ (CLI --hz)	server.py	50	WebSocket frame rate
tireColor() thresholds	index.html JS	60 / 80–100 / 115 °C	Cold / optimal / hot tire colour bands
fuel low / critical	index.html JS	25 / 10 L	When the FUEL card turns orange / blinks red
ovh threshold	index.html JS	water > 110 °C or oil > 130 °C	Activates OVHEAT flag

Troubleshooting

• "AWAITING TELEMETRY" stays forever — the SMMP plugin DLL is not loaded. Verify the path (<LMU>\Bin64\Plugins\) and that LMU has loaded it (Settings → Plugins checkbox).
• ModuleNotFoundError: No module named 'fastapi' — activate your venv, then pip install fastapi "uvicorn[standard]".
• Strategist gets "Mixed Content" error — ngrok HTTPS forwards to plain HTTP backend, this is normal; the frontend uses wss:// so it works.
• Wrong tire temperatures — values are converted from Kelvin in _wheel_to_dict(). Double-check KELVIN constant if your readings look off by ~273°.

Credits

• Shared memory layout based on rF2SharedMemoryMapPlugin by TheIronWolfMod
• Visual language inspired by FIA WEC / F1 pit-wall engineer dashboards