What is iReporter

Overview

iReporter is a SimHub plugin designed for iRacing competitors whoto make their life easier whilst competing. It uses technology to understand information about your car and the cars around you and allows you to use this information to create customs actions based on this information. This information also allows conditional logic to be used to help assist with events. An example might be to to send a message to cars that are behind you within 2 seconds that you intend to make a pit stop this lap or to send a message to race incontrol leagueswith ordetails organisedof eventsyour wherecar (number and name), lap that you are on that a Racecrash Controlhas teamoccurred is managingand the session. It makes it quick and easy for a driver to report incidents, contact, flags, and other on-trackcars situationslikely toinvolved Raceare Controlxyz. —

all without taking their hands off the wheel or losing focus on the race.

During a busy race, things happen fast. Typing a report into the iRacing chat box while also trying to race is difficult and distracting. iReporter solves this by letting you pre-configure your most common reports as buttons — on your sim dashboardiReporter button box, an Elgato Stream Deck, or both. One press sends a fully formatted, data-filled report instantly — no typing required.

Input Options

iReporter supports three input modes, selectable from the settings panel:

iReporter Button Box — a dedicated hardware button box (4, 8, or 16 buttons) connected via USB. Physical buttons trigger reports and hardware LEDs show live race status. Stream Deck — an Elgato Stream Deck used as the sole input device. Keys display live colour and data (countdowns, gap times) and trigger the same reports as physical buttons. iReporter Button Box & Stream Deck — both devices active simultaneously, giving you flexibility to use whichever is within reach.

Key Features

Up to 1624 configurable buttons — each button sends one or more pre-written messages tousing the iRacinginformation chatgathered boxvia and/ordynamic Discord webhooks, and optionally logs themvariables to awhat file.or whoever is required. Stream Deck integration — native Elgato Stream Deck plugin included. Keys show live colour-coded status and update in real time — turning red with a countdown when a crash is active, blue with a gap readout when a blue flag leader is approaching, and flashing green when a report is sent. Crash Capture — automatically detects when a car nearby receives significant incident points and pre-loads the car number, driver name, direction, and lap into your message templates. When contact happens, the details are already ready for youryou nextto buttonreport press.the crash when you have time, rather than a scramble at the time of the crash. Incident Capture — similar to Crash Capture but for lower-severity incidents, with its own threshold, timeout, and message templates. Voice Output — buttons can trigger spoken audiomessages using native Windows TTSText to Speech  or high-quality ElevenLabs cloud voices, so you can hear confirmation of what was sent. Push-to-Talk integration activates your iRacing radio during playback. This means that it will report the incident/crash directly to race control, via voice with the single touch of a button. Discord Webhooks — messages are posted directly to a Race Control Discord channel so the officials receive your report in real time. LED & Stream Deck indicators — hardware LEDs on your button box light up to show that a crash or incident has been captured and is ready to report. Stream Deck keys show the equivalent status through colour changes. Blue Flag Helper — monitors race leaders and alerts you (via LED or Stream Deck key) when a lapping car is approaching from behind, so you can get out of the way cleanly. The approach gap threshold is fully configurable, including decimal values such as 0.5 seconds. Solo Incident Filter — crash and incident captures are automatically ignored when no competitor is withinclose 0.5 seconds ofto you at the moment of detection, preventing solo barrier hits or kerb incidents from triggering false captures. Message Variables — dynamic placeholders like {CAR#}, {DRIVER}, and {CRASHCAR} are automatically filled with live iRacing data at the moment you press the button. Conditional statements allow messages to be sent only when specific race conditions are met. Message Templates — save and reuse message configurations across buttons. Templates can be applied, overwritten, or created directly from the button configuration panel. Logging — all reports are optionally written to dated log files so you have a personal record of everything you reported during the race.

Typical Use Case

You are competing in a league race that has Race Control managing the event via Discord. Another car makes contact with you or causes an incident nearby. Rather than fumbling with the keyboard mid-race, you simply press the pre-configured Contact Report button on your button box or Stream Deck.

iReporter has already detected the incident and captured the car number, driver name, and lap. Your button press instantly sends a formatted message to the Race Control Discord channel — something like:

/rc Contact reported — Car #42 (John Smith) ahead — Lap 14.3

Race Control receives the report immediately and can act on it, while you stay focused on racing.

If you use a Stream Deck, the button that triggered the report flashes green briefly to confirm it was sent, then reverts to its normal display. A dedicated Crash Alert key on the Stream Deck turns red and counts down the reporting window so you always know how long you have left to submit a report.

iReporter is particularly valuable during the most hectic moments of a race — safety car restarts, multi-car incidents, or late-race battles — when clear, fast communication with Race Control makes a real difference.