Subsection 8.5

8.5 Spotter

Notice: Note: Docs are currently being updated for v1.45.0.

Created Last edited

TiRST can be your race spotter. It follows iRacing's own car-alongside detection and the rest of the telemetry (flags, laps to go, the pits, fuel and your car) and plays your own sounds for each call: your voice, a friend's, or any clips you like. Open it from Settings → Spotter in the control panel. The spotter is experimental. Each panel on that page has its own section below.

Building your own spotter

  1. Turn it on. Tick Be my spotter on the Spotter panel.
  2. Silence iRacing's spotter. In iRacing, go to Options → Sound and turn the spotter volume down to 0, so you don't hear both. TiRST uses the same telemetry either way.
  3. Choose where the calls play. Open the spotter page in a browser tab on your racing PC and click it once to allow sound, add it to OBS, or tick Play them in the Streamers Display window. Use only one.
  4. Pick your calls. Open each group on the page and tick the calls you want. There are about 60, from "car left" to "fuel critical".
  5. Give them a voice. Record each call with your microphone, upload clips, or import a sound pack. Calls without sounds use the built-in voice, beeps or a chime.
  6. Test. With the spotter page open, press a call's test button to hear it.

You can start with no sounds at all: the built-in Windows voice reads every call, and you can replace them one at a time.

Spotter

Be my spotter: play the calls below with my own sounds turns the spotter on. It's off by default.

Where the calls play

The calls play on the spotter page, http://localhost:8767/spotter. The panel has Copy and Open buttons for it. You can:

  • Keep it open in a browser tab on the racing PC. Click the page once so the browser allows sound.
  • Add it to OBS as a Browser Source. Tick Control audio via OBS if you want viewers to hear the calls. OBS may not have the built-in voices, so use your own sounds there.
  • Tick Play them in the Streamers Display window: no browser tab needed.

Use only one of these, or you'll hear every call twice.

Options

  • Volume: from 0 to 100, default 80.
  • Play each call on its side: left calls in your left ear, right calls in your right. On by default.
  • A new call cuts off the one that's playing: on by default, so the newest call is never late.
  • Cars alongside with no sounds of their own: built-in beeps (the default), the built-in voice, or nothing.
  • Every other call with no sounds: the built-in voice (the default), a chime, or nothing.

Built-in voice

The built-in voice reads any call that has no sounds of its own, using the words in that call's box.

  • Voice: the Windows default (English) or any other voice installed in Windows. You can add more in Windows under Settings → Time & language → Speech.
  • Speed: from 0.7 to 1.6 times, default 1.1.
  • ▶ Hear it here: plays a sample in the control panel.

Radio call

A radio call makes the spotter sound like it's on the team radio.

  • Play a radio call before each spotter call: on by default. It also plays your "radio off" sound after each call, if you add one.
  • Built-in radio click when you haven't added any: on by default.
  • Skip it while the radio is still "open": no radio call if the last call was less than this long ago, from 0 to 6 seconds (default 2). This stops a click before every call in a busy moment.
  • Radio call (before each call) and Radio off (after each call): add your own sounds by link, upload or recording. Their file IDs for sound packs are radioIn and radioOut.

Timing

  • A car alongside must stay for: from 0 to 500 milliseconds (default 120) before "car left" or "car right" plays. This ignores cars that only flick alongside for a moment.
  • "Clear" waits until it's been clear for: from 0 to 1500 milliseconds, default 350.
  • "Still there" while a car stays alongside: repeats every 2 to 10 seconds (default 4). On by default.
  • "Trouble ahead" looks this far up the road: from 1 to 8 seconds ahead of you, default 3.
  • "Faster class car behind" when it's this close: from 0.5 to 5 seconds behind you, default 2.
  • "Low fuel" when there's fuel for fewer than: from 1 to 10 laps, default 3.

Calls

The calls are grouped into nine sections (see The call groups below). Each section opens and closes; Open all groups and Close all do every section at once. The section's title shows how many of its calls are on.

In each section:

  • Play these calls turns the whole group on or off.
  • Each call has a tick box, a Test button, its file ID for sound packs, a box for the words the built-in voice says, and its own sound list.
  • Test plays the call on the spotter page, so open that page first.

Sounds for a call

  • Paste a link and click Add, click Upload…, or click ● Record. MP3, WAV, OGG and the other usual formats work; short, clean clips work best.
  • Add as many as you like: a random one plays each time, never the same twice in a row.
  • Click ▶ beside a sound to hear it, or ✕ to remove it.

