Configuration
To add the integration to your Home Assistant instance, use the button below:
During installation, you can choose exactly which sensors you want to include in your setup. This gives you control over which data points to load, for example, only the next race and weather, without standings or calendar.
You can always change this selection later by reconfiguring the integration via Settings > Devices & Services in Home Assistant.
This documentation always refers to the standard entity_id, for example sensor.f1_track_status or binary_sensor.f1_safety_car.
Display names in Home Assistant can be localized, and older installations may already have different registry IDs. When you search in Home Assistant, search for the f1_ suffix or check the entity’s entity_id in the entity settings instead of relying on the display name alone.
Manual Configuration
If the button above does not work, you can also perform the following steps manually:
- Browse to your Home Assistant instance.
- Go to Settings > Devices & Services.
- In the bottom right corner, select the Add Integration button.
- From the list, select F1 Sensor.
- Follow the on-screen instructions to complete the setup.
Device Structure
The integration organizes all entities across six dedicated sub-devices, which appear under Settings > Devices & Services > Devices in Home Assistant.
| Device | What it contains |
|---|---|
| Race | Next race info, track time, race week indicator, season calendar |
| Championship | Driver and constructor standings, points progression, championship predictions* |
| Session | Session status, track status, safety car, weather, timing sensors, starting grid, formation start*, overtake mode, straight mode |
| Drivers | Driver list, tyres, tyre statistics, driver positions, pit stops* |
| Officials | Race control messages, FIA documents, track limits, investigations |
| System | Live delay, calibration controls, replay controls, live timing connectivity, F1TV token status and controls |
*Entities marked with an asterisk depend on Replay Mode or experimental F1TV Auth testing, depending on the selected feature.
Each device exposes its own set of device automation triggers, making it straightforward to build automations directly from the UI without writing YAML.
After updating to v4.0.0, the original single F1 Sensor device will appear empty in Home Assistant and should be removed manually from Settings > Devices & Services > Devices.
All entity IDs remain unchanged, so automations and dashboard cards that reference entities by their ID will continue to work without modification. However, dashboard views organized by device and any device-based conditions or triggers in automations will need to be updated to reference the new sub-devices.
Live data setup
When enabling live data, you can set an initial delay to better align live updates with your TV broadcast.
For detailed instructions on syncing with your TV, including guided calibration, see Live Delay.
Public live timing works without F1TV access. Experimental F1TV Auth testing is optional and only needed when you want to test auth-gated live timing streams such as Pit Stops, Championship Prediction, or formation start data during a real live session.
A typical streaming delay is 30–45 seconds. You can always fine-tune this later using the Live Delay feature.