# Stream Deck Configuration

## Configuring a Key (Gear Icon)

To configure any iReporter action, click the **gear icon** or long-press the key in the Stream Deck software. A property inspector panel opens on the right.

The property inspector connects directly to iReporter over the local WebSocket (port 8474). The connection status is shown at the bottom of the panel - it shows **Connected - iReporter v0.XXX** when SimHub is running with iReporter active. If SimHub is not running, it shows *iReporter not found - start SimHub first* and retries every 4 seconds.

## iReporter Button - Configuration Options

### iReporter Button dropdown

Select which iReporter button this key maps to. The dropdown shows the actual button labels from your iReporter configuration (e.g. *B4 - Avoidable Contact*, *B5 - Blue Flag Overtake Issues*). If a button has no label configured in iReporter, it shows *Button N*.

### Display colours

- **Normal**: The background colour when the key is idle. Choose from: Dark, Blue, Green, Yellow, Red, Purple, Orange, White, Cyan, Pink.
- **Active / Alert**: The background colour when a crash, incident, or blue flag situation is active on this button. A coloured swatch shows a preview of the selected colour.
- **Pressed / Sent**: The colour flashed for 1.5 seconds after the key is pressed to confirm the report was sent.

### When active, show

- **Countdown**: Yes (default) - shows remaining seconds in the crash/incident reporting window. No - shows **CRASH** or **INCIDENT** text only.
- **Gap (Blue Flag)**: Yes (default) - shows the approaching leader's gap in seconds. No - shows **BLUE FLAG** only.

Changes are saved automatically and take effect immediately.

## Blue Flag Monitor - Configuration Options

- **Active colour**: Colour when a blue flag situation is active (a lapping leader is approaching within the configured gap threshold).
- **Clear colour**: Colour when no blue flag situation (displayed dimly).
- **Show gap seconds**: Yes/No - whether to display the gap value in seconds on the key.

## Crash Alert - Configuration Options

- **Active colour**: Colour on crash detection.
- **Clear colour**: Colour when no crash active.
- **Show countdown**: Yes/No - whether to display the countdown timer.

## Incident Alert - Configuration Options

Same options as Crash Alert but for incidents.

## Tip - Matching Colours to Race Status

Common colour choices that match iRacing conventions:

- **Blue flag buttons**: Active = Blue, Clear = Dark
- **Crash buttons**: Active = Red, Clear = Dark
- **Incident buttons**: Active = Orange, Clear = Dark
- **Normal report buttons**: Normal = Green, Active = Red, Pressed = White

## Multiple Stream Decks

iReporter supports multiple Stream Decks simultaneously. Each key is configured independently - you can have the same iReporter button on multiple keys with different colour schemes.