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
Do I still need to install the separate F1 Sensor Live Data Card repository?
No. The Live Data Cards are bundled with F1 Sensor. Install or update the integration, restart Home Assistant, and F1 Sensor registers the dashboard card resource automatically.
If you previously installed f1-sensor-live-data-card as a separate HACS dashboard repository, keep your dashboard card configuration unchanged. After confirming the bundled card loads correctly, remove the old standalone card repository and any stale dashboard resource entries so Home Assistant does not keep loading an older card file.
If Home Assistant Repairs reports Old standalone F1 live data card resources detected, it means one or more old standalone resource URLs are still configured. Remove those old resources after confirming the bundled card works.
Why does a dashboard still show an old card after updating F1 Sensor?
Home Assistant and your browser can cache dashboard JavaScript. Restart Home Assistant after updating F1 Sensor, then reload the browser tab or clear the Home Assistant frontend cache.
If the old standalone card was installed before, also check Settings > Dashboards > Resources and remove stale entries such as /local/f1-sensor-live-data-card.js or /hacsfiles/f1-sensor-live-data-card/.... Keep the bundled F1 Sensor resource that points to /local/f1-sensor-live-data-card/f1-sensor-live-data-card.js?v=....
The same cleanup clears the Home Assistant Repairs warning for stale standalone live data card resources.
Why are some entities like Pit Stops and Championship Prediction unavailable without F1TV Auth testing?
These entities depend on data streams that are not part of public live timing. They can update in Replay Mode, and they can be tested during real live sessions when experimental F1TV Auth testing is paired with a valid token. Without that token, they remain unavailable while public live timing continues.
The affected entities are:
sensor.f1_pitstopssensor.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.