Subsection 5.2

5.2 Celebrations

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

Created Last edited

Celebrations are the big moments on the Celebrations & jabs overlay (/celebrations-and-jabs): a good finish, a strong qualifying lap, the fastest lap, an overtake or taking the lead. Set them up on ⧉ Overlays → Celebrations in the control panel. Each panel on that page has its own section below.

Celebration types at a glance

TiRST has seven celebration types. Each one plays on the Celebrations & jabs overlay the moment it happens.

  • Race victory: you win the race. The biggest celebration, with a trophy, fireworks and a confetti storm.
  • Race result: you finish P2 or lower but inside your celebration limit (P10 by default). A podium (P2–P3) gets more than a top-10 finish.
  • Qualifying result: qualifying ends and you're inside your qualifying limit (P5 by default). Pole position gets the most.
  • Fastest lap: you set the quickest lap of the session, in purple like the timing screens.
  • Overtake: you gain places in a race. Single, double, triple, quadruple and 5-or-more passes each get bigger.
  • Taking the lead: you move into P1 (or the class lead in a multi-class race). A gold animation that always shows.
  • Lap 1 quip: a small line of text counting your passes on lap 1, while the full overtake animations are held back.

Celebrations only play in sessions whose event type is turned on under Settings → Event tracking. When a result isn't celebrated, the reason appears under Recent results.

Enable celebrations

The switch at the top of the page turns every celebration on or off: race and qualifying results, overtakes, taking the lead, fastest lap and lap 1 quips. It's on by default.

Turn it off if you only want TiRST for jabs, Grid Rivals or the iRating Tracker. Jabs, Grid Rivals boards, the pre-race summary and the iRating reveal keep showing.

Race finish

Celebrate race results plays a celebration when you finish a race. TiRST waits a moment after the line for your official position, so a pass right at the finish is counted correctly.

Lowest finishing position to celebrate sets how far down the order still gets a party, from P1 (wins only) to P20. The default is P10. The better the result, the bigger the celebration: P1 gets fireworks, a trophy and a confetti storm.

Qualifying

Celebrate qualifying results plays a celebration when qualifying ends and iRacing posts the results. It's worded as encouragement for the race ahead, such as "POLE POSITION!" or "STARTING P2!"

Lowest qualifying position to celebrate works like the race setting, from P1 to P20. The default is P5.

If you were in qualifying and didn't set a time, there's no celebration. A "No qualifying lap" jab plays instead, if jabs are on.

Behaviour

  • Count positions: In my class (recommended, the default) or Overall. This applies to race and qualifying celebrations and to overtakes. In a single-class race, both are the same.
  • On screen for: how long a result celebration stays up, from 4 to 60 seconds. The default is 12.
  • Driver name: the name shown in celebrations. Leave it blank to use your name from iRacing.
  • Confetti amount: from 0.3 to 2 times the normal amount. The default is 1.

Animation style

The style sets the look of every celebration, overtake and jab. Pick one from the list; a short description appears under it.

  • Classic (default): confetti, fireworks and bold cards. The original look.
  • Neon glow: glowing outlines and neon particles on dark glass.
  • Broadcast: flat, sharp-edged TV graphics that wipe on and off, with far less confetti.
  • Retro arcade: a pixel font, blocky particles, stepped motion and scanlines.
  • Minimal: quiet cards that fade in and out. No sounds and no particles at all.
  • Carbon: a carbon-fibre weave, a red racing stripe and italic type that slides in on a skew.
  • Glass: frosted see-through panels that float in softly, with gentle, light confetti.
  • Luxe: black and gold with shimmering serif headlines, made for podiums.
  • Comic: halftone dots, thick ink outlines and a bouncy pop. It loads a comic font from Google Fonts, so it needs an internet connection.
  • Synthwave: 80s sunset gradients, chrome lettering and a neon grid that tilts into view.

Use Preview P1, Preview overtake, Preview jab and Preview fastest lap to see the style on your overlays.

Race victory

Winning the race gets the biggest celebration: a trophy, fireworks and a confetti storm. It has its own sound list under Celebration sounds, so a win can sound different from every other result. Test a victory plays it.

Lap 1 quips

Lap 1 is chaotic, so by default TiRST holds back overtake and jab animations until you've completed it (see Overtakes). Show a quick line for passes on lap 1 fills the gap with a small line of plain text for each pass, with no border, effects or sound. It's on by default.

One wording is picked at random for each race, and it counts up as you pass: "1 down…", "2 down…". Write your own wordings in the box, one per line. Use {n} for the number of passes so far and {s} for an "s" when there's more than one, as in That's {n} overtake{s}…. Restore default wordings brings back the eight that come with TiRST.

  • Style: dark pill (the default), light pill, white with a black outline, yellow with a black outline, caption box, or white with a soft shadow.
  • On screen for: from 1 to 8 seconds. The default is 2.5.

Test a quip shows one on your overlays.

Fastest lap

Celebrate setting the fastest lap of the session plays a purple celebration the moment you set the quickest lap: in your class, or overall if positions are counted overall. It's on by default.

  • Improving a fastest lap you already hold shows it again, and so does taking it back from someone.
  • Outside a race, it only counts once someone else has set a time, so it doesn't fire when you're alone on track.
  • Show fastest laps in: tick Practice, Qualifying, Warmup and Race to choose the sessions. All four are on by default. These boxes also control the Other driver fastest lap pop-up under Rest of the field.