A call with no sounds of its own

  1. It borrows the sounds of the call it's closest to: "Two cars left" uses "Car left", and "Clear left" and "Clear right" use "Clear".
  2. If there are none there either, it plays the built-in beep or voice, as chosen on the Spotter panel.

The words box sets what the built-in voice says, such as "Car left". Leave it blank for the default words. These fill in with the real values: {pos} (your position), {laps} (laps of fuel left), {inc} (your incident total) and {add} (the incident points just added).

Recording your own calls

The bar at the top of the Calls panel sets up recording:

  • Record with: your default microphone, or pick one.
  • Trim the silence: cuts the quiet bits at the start and end. On by default.
  • Even out the volume: makes each recording about as loud as the others. On by default.
  • Radio filter: makes your recording sound like it's coming over a team radio.

To record a call:

  1. Press ● Record next to the call.
  2. Say the call, then press Stop. Recordings stop by themselves after 15 seconds.
  3. Listen back, then Save to add it to that call's list.

Record a few versions of the busiest calls, like "car left" and "clear", so they don't sound the same every time. The Load Setup Reminder uses this same microphone.

Sound packs

A sound pack is a ZIP of WAV files holding your spotter sounds, so you can back them up, move them to another PC or share them with a friend.

  • Each file is named after its call's file ID, shown under every call: left.wav, caution.wav, pitDone.wav and so on. The radio sounds are radioIn.wav and radioOut.wav.
  • Extra versions of a call go in as left_2.wav, left_3.wav and so on. left-2.wav and left (2).wav work too, and capital letters don't matter.

The buttons:

  • Import ZIP…: replaces the sounds of every call the ZIP has files for and leaves the other calls alone. Files it can't use are listed with the reason, such as an MP3 or a name that isn't a call ID. The uploaded ZIP is deleted as soon as it's been read.
  • Export ZIP: downloads your sounds as a ZIP.
  • Clear these sounds (Clear all spotter sounds on the Calls panel): removes the sounds.

The buttons on the Calls panel work on everything at once. Each group section, and the Radio call panel, has its own set for just its calls.

The call groups

Every call is listed below with the words the built-in voice says by default. Calls marked (off by default) need ticking first; all the others are on.

Cars alongside

Uses iRacing's own car-left and car-right detection.

  • Car left / Car right: played in that ear when side-by-side playback is on.
  • Three wide (both sides): "Three wide".
  • Two cars left / Two cars right.
  • Clear left / Clear right.
  • Clear (three wide over): "Clear all round".
  • Still there: repeats while a car stays alongside.

Starts, restarts & pacing

  • Get ready (start lights).
  • One to green (race start) and One to green (restart).
  • Green flag (race start): "Green, green, green".
  • Green flag (restart): "Green flag, go go go".
  • You're a wave around, You got the free pass, and Sent to the end of the line.

Flags

  • Caution (full course yellow), Local yellow and Debris flag.
  • Blue flag: "Blue flag, let the faster car by". It isn't called in the first few seconds after the green flag, when the field is still sorting itself out.
  • Black flag, Meatball (repairs) and Disqualified.
  • Red flag.
  • Halfway (crossed flags) (off by default).

Laps & the finish

  • Ten to go, Five to go, and Two to go (off by default).
  • Five minutes left (timed races).
  • White flag: "White flag, last lap".
  • Checkered flag.
  • You won: "P1, you won it!"
  • Your finishing position: "That's P{pos}, good job".
  • Personal best lap (off by default).

Position & traffic

  • Taking the lead and Losing the lead.
  • Gained a place and Lost a place: "Up to P{pos}" and "Down to P{pos}" (both off by default).
  • Faster class car behind (multiclass): uses the distance set under Timing.

Trouble ahead

  • Car off track ahead and Slow car ahead: cars off the track or crawling just up the road, as far ahead as set under Timing.

Pit lane

  • Pits open and Pits closed.
  • On pit road (off by default).
  • Pit limiter is off: "Limiter, limiter".
  • Over the pit speed limit: "Watch your speed".
  • Pit stop done: "Go, go, go".
  • Leaving pit road: "Pit exit, watch the merge" (off by default).

Fuel

Worked out from your fuel use over the last few green laps.

  • Low fuel: "Fuel for {laps} laps", below the number of laps set under Timing.
  • Fuel critical: "Fuel critical, box this lap".
  • Enough fuel to the end.

Your car

  • Incident points: "That's a {add}x, {inc} total" (off by default).
  • Towing.
  • Engine stalled: it isn't called in the first few seconds of gridding, when cars often stall as they load in.
  • Water temperature high, Oil temperature high, Oil pressure low and Fuel pressure low.
  • DRS available.