Frequently Asked Questions
General Questions
Do I need to configure any API keys or separate weather API for F1 Sensor?
No, the integration does not require any API keys. All data is fetched automatically from the provided APIs. You just install and add the integration, no additional API setup is needed.
Can I use the F1 Sensor data in ESPHome directly (for example, on an ESP32 display)?
Not directly. F1 Sensor is a Home Assistant integration (running on Home Assistant), not an ESPHome component. This means ESPHome devices can’t retrieve F1 data on their own from this integration.
The workaround is to have Home Assistant pass the data to the ESPHome device, for instance, by using the Home Assistant API or MQTT to send sensor values to your ESPHome device.
In summary, the F1 sensors live in Home Assistant, you can mirror those entity states to ESPHome, but you cannot import the integration into ESPHome itself.
Are practice and qualifying session times available in F1 Sensor?
The integration does not create separate sensors for each practice or qualifying session by default (only for the race and overall “next race” info).
However, the schedule information for practice sessions and qualifying is included in the data. For example, the sensor.f1_next_race (next race info) or the season calendar sensor contains the timings for all sessions of the Grand Prix weekend.
You can use those attributes in templates or in the calendar to know when FP1, FP2, FP3, Quali, etc., occur. There is currently no dedicated “FP1 sensor” or “qualifying sensor” – this has been requested as a feature, but for now you’ll use the provided schedule data from the existing sensors.
Live Data Questions
Why are some entities like Pit Stops, Team Radio, and Championship Prediction not available during live sessions?
These entities depend on data streams from the F1 Live Timing API that require authentication the integration does not currently support. Since the data cannot be received reliably during live sessions, these entities are only created when you play back a session in Replay Mode, where the full session archive is available and all data works normally.
The affected entities are:
sensor.f1_pitstopssensor.f1_team_radiosensor.f1_championship_prediction_driverssensor.f1_championship_prediction_teamsbinary_sensor.f1_formation_start
All other live entities, such as track status, session status, driver positions, race control messages, and weather, continue to work during live sessions as before.
Why are the live sensors (e.g. track status, session status) not updating outside of race sessions?
This is expected behavior. The live sensors only update shortly before, during, and just after an active session (practice, qualifying, sprint, or race). Outside of those times, they will not update and may appear static. In other words, you’ll only see changes in those sensors when a Formula 1 session is happening or about to happen.
Will the live data work if I watch a race replay later (not live)?
Yes. The integration includes Replay Mode, which lets you play back historical sessions with full Home Assistant integration. When you watch a recorded race from F1 TV or another service, your automations and dashboards can follow the replay much more like a live broadcast.
Replay Mode now also includes experimental 30-second catch-up controls in Version 1. You can use Back 30 seconds and Forward 30 seconds to manually line up the replay with your broadcaster if the timing drifts.
This catch-up feature is still experimental, so more refinement may be needed as development continues.
If you want to avoid spoilers before watching, turn on No Spoiler Mode before the session starts. Your dashboard stays frozen until you are ready. Then load the session in Replay Mode and experience everything as if it were live.
See the Replay Mode documentation for setup instructions.
How do I keep my dashboard spoiler-free until I can watch?
Turn on No Spoiler Mode before the session starts. The integration freezes all spoiler-sensitive entities (results, live timing, standings, race control messages) while keeping schedule and calendar data up to date.
When you are ready, load the session in Replay Mode and press play when the broadcast starts. When you are done, turn No Spoiler Mode off and everything updates at once.
See the No Spoiler Mode documentation for full details.
How do I adjust the live update delay to sync with my broadcast? Where is that setting?
The integration provides multiple ways to adjust the live delay:
- Direct adjustment: Change
number.f1_live_delayto set the delay in seconds - Guided calibration: Use the built-in calibration workflow with
switch.f1_delay_calibration
For detailed instructions including automatic calibration during a live session, see Live Delay.
Why does the documentation say one entity name, but Home Assistant shows another?
The documentation always uses the standard entity_id, for example sensor.f1_track_status or binary_sensor.f1_safety_car. That is the stable reference used in examples, templates, blueprints, and automations.
The display name shown in Home Assistant can be translated, and older installations may already have a different registry ID. If you cannot find an entity by display name, open the entity list and search for the documented entity_id or the f1_ suffix instead. If you already have a working entity with a different registry ID from an older release, keep using that existing ID.
Where can I find the Race Control messages (like flag notices, safety car deploy messages)?
Race Control messages are available in two ways:
-
Sensor:
sensor.f1_race_controlshows the latest message and maintains a history. See Race Control for details. -
Events: Messages are also emitted as
f1_sensor_race_control_eventevents for automation triggers. See Events for the event format.
For example automations, check the Automation page.
How can I tell which session is currently live (Practice, Qualifying, Race, etc.)?
As of version 2.2.0, there is a sensor for this. The integration provides sensor.f1_current_session which indicates the name of the session that is currently running.
For example, it will show values like “Practice 1”, “Qualifying”, “Sprint Shootout”, or “Race” when those sessions are in progress. This complements the sensor.f1_session_status sensor (which shows the state like pre/live/finished) by telling you exactly which session is active.
This is useful for automations or dashboards that need to behave differently for practice vs. race, etc.
Does the integration include live flag status and safety car information?
Yes. The F1 Sensor integration has live sensors for track flags and safety car status. The entity sensor.f1_track_status reflects the current track flag/status in real time (possible states include CLEAR, YELLOW, VSC, SC, RED, etc.).
Additionally, binary_sensor.f1_safety_car turns on whenever a Safety Car or Virtual Safety Car is active on track. These live sensors let you react to yellow/red flags or safety car deployments in your Home Assistant automations (for example, changing lights to red on a red flag).
Can F1 Sensor show live driver positions or lap times like a Formula 1 timing tower?
Yes. The sensor.f1_driver_positions sensor provides live driver positions, lap times, sector times, pit status, and more during an active session. There are also dedicated sensor.f1_top_three_p1, sensor.f1_top_three_p2, and sensor.f1_top_three_p3 sensors for the current top three positions, and sensor.f1_current_tyres for each driver’s current tyre compound. See Driver Positions for full details.
How can I display “Lap X of Y” for the current race?
The integration provides the current lap number as sensor.f1_race_lap_count during an active race. To get the total number of laps, use the sensor’s attributes. The sensor.f1_race_lap_count sensor has an attribute named total_laps that represents the total laps scheduled for the race.
For example, if the sensor state is 12 and the total_laps attribute is 56, you can construct a template or use a custom card to show “Lap 12 of 56.”
(If you see total_laps: unknown, it may mean the race info hasn’t fully synced yet or you’re checking outside of an active race. It should populate once the race session data is live.)
Troubleshooting
I updated F1 Sensor but I don’t see the new sensors (like track status or weather) – where are they?
You likely need to enable the new live data sensors in the integration’s config.
After updating to a version that introduces new sensors, open the F1 Sensor integration’s options (Reconfigure) and make sure “Enable live F1 API” or the relevant option is turned on. Once enabled and saved, the new sensors (e.g. session status, track status, etc.) will be created.
This step is required because live data is off by default until you opt-in.*
Can't find the answer you're looking for?
If you're still having issues, head over to the Contact page.