Test fastest lap plays it.

Show in the animation

These boxes choose the details on race and qualifying celebration cards:

  • Driver name (on)
  • Position medal (on)
  • Start → finish, with positions gained (on)
  • iRating before → after (on)
  • iRating change (on)
  • Event type, discipline and season (on)
  • Car (on)
  • Track (on)
  • Laps led (on)
  • Incidents (off)
  • Fastest or qualifying lap (off)
  • Strength of field (off)

Try it plays sample celebrations on every connected overlay, including OBS: Race P1, P2, P3, P5 and P10, and Qualify P1, P2 and P4. Previews ignore your position limits. Tick Preview as a multi-class race to see a card with both class and overall positions.

Wording

Every celebration has a title and a subtitle you can rewrite. Restore defaults puts back the wording TiRST comes with.

These tokens are replaced with the real details:

  • {pos}: your position
  • {name}: your first name
  • {fullname}: your full name
  • {track}: the track
  • {car}: your car
  • {start}: your starting position
  • {gained}: positions gained
  • {field}: the number of cars in the field

The default wording:

  • Race win: VICTORY! / What a drive, {name}!
  • Race podium (P2–P3): PODIUM FINISH! / On the box at {track}!
  • Race top finish: P{pos} FINISH! / Solid result — well driven!
  • Pole position: POLE POSITION! / Lead them into turn one — go get the win!
  • Qualified P2–P3: STARTING P{pos}! / Right in the fight. Clean start and the podium is in reach!
  • Qualified (other): QUALIFIED P{pos} / Great lap! Keep it clean and move forward.
  • Fastest lap: FASTEST LAP! / Purple lap — quickest in the race, {name}!
  • Taking the lead: TAKES THE LEAD! (CLASS LEADER! in a multi-class race) / P1 — now bring it home, {name}!

Overtakes

Show overtake animations celebrates the places you gain during a race. It's on by default. The animation grows with the number of places: single, double, triple, quadruple, and 5 or more.

TiRST counts the net change since the last overtake it showed. If you lose 2 places and gain 1 back, nothing shows until you're ahead of where you were.

  • Check position every: how often TiRST compares your position, from 10 to 60 seconds. The default is 30.
  • Sensitivity: how far clear of the other car you must be, from 0.001 to 1 second, before a pass counts. The default is 0.001. Raise it for pack racing on ovals, where places swap back and forth all the time.
  • How often to show: every overtake (the default), or only 1 in every 2, 3, 5, 10, 20, 25, 50 or 100.
  • Always show double overtakes and bigger: multi-car passes show even when How often to show would skip them. On by default.
  • Flair & drama: how big the animation is, from 1 (Subtle) through Clean, Lively and Dramatic to 5 (Maximum). The default is 3, Lively.
  • Screen position: Top, Middle, Above the HUD, or a custom offset from the top in pixels. The default is a 300-pixel offset.
  • Count cars that pit: counts places gained when a car ahead goes into the pits. Off by default.
  • Nothing on the first lap: no overtakes or jabs until you've completed lap 1. On by default; lap 1 quips show instead.

Taking the lead always shows, with its own bigger gold animation and sound list.

TiRST uses your live track position and confirms it a moment later, so timing glitches don't trigger an overtake. Nothing is counted under caution, while you're on pit road, or when you're lapping or being lapped.

Test 1×, 2×, 3×, 4× and 6× play overtakes of each size, and Taking the lead plays the lead animation.

Celebration sounds

You choose the sounds for each celebration. Each time a celebration plays, TiRST picks one of its sounds at random, never the same one twice in a row. Celebrations have no sounds until you add some.

Adding sounds

  • Paste a link to a sound file and click Add, or click Upload… to add files from your PC (mp3, wav, ogg or m4a).
  • Uploading works best from a normal web browser at TiRST's address (http://localhost:8767) rather than inside OBS.
  • Click ▶ beside a sound to hear it, or ✕ to remove it.

The global list

The global list is shared by every celebration type that has its + global list box ticked. Put the sounds you want everywhere here, so you don't have to add them to each type.

Each celebration type

Each type has its own list:

  • Race victory (P1)
  • Race result (P2 and lower)
  • Qualifying result
  • Fastest lap
  • Single overtake, Double, Triple, Quadruple, and 5 or more
  • Taking the lead

With + global list ticked (the default), a type plays from its own sounds and the global list. Unticked, it plays only its own sounds, and with none it's silent.

Volume

Two sliders set the volume for Results & fastest lap and for Overtakes & lead, from 0 to 100. The default is 80. If volume normalization is on in Settings → Sound effects, these sliders are hidden and every sound plays at the level set there.

In OBS, tick Control audio via OBS on the Celebrations & jabs browser source so the sounds reach your stream. The Minimal style plays no sounds.

Recent results

The bottom panel lists your recent sessions so you can check what TiRST celebrated. Each line shows the date, event type and discipline, track, where you qualified and finished (class and overall in multi-class races), and how many overtakes were counted.

The Celebrated column says Race when the finish was celebrated. When something wasn't, it gives the reason, such as "Finished class P12 (limit P10)" or "Qualifying celebrations are turned off".