⚙️ Configuration

Application Settings

Configure and tune your virtual race engineer. Pit Crew Hub provides modular options to adjust audio alerts, measurement units, resource consumption, local database logging, and Discord voice streams to fit your exact cockpit preferences.

1. Optimal Gear Shift Tone 🔊

Maximizes your acceleration rates by signaling the exact mathematical point where upshifting delivers the highest horsepower output.

Option	Behavior & Impact
Enable Optimal Shift Beep	Toggles the shift tone cue on or off during active stints.
Driver Reaction Time Offset	Slider (0 to 300 RPM earlier). Triggers the beep earlier to offset the physical delay of your paddle pull, ensuring the gear shift lands precisely at the peak acceleration RPM. It can also be used to consistently shift at a certain point to save fuel in long races and guarantee that you can replicate your practice runs as close as possible for optimal racing strategies.

2. PlayStation Telemetry Connection 🎮

Controls the network routing settings to receive real-time UDP telemetry packets from your Gran Turismo 7 console.

Option / Field	Behavior & Platform Details
PlayStation IP Address	Configures the local IP address of your PlayStation 4 or PlayStation 5 (e.g., `192.168.1.50`). Defaults to the broadcast IP `255.255.255.255`. Features an active input mask that filters out invalid characters, limits each octet to max 3 digits/255 value, and verifies completeness before saving.
iOS (iPhone / iPad) Compatibility	Important: Apple security sandboxes strictly block UDP broadcasts (`255.255.255.255`) by default. To receive telemetry on iOS, you must enter the exact local IP address of your PlayStation console in this field to establish a unicast UDP connection.
Custom Incoming Port	By default, Pit Crew Hub binds to local port `33740` to receive packets from the game. If you use SimHub or other local redirect tools for motion/wind simulators and external dash overlays, you can enable this setting to override and bind the socket to any non-privileged port (`1024 - 65535`).
How to find your PS4/PS5 IP	On your PlayStation, navigate to Settings → Network → Connection Status → View Connection Status and look for the IP Address entry.

3. Measurement Unit System 📊

Adapts all telemetry widgets, database tables, and metrics display to your region's preferred units.

System	Metrics Affected
Metric System	Speed: km/h • Distance: kilometers • Fuel: Liters (L) • Dates: DD-MM-YYYY
Imperial System	Speed: mph • Distance: miles (mi) • Fuel: Gallons (gal) • Dates: YYYY-MM-DD

4. Telemetry Frequency ⚡

Determines how many times per second the client reads and processes telemetry packets from the Gran Turismo UDP stream.

Frequency	Resource & Telemetry Impact
10Hz (Low)	Saves local device battery and minimizes background processor load. Best for old tablets or low-spec phones used as basic dashboards.
30Hz (Medium)	Standard performance. Offers highly responsive dials and stable logging metrics.
60Hz (High)	Ultra-high definition capture. Captures micro-adjustments in steering angle, throttle slides, and trail-braking pressure. Required for deep driving line analysis.

5. Lap History Recording 💾

Controls storage logging settings for your racing stints.

Save Lap History (Enabled): Automatically saves all completed laps, telemetry data, and binary session traces locally to your device's SQL database. Allows offline review and comparison.
Save Lap History (Disabled): Active delta-time and dashboard gauges still display live during the run, but no lap statistics or coordinate files are persisted. Reduces local disk footprint.

6. Track Mapping Mode 🗺️

Provides mapping overlays to coordinate track points.

Enable Track Mapping Overlay: Toggles a diagnostic UI overlay on the dashboard showing current 3D position (X, Y, Z), yaw/pitch/roll orientation, flag states, and time on track. Used to verify mapping alignment or register new track coordinate templates.

7. Reference Lap Audio ⏱️

Pipes acoustic braking zone warnings based on a saved reference lap to help you master braking markers.

Option	Behavior & Impact
Enable Braking Beep	Toggles acoustic alert when approaching a corner where braking occurred on your reference lap.
Braking Beep Offset	Slider (0.0s to 1.5s earlier). Shifts the warning beep slightly before the braking point to account for driver reaction delay, ensuring you hit the brake pedal exactly at the target coordinate.

8. Discord Audio Routing 🔊

Routes shift beeps, braking cues, and spotter announcements out of local speakers and directly into your connected Discord voice channel. For step-by-step instructions on setting this up with your PlayStation 5 console, read our dedicated Discord & PS5 Setup Guide.

Option	Behavior & Impact
Connect Discord Voice	Authorizes the server bot to join your selected guild and voice channel. Cues play directly in the channel.
Delay for Discord	Slider (0.0s to 5.0s). Introduces a delay offset to sync the bot's real-time audio beeps with livestream overlay video delays.