iRaceHUD

iRacing HUD overlay built in Tauri

Development

Recommended IDE Setup

VS Code + Svelte + Tauri + rust-analyzer.

Fetching new track SVG paths

[!IMPORTANT] You should enable iRacing legacy authentication for your account to run the following script. The instructions are available in official support article

Script downloads track maps from iracing API and saves them into a static file. Generally it should be used when new tracks are released.

Set environment variables:

$env:IRACING_LOGIN = '<iracing login>'
$env:IRACING_PWD = '<iracing password>'

Run script via pnpm:

pnpm run fetch-track-info

Script will report its progress and final state upon finish.

Track info (with main track paths) will be saved to track_info.json.

Track start/finish SVGs will be saved to start_finish directory

Track settings

Iracing's SVG start point and direction may differ with start/finish line and track direction. To overcome this issue one can manually fill in track_settings.json static file. It stores a json object where keys are track ids and values have the following format:

{
    "offset": 0.567,
    "direction": -1
}

offset is a start/finish line offset from SVG starting point (value should be between 0 and 1), direction is 1 if track direction matches SVG path direction and -1 otherwise.

To search for these values you can use accompanying interface located at /track_info url when launching iRaceHUD via Vite development mode.