v5.2.0

F1 Sensor – v5.2.0

This release focuses on live data card readability, timing accuracy, Track Map synchronization, and more flexible incident notifications.

Version 5.2 adds configurable font styles, optional sector columns for Practice and Race timing views, track limits filtering in Race Control, activation and content options for the Incident Notifications blueprint, and several fixes that keep card data aligned with official Formula 1 timing and Home Assistant unit preferences.

Existing setups continue to work without configuration changes. New display and notification options are disabled by default or only take effect when configured, except that the Incident Notifications blueprint now uses shorter notification text by default for better TV overlay readability.

What this means in practice

The live data card is easier to tune for different dashboards. You can keep the familiar wide F1-style typography, switch to a more balanced layout for compact or mobile dashboards, or use the Home Assistant/system font for maximum readability.

Practice and Race timing cards can now show S1, S2, and S3 sector columns with timing highlights. Sector values stay aligned by lap, so completed sectors remain together until the driver starts the next sector sequence instead of mixing times from different laps.

Race Control can now hide track limits notices from the latest banner and saved message list without deleting the saved Race Control history. This helps keep race dashboards focused while preserving the underlying messages.

Track Map now respects the configured Live Delay during live sessions, keeping car markers synchronized with the rest of the live data card and delayed TV or streaming broadcasts. Replay playback remains immediate.

The Incident Notifications blueprint can now be gated by presence, media player state, do-not-disturb windows, or custom Home Assistant conditions. It also uses compact notification text by default so incident alerts are easier to read when shown briefly on a TV. Users can choose compact, standard, or detailed messages, include confidence in the message, and select which extra details should appear.

Full changelog

New features

• Add configurable font styles to the live data card
  The live data card now offers wide, balanced, and system font styles. The default wide style preserves the familiar F1 appearance, while balanced and system styles improve readability on compact, mobile, and Sections dashboards.

• Add optional sector columns to the live data card
  Practice and Race timing views can now display S1, S2, and S3 timing columns with sector performance highlighting. The columns are disabled by default, so existing card layouts remain unchanged until the option is enabled. Fixes #566.

• Add track limits filtering to the live data card
  The Race Control card can now hide track limits notices from both the latest banner and the saved message list. Filtering only affects displayed messages and preserves the saved Race Control history. Fixes #562.

Bug fixes

• Keep live data card sector times aligned by lap
  The live data card now retains and dims all three sector times from the completed lap until the driver completes the next S1. Practice, Race, and Qualifying views now handle sector transitions consistently without mixing times from different laps. Fixes #566.

• Align live data card position lines with official race results
  The lap position progression card now ends each driver's line at the official classified finishing position. This keeps the graph consistent when penalties or other post-race adjustments differ from the final lap timing order.

• Handle unavailable replay positions in the F1 Sensor integration and live data card
  F1 Sensor now ignores invalid position frames that would place every car at the same zero coordinates. The Track Map card reports that replay position data is unavailable and automatically recovers when valid data resumes.

• Match F1 weather sensor and live data card units with Home Assistant
  The F1 Sensor integration now converts weather sensor temperatures using Home Assistant's selected unit system. The live data card uses the same temperature and wind units for current conditions and forecasts, keeping values consistent across sensors and cards. Fixes #569.

• Synchronize the live data card Track Map with manual timing delay
  Live Track Map updates now follow the configured Live Delay, keeping car positions synchronized with other live data card content and TV broadcasts. Replay playback remains immediate. Fixes #570.

Blueprints

• Add activation conditions to the Incident Notifications blueprint
  The Incident Notifications blueprint can now send alerts only when selected presence, media player, time, or custom conditions are met. Existing automations continue to work unchanged until conditions are configured.

• Add compact Incident Notifications message options
  The Incident Notifications blueprint now uses short notification text by default for TV overlays and other brief display targets. Users can choose compact, standard, or detailed message styles, include confidence in the message text, and select which extra details appear in standard messages. Existing setups are not broken, but users may want to review the new notification content options after updating.

Documentation

• Update documentation for the 5.2 live data card options, including font styles, optional sector columns, track limits filtering, and sector alignment behavior.
• Document Track Map synchronization with Live Delay and unavailable position data handling.
• Document Incident Notifications activation conditions and compact message options.
• Clarify weather unit behavior for Home Assistant temperature preferences.

Maintenance

• Improve font handling in bundled live data cards.
• Expand automated coverage for weather units, Race Control filtering, timing card sectors, Track Map delay behavior, and incident notification conditions.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

v5.1.0

F1 Sensor – v5.1.0

This release introduces two major new capabilities: a Live Track Map with driver positions and Incident Detection for likely stopped cars and on-track incidents.

Version 5.1 also adds a ready-to-use Incident Notifications blueprint, new championship and race progression charts, improved Replay Mode controls, compact dashboard layouts, and several reliability and usability improvements.

F1 Sensor continues to work without F1TV access. Public live timing supports confirmed incident alerts, while optional F1TV Auth unlocks the Live Track Map and can provide earlier incident candidates and additional location context.

What this means in practice

The new Track Map card provides a visual overview of driver positions during supported live and replay sessions. It includes circuit layouts, smoothly moving driver markers, lap progress, track status, timing context, and configurable display options. Live Track Map data requires F1TV Auth, while replay availability depends on the archived session data.

Incident Detection can identify likely stopped cars and other possible on-track incidents. Confirmed alerts work with public live timing, while optional F1TV Auth data can provide earlier candidate alerts. Fresh Track Map data can also add details such as the sector, pit-lane state, or approximate location.

The new Incident Notifications blueprint lets you receive alerts without writing YAML. It supports confidence and session filters, multiple notification targets, optional candidate and cleared alerts, and notification updates for the same incident. Its conservative defaults notify only for confirmed or updated medium- and high-confidence incidents during Race, Sprint, and Qualifying sessions.

Incident Detection is a best-effort feature and does not claim to provide confirmed crash detection. Most existing installations and dashboards continue to work without configuration changes.

Full changelog

New features

• Add Live Track Map support
  The F1 Sensor integration and live data card can now display driver positions on a circuit map during supported live and replay sessions. Known circuits use curated layouts, while other circuits can fall back to available position data when a usable map can be created.

• Add on-track Incident Detection
  F1 Sensor can now detect likely stopped cars and on-track incidents during Race, Sprint, Qualifying, and Practice sessions. The integration provides confirmed and possible incident binary sensors, device triggers, and detailed events for dashboards and automations.

• Add early possible incident automation support
  The possible incident sensor can react to candidate alerts before an incident is fully confirmed. The existing confirmed incident sensor keeps its confirmed-only behavior, and detection has been refined to reduce false positives around pit-lane yellows, deleted laps, red flags, and driver data updates.

• Add the Incident Notifications blueprint
  A new ready-to-use blueprint sends neutral notifications when likely stopped cars or on-track incidents are detected. It supports mobile app notification services, Home Assistant notify entities, and multiple notification targets.

  Users can filter notifications by minimum confidence and session type, enable earlier candidate alerts, and optionally receive an update when an incident is cleared. Conservative defaults include Race, Sprint, and Qualifying sessions while excluding Practice, Testing, and early candidate alerts.

  Notifications can include the affected driver, session, confidence, Race Control information, track status, and optional Track Map location. A stable incident tag allows supported devices to update an existing notification when more information becomes available instead of creating duplicates.

• Add optional incident location context
  Fresh Track Map data can add sector, pit-lane, and location information to incident events and notifications. Track Map and F1TV Auth are not required for confirmed incident detection using public live timing.

• Add driver and constructor championship progression cards
  New live data cards show how driver and constructor championship points develop throughout the season. The cards include future rounds, configurable legends, point labels, driver photos, team logos, and detailed tooltips.

• Add post-race lap position progression
  Completed races can now be explored through a lap-by-lap position chart. The card includes race selection, driver filtering, start and finish labels, tooltips, and No Spoiler Mode support. Sprint entries show as unavailable when lap-by-lap sprint data is not provided.

• Add replay seeking
  Replay Mode now supports faster seeking through the media player and a draggable dashboard playbar while keeping the existing skip controls. Timing, Race Control, session clock, and Track Map data remain synchronized after seeking.

• Add compact live data card layouts
  The Live Session Status card now adapts better to mobile and Sections dashboards. Users can select Auto, Compact, or Full layout modes.

• Promote F1TV Auth to a standard optional feature
  F1TV Auth is now presented as the normal optional method for unlocking additional live timing data such as Live Track Map positions. Public live timing remains available without authentication.

Bug fixes

• Correct Track Status Light blueprint behavior
  The Track Status Light blueprint now preserves the original light state when several alerts occur before the track becomes clear. Session filtering also remains active during suspended sessions so consecutive flag changes continue to update the selected lights correctly.

• Improve Replay Mode reliability
  Replay controls now load more reliably in current Home Assistant versions and remain available alongside the new seek slider.

• Restore Practice timing card data
  Practice timing details now remain visible when valid driver data is available but the lap-count sensor has an unknown or unavailable state.

• Correct pit stop statistics and recorder warnings
  Pit stop totals now use appropriate long-term statistics handling and can be corrected or reset without inaccurate recorder warnings. Home Assistant may show a one-time repair prompt for an old pit stop statistics entry.

• Avoid premature tyre-data warnings
  Tyre-data warnings now wait until the session has started, avoiding false alerts before live timing begins.

• Improve temporary data error reporting
  Coordinator timeouts and temporary upstream data failures are now reported more clearly without changing existing entity behavior.

• Prevent slow next race updates
  Next race details are now prepared between schedule updates, preventing slow update warnings after Home Assistant restarts.

• Improve F1TV Auth repair handling
  Expired or rejected F1TV access now uses the F1 Sensor repair flow without also creating a separate Home Assistant authentication error. Public live timing remains available while access is refreshed or cleared.

• Respect Home Assistant time format settings
  Race, session, track, grid, and document times now follow the configured 12-hour or 24-hour Home Assistant time format.

• Clarify active No Spoiler Mode
  Spoiler-sensitive cards now show a clear notice and dim their content when No Spoiler Mode is active.

• Improve card readability and spacing
  Position movement indicators have clearer light-mode contrast, and table spacing is more consistent across result, championship, pit stop, tyre, and investigation cards.

Documentation

• Add complete guides for Track Map and Incident Detection.
• Add setup instructions and configuration details for the Incident Notifications blueprint.
• Document incident entities, events, device triggers, confidence levels, and incident phases.
• Add setup and troubleshooting guidance for F1TV Auth.
• Clarify the differences between public live timing, F1TV Auth, Replay Mode, and Developer mode.
• Clarify Replay Mode seeking and Live Delay synchronization with TV lap graphics.
• Explain F1TV subscription requirements and feature availability.
• Expand diagnostics and troubleshooting guidance for incident alerts and Track Map data.

Maintenance

• Improve validation and safe handling of live timing, replay, Race Control, and FIA document data.
• Prevent unsafe external content from being rendered by the live data card.
• Improve automated testing for bundled dashboard cards, blueprints, Incident Detection, Track Map, and Replay Mode.
• Update translations and internal dependencies.

Support This Project

If you find F1 Sensor useful, consider supporting its development.

...

v5.0.1

F1 Sensor – v5.0.1

Bug fixes

• Fix compact layout mode for the live data card
  The live data card now supports an automatic compact layout for narrow mobile and Sections dashboards, reducing empty space in the F1 Live Session Status card. Existing setups keep working without changes, while users can choose Auto, Compact, or Full layout mode from the card display settings.

• Clarify active No Spoiler Mode in the live data card
  The live data card now clearly shows when No Spoiler Mode is active by dimming spoiler-sensitive views and displaying an explanatory notice. This helps users understand why live and results data appears frozen instead of mistaking it for missing data or a broken setup. The F1 Sensor integration keeps existing sensor states and automations unchanged, and no user action is required.

• Improve live data card readability and row spacing
  The live data card now shows position movement indicators with clearer contrast in light mode, making gained and lost positions easier to read. Row spacing is also aligned across the affected result, championship, pit stop, tyre, and investigation views for a more consistent layout. Existing card configurations continue to work without changes.

• Respect Home Assistant time format settings in F1 Sensor times
  The F1 Sensor integration and live data card now respect Home Assistant's 12-hour and 24-hour time format settings when showing race, session, track, document, and grid update times. Existing setups continue to work, with added machine-readable track time attributes for more consistent localized display.

• Keep live data card spacing and contrast consistent

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

v5.0.0

F1 Sensor – v5.0.0

This release is a major step for F1 Sensor. It focuses on two large changes: experimental F1TV Auth testing for expanded live timing coverage, and moving the F1 live data cards into the F1 Sensor integration itself with a coouple of new cards as well, and the possibility to use them in light mode!

F1 Sensor still works without F1TV access. Public live timing remains the default, and existing users do not need to configure authentication to keep using the integration. The new F1TV Auth flow is optional, experimental, and intended for beta testing extra live timing streams that Formula 1 no longer provides publicly.

The live data cards are now bundled with F1 Sensor. Existing dashboard card types stay the same, but users who previously installed the standalone F1 Sensor Live Data Card repository should remove the old HACS dashboard repository and stale Lovelace resources after confirming that the bundled cards work.

What this means in practice

You now install and update one HACS integration instead of maintaining a separate dashboard card repository. F1 Sensor registers the bundled card resource automatically and uses a versioned card URL so browser reloads can pick up new card assets after updates.

F1TV Auth testing uses the separate F1TV Token Helper browser extension. Home Assistant never asks for your F1TV username or password. If the token expires or is rejected, F1 Sensor should fall back to public live timing while only the F1TV-only data becomes unavailable.

Read more about F1TV Auth testing here

Full changelog

New features

• Add experimental F1TV Auth testing for expanded live timing coverage
  F1 Sensor can now test selected F1TV-authenticated live timing streams during active sessions when a valid token is provided. The feature is optional, experimental, and includes Token Helper pairing, token status sensors, refresh and clear buttons, repair handling, and fallback to public live timing when auth is missing or no longer valid.

• Bundle the live data cards with F1 Sensor
  The F1 live data cards now ship with the integration and are registered automatically during setup. Existing dashboard card types remain unchanged, while known old standalone card resources are updated to the bundled card URL where possible.

• Add new dashboard cards for replay, FIA documents, starting grids, and results
  This release adds a Replay Control card, FIA Documents card, Starting Grid card, and expanded Results card support. These cards make it easier to control replay mode, browse official FIA documents, inspect Sprint and Race grids, and compare race or sprint classifications directly in Home Assistant.

• Add starting grid data for Sprint and Race sessions
  F1 Sensor now exposes experimental starting grid data for the current race weekend. It can show provisional qualifying-based grids and update to confirmed grid positions when available before Sprint or Race starts.

• Improve race, sprint, and live timing data
  Driver positions can now include public race gaps and intervals when available. Historical race and sprint results now include grid positions and lap data where available, making result views more complete.

• Improve sector timing data and card display
  Sector timing now tracks the active lap, latest completed sector, and personal best sector data more clearly. The qualifying timing card now shows current lap sectors by default, while still allowing personal-best or hybrid sector display modes.

• Expand FIA documents sensor details
  The FIA documents sensor now includes richer document metadata for dashboards, including race context and available document lists, without changing the existing latest-document behavior.

• Add light and automatic theme modes to F1 cards
  F1 cards now support dark, light, and automatic theme modes per card. Existing cards keep the dark appearance by default, while light and automatic modes improve readability across different Home Assistant themes.

• Add circuit outline attributes
  Circuit data now includes circuit outline information where available, giving dashboards another way to display race weekend context.

Bug fixes

• Correct live timing start when official session times change late
  F1 Sensor now checks a more current Formula 1 schedule source before starting near-term live sessions, preventing delayed live timing when official session times change close to the event.

• Keep live timing connected during corrected session schedules
  Recently confirmed corrected session times are preserved while a live session is active, helping live timing reconnect reliably after temporary interruptions.

• Prevent season result sensors from failing when data is temporarily unavailable
  Season result entities now handle missing upstream data more gracefully, keeping dashboards and automations stable when result data is blocked or temporarily unavailable.

• Prevent stale track weather before the first live update
  Track weather now stays unavailable until fresh session weather data arrives, avoiding old weather values from a previous session being shown as current.

• Keep timing cards visible after a session ends
  Live practice, qualifying, and race timing cards now remain visible briefly after a session finishes, so dashboards do not disappear immediately while the last timing data is still useful.

• Improve lap trend arrows and sprint weekend ordering
  Faster laps now use a green downward arrow and slower laps use a red upward arrow. Sprint weekend session ordering has also been corrected in the card schedule view.

• Remove unavailable Team Radio support
  Team Radio is no longer exposed because the current 2026 stream does not provide usable data in live, replay, or F1TV Auth testing modes.

• Improve card availability and contrast handling
  F1TV availability notices now better recognize configured F1TV access, and replay dropdowns remain readable in dark mode.

Maintenance

• Guide cleanup of old standalone live data card resources
  Home Assistant Repairs can now warn when old standalone live data card resources are still configured. Remove the old standalone HACS dashboard repository and stale Lovelace resources after confirming the bundled cards work.

• Improve dashboard card layout and responsiveness
  Several F1 cards now adapt better across different dashboard widths, with cleaner table spacing, improved timing columns, better compact layouts, and improved document and race overview presentation.

• Improve light mode readability
  Light mode now has clearer contrast for warnings, badges, timing highlights, buttons, and logos while preserving the existing dark theme behavior.

• Clarify tyre statistics waiting status
  Tyre statistics now show when live timing is available but tyre compound data has not arrived yet, making delayed upstream tyre data easier to understand.

• Mark integration setup as config entry only
  F1 Sensor now clearly declares that setup is handled through the Home Assistant UI, resolving a Home Assistant validation warning without changing existing setups.

Other changes

• Update Finnish and Italian translations.
• Update card data for newer Formula 1 team naming.
• Improve tests, linting, and workflow maintenance.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

v4.2.0

F1 Sensor – v4.2.0

The 2026 season has already brought more than just racing, it has also introduced fundamental changes to how Formula 1 delivers live timing data.

Over the past weeks, several users reported missing or inconsistent data during live sessions, while everything appeared to work perfectly in Replay Mode. After deeper analysis, the root cause became clear: parts of the F1 Live Timing API are no longer publicly available and now require authentication through an F1 TV subscription.

This version adapts the integration to that new reality.

What this means in practice

The majority of what makes F1 Sensor useful, live timing, track status, race control, lap data, weather, and driver information, continues to work exactly as before using open data streams.

However, some data streams are now protected behind authentication. Since the integration does not implement F1 TV login, these sensors will no longer attempt to provide partial or misleading live data. Instead, they are now clearly handled as replay-only, where full session data is still available from archived sources.

This creates a more predictable and stable experience, where everything you see in live mode is reliable.

About authentication support

Authentication support is not included in this release.

Implementing it properly requires access to a working F1 TV Pro subscription for testing and validation, which is not something I currently have. More importantly, introducing partially tested authentication would risk breaking the stable live data that already works well today.

For now, the focus is on making the open data as robust and accurate as possible across real race weekends.

If there is strong interest and support from the community, and especially if users with access to F1 TV Pro want to contribute with testing or development, this is something that can be explored further in the future. Read more about this in the Community Forum

Highlights in 4.2

A more predictable live experience
Live mode now focuses only on data that is actually available without authentication. Sensors that previously showed incomplete or misleading values have been cleanly separated, so what you see during a session is consistent and reliable. No more guessing if a value is correct or silently missing.

Replay Mode becomes more powerful
With several data streams now unavailable live, Replay Mode becomes even more valuable. All replay-only sensors now work as expected when playing back a session, giving you access to the full dataset after the race with improved consistency and timing behavior.

Reliable tyre data in live sessions
Tyre data has been moved to a stable and verified data source. Compound, stint length, and new or used status now update correctly during live sessions, removing one of the most common sources of confusion during races.

Much more stable live timing connection
The integration now uses the modern SignalR protocol, eliminating the reconnect patterns seen in previous versions. This results in a significantly more stable connection during race weekends, especially during long sessions.

Richer next race insights
The next race sensor now includes historical circuit context such as previous winners, pole sitters, and key statistics. This makes dashboards and automations more informative without adding complexity.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

Full changelog

New features

• Add historical race facts to the next race sensor
  The next race sensor now includes historical circuit facts that make upcoming events more informative in dashboards and automations. It adds defending winner and pole sitter, the last five winners and poles, all-time top winners at the circuit, the first race held there, last year's podium, and summary stats such as recent DNF rate and grid-to-win conversion. This gives a much richer view of each upcoming Grand Prix while keeping the data stable and efficiently cached.

Bug fixes

• Improve FIA document fetch reliability and remove a misleading Home Assistant warning
  The FIA documents sensor now uses the same request headers as the rest of the integration when looking up FIA season pages, which makes document fetching more reliable when the FIA portal is strict about incoming requests. Temporary FIA access errors are also handled more cleanly, so they no longer produce a confusing "Future exception was never retrieved" warning in the Home Assistant log.

• Keep qualifying lap times updating until the session is fully finalised
  Qualifying and sprint qualifying lap times now continue updating after the session first reaches finished status, so the final valid laps are still reflected correctly in the timing card. This prevents the last drivers’ times from freezing too early while preserving the normal stop point once the session is actually finalised.

• Keep replay timers stable when pausing and resuming playback
  Replay mode now freezes the session clock at the current replay position when you pause, instead of jumping to an older timestamp and then correcting itself on resume. This keeps session time elapsed, session time remaining, and the race 3-hour limit steady and consistent during pause, play, and seek actions so replay timing matches what you see on screen.

• Move live tyre data to TimingAppData
  Live tyre handling now reads compound, new-set status, and stint length directly from TimingAppData instead of relying on TyreStintSeries. This makes current tyre and tyre statistics sensors update reliably in live sessions and replay mode, even when the old stream is missing or incomplete. The change also removes the unused TyreStintSeries dependency from diagnostics and replay loading so behaviour is more consistent across live and replay sessions.

• Restore live formation start detection during race starts
  This update improves the reliability of the formation start sensor during live sessions. The integration now detects formation start from the live timing feed more consistently and also handles delayed session metadata more safely, so the sensor is available when the formation lap begins. Replay behavior remains unchanged and continues to work as before.

• Restore live pit stop counts when pit stop events are missing
  Live race pit stop counts now stay accurate even when some pit stop event frames arrive late or are missing from the feed. The integration falls back to the live driver timing data so pit stop sensors and race cards continue to show the correct totals during the session.

• Restore No Spoiler Mode when the integration is reloaded
  Fixed an issue where No Spoiler Mode could disappear for some users after reloading or reconfiguring the integration. The switch now remains available and can be enabled again normally, so spoiler protection is easier to trust and recover without manual cleanup or a full restart.

• Restore replay updates for live weather, lap count, and championship prediction sensors
  Replay sessions now keep the live weather, lap count, and championship prediction sensors updated instead of leaving them unavailable or unknown after playback starts. This fixes replay handling so sensor availability follows incoming race data correctly, and driver prediction results keep their displayed identity even when Formula 1 sends partial updates. Users running race replays should now see these sensors populate reliably from the start of the session.

• Correct formation start sensor activation during race and sprint sessions
  The formation start sensor was never turning on during formation laps due to a timing error that caused the detection probe to run before any useful data was available, resulting in repeated failures and the sensor staying permanently off. The probe now runs at the correct moment, reliably detecting when the formation lap begins and activating the sensor for the window between the formation lap start and lights out. The sensor is also now available in replay mode, driven by the replayed session data in the same way as all other sensors.

• Freeze replay session timers when playback is paused
  Replay Mode now keeps the session clock aligned with the actual playback state when you pause a replay. Session timers no longer continue counting in the background, which keeps the live session card and related timer entities in sync until playback resumes.

• Freeze time in circuit map test to prevent date-dependent failures
  The test used a hardcoded race date without mocking the clock, causing it to fail once the race date plus the 3-hour grace period had passed. This adds a monkeypatch to freeze time before the race, matching the pattern already used in other next-race sensor tests.

• Keep sensors loading when FIA documents are temporarily unavailable
  The integration now starts normally even if the FIA document site temporarily rejects requests, including intermittent or regional 403 responses. FIA documents are treated as optional during startup, so the rest of your F1 sensors remain available instead...

v4.1.0

F1 Sensor – v4.1.0

The opening weekend in Melbourne did not only give us racing, it also provided valuable feedback from real world use of F1 Sensor 4.0. During the race in Australia, a number of bugs and edge cases were identified in live timing, Replay Mode, and some sensors.

This update therefore focuses mainly on stability and bug fixes, while also introducing a few new features that make the integration even more flexible and useful. If you enjoy using F1 Sensor and want to support its continued development, you can do so via Buy Me a Coffee.

Highlights in 4.1

No Spoiler Mode

A new global setting makes it possible to freeze all results, live data, and standings until you choose to enable them again. Perfect if you cannot watch the race live and want to avoid spoilers on your dashboard.

Replay Mode – 30 second catch-up controls (experimental)

Replay Mode now includes experimental buttons to jump 30 seconds backward or forward. When you jump, all events within that interval are replayed so that track status, race control, and other sensors end up in the correct state.

More detailed qualifying data

The Driver Position sensor now includes more information from qualifying, including times for Q1, Q2, and Q3, segment positions, and whether a driver was eliminated in a segment. This makes it possible to display the full qualifying picture directly in dashboards.

Sector times with F1 color logic

Sector times are now available directly in the Driver Positions sensor with support for classic F1 logic.

Improved lighting automations

The Track Status blueprint can now control light groups, not just individual lights, making it easier to build race lights at home.

RGB color attributes for teams and tyres

Team and tyre colors are now also exposed as RGB values, making them easier to use directly in Home Assistant automations.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

---

Full changelog

New features

• Add experimental 30-second replay catch-up controls
  Replay Mode now includes experimental Back 30 seconds and Forward 30 seconds controls to help you manually catch up with delayed broadcaster replays. When you jump, the integration replays the events inside that window so track status, Race Control, and other replay-driven states land in the correct state at the new position. This is a Version 1 experimental feature and may be refined further as real-world feedback comes in.

• Add No Spoiler Mode to prevent F1 session results from reaching your dashboard
  A new global switch called "No Spoiler Mode" is now available under the F1 Sensor system device. When turned on, all live session data, race results, standings, and FIA documents are frozen so no spoilers can appear in your dashboard while you are waiting to watch a session. Schedule and calendar data continue to update as normal so you always know when the next race is. When you turn the mode off, all blocked data is immediately refreshed and delivered. The setting is remembered across Home Assistant restarts.

• Add qualifying segment times and elimination status to driver positions sensor
  Each driver in the driver positions sensor now includes their best lap time from Q1, Q2, and Q3 separately, along with their finishing position within each segment and whether they were eliminated at the end of that segment. A new top-level attribute shows which qualifying segment is currently active. This makes it possible to build dashboards that display the full qualifying picture, including who was knocked out in Q1 and Q2, all within a single sensor.

• Add sector times to driver positions with purple, green, and yellow classification support
  Each driver in the driver positions sensor now includes current lap sector times for all three sectors, along with flags indicating whether each sector is the session's overall fastest (purple) or the driver's personal best (green). Personal best sector times are also tracked separately, giving dashboards everything needed to display sector timing in the classic F1 color scheme. Sector times are automatically cleared during safety car and virtual safety car periods, reset between qualifying segments, and preserved after the session ends for post-race review.

• Allow the track status blueprint to control light groups
  The track status blueprint now lets you select either a single light or a light group as the target. This makes it easier to drive multiple lights from one automation without extra wrappers or duplicate automations. Existing setups that target a single light continue to behave the same way.

• Add RGB color attributes to driver and tyre sensors
  Sensors that expose team or tyre compound colors now include a companion RGB attribute alongside the existing hex value. The new attributes, team_color_rgb and compound_color_rgb, return the color as a list of three integers such as [220, 0, 0], which can be passed directly to light entities in automations and scripts without any template conversion. Existing attributes are unchanged.

Blueprints

• Add optional WLED preset support to the F1 Track Status blueprint
  The F1 Track Status blueprint can now control a single WLED light using Home Assistant preset entities while still working the same way for regular lights and groups. This makes it possible to use WLED presets for race states such as yellow, red, safety car, and virtual safety car, including any animations or segment layouts stored in those presets. The update also improves scene snapshot and restore behavior so WLED companion settings like preset, palette, intensity, and speed are restored more reliably without affecting existing setups.

• Add an option to mute blue flag notifications in the Race Control blueprint
  Blue flag messages can now be filtered out in the Race Control Notifications blueprint. This helps reduce notification spam during busy parts of a race while keeping other race control alerts active. Existing automations keep their current behavior until you enable the new filter.

• Correct condition evaluation in F1 track light and race control blueprints
  This update fixes a condition handling issue that could cause automations to behave incorrectly even when filters should block or allow actions. The track status light blueprint and the race control notification blueprint now evaluate their gating conditions reliably, so session, DND, and filter logic works as intended. As a result, notifications and light changes trigger only when the configured rules are actually met.

• Stop the track status blueprint from retriggering on session updates
  The track status light blueprint now reacts only to real track status changes and the initial transition into an active session. This prevents extra automation runs and repeated light changes when session status updates during a session, while still keeping the light in sync at session start and turning it off correctly when the session ends.

• Add optional Activation Conditions to F1 race control and track status blueprints
  Both blueprints now include a new optional Activation Condition field so advanced users can add flexible state-based logic, including combinations like state, not-state, and grouped conditions. This gives more control over when notifications and light behavior should run.

Bug fixes

• Clear live mode sensors when a session officially ends
  Overtake and related live mode sensors now clear as soon as a session is officially finished, so stale race states no longer remain visible after the end of a session. The integration still follows the official timing feed and will not force Overtake mode to OFF unless that status is actually published. This keeps post-session behavior consistent without inventing states that do not exist upstream.

• Correct Q3 knockout shading for drivers eliminated in Q2
  Drivers eliminated in Q2 could be shown incorrectly during Q3 because they were still present in the timing snapshot. This fix now follows the official qualifying data more accurately, so Q1 and Q2 eliminations are exposed correctly and qualifying timing cards dim the right drivers at the right time.

• Correct stop-and-go investigation status handling
  Investigations and penalties now update correctly when a driver receives a stop-and-go penalty and later serves it. This prevents drivers from remaining incorrectly marked as under investigation after the stewards have issued and completed the penalty, improving live race accuracy.

• Improve delayed live timing updates for Top 3 and other fast race data
  This improves how fast-changing live session data appears when live delay is enabled, so Top 3 updates are surfaced more promptly and delayed race data is less likely to appear stuck. The existing delayed delivery model for dense live updates is preserved, keeping the integration aligned with the official timing feed instead of inventing fallback states. Team Radio continues to follow the upstream feed only when that data is actually present.

• Keep current session visible during qualifying replays
  The current session sensor now stays aligned with replay playback during qualifying sessions instead of falling back to Unknown after the original session end time has passed. This makes replay mode more reliable and keeps dashb...

v4.0.0

F1 Sensor – v4.0.0

"Good morning, good afternoon, good evening, wherever you are watching us from, it is finally time, all of the questions we’ve asked will get an answer. Welcome to Melbourne"

It’s been a long winter, and the last two weeks have been packed with testing and improvements during pre season. This is the final update before lights out in Melbourne.

Live Data Card, Blueprints, and a lot of improvements

This release brings improved live sync with lap identification, support for brand new live data cards, and official blueprints for automations.

📚 F1 Sensor documentation - https://nicxe.github.io/f1_sensor/

☕ Support This Project

If you find F1 Sensor useful and want to support continued development, you can do so via Buy Me a Coffee. Your support helps fund ongoing maintenance, new features, and long term improvements.

---

Better live delay sync with mid race lap identification

A new calibration reference, Lap sync (race/sprint), lets you sync live delay at any point during a race or sprint.

Official blueprints, now clearer and more controllable

Two fully supported blueprints are included:
• Race Control notifications
• Track Status lights and notifications

New calendar entity for the full F1 season schedule

The full season schedule is now available as a native Home Assistant calendar entity.
Each session appears as a separate calendar event with accurate start times, location, and description, including practice, qualifying, sprint qualifying, sprint, and race.

Experimental 2026 regulation sensors

Two new live sensors are added to reflect 2026 regulation changes replacing DRS:
• Straight Mode with states normal grip, low grip, disabled
• Overtake Mode binary sensor for track wide energy boost availability

These are based on pre season observations and should be considered experimental

New device structure and automation triggers

F1 Sensor is now split into six dedicated sub devices, making everything easier to browse and automate: Race, Championship, Session, Drivers, Officials, and System.

You also get nineteen new device automation triggers directly in the Home Assistant automation editor

⚠️ BREAKING CHANGE
The previous single F1 Sensor device is replaced by six sub devices. Entity IDs do not change, but anything organized by device in dashboards, plus device based conditions or actions in automations, must be updated to the new structure.

F1 Sensor Live Data Cards

Full changelog

New features

• Add beta session timer sensors for elapsed and remaining F1 time
  This release introduces new session timer sensors that expose time remaining and time elapsed for live F1 sessions, with logic aligned to official timing streams and session start events instead of local restart time. The feature also includes race three-hour cap timing and improved fallback handling so timer values stay useful during reconnects and restarts. This is a beta feature and has not been fully validated across all race control scenarios yet, so behavior may still be adjusted as more real-world sessions are tested.

• Add experimental Straight Mode and Overtake Mode sensors for 2026 regulations
  Two new live sensors are added to reflect the 2026 regulation changes that replace DRS. The Straight Mode sensor shows whether the active aerodynamic system is permitted on track, with three possible states: normal grip, low grip, and disabled. The Overtake Mode binary sensor shows whether the track-wide energy deployment boost is currently available. Both sensors are based on data observed during 2026 pre-season testing and should be considered experimental until confirmed against live race conditions. The exact messaging format from Formula 1 may be adjusted in a future update once the first race weekend has been evaluated.

• Add F1 season calendar entity with per-session events
  The full Formula 1 season schedule is now available as a native Home Assistant calendar entity. Each session, including practices, qualifying, sprint qualifying, sprint, and race, appears as a separate calendar event with accurate start times, location, and description. This makes it possible to view the entire season in the Home Assistant calendar panel and to create automations that trigger based on session times. The existing season sensor is not affected.

• Add mid-race lap sync for live delay calibration
  A new "Lap sync (race/sprint)" option is now available in the live delay reference selector, allowing users to synchronize their live delay at any point during a race or sprint session. When armed, the system captures the next completed lap as a reference point. The user then presses "Match live delay" when they see that same lap complete on their TV broadcast, and the delay is set automatically. This is especially useful for users who join a broadcast mid-race or need to recalibrate a drifted delay without waiting for the next session.

• Enable all sensors by default and auto-enable new sensors on update
  All sensors are now enabled by default when setting up the integration. Previously, users had to manually select which sensors to activate, and new sensors added in updates required reconfiguration to appear. The integration now stores which sensors the user has explicitly disabled rather than which ones are enabled, so any new sensor introduced in a future update is automatically available without requiring reconfiguration. The sensor multi-select remains available for users who want to disable specific sensors they do not need. Existing installations will have all new sensors enabled automatically on the next update, while previously disabled sensors remain unchanged.

• Split F1 Sensor into dedicated sub-devices and add automation triggers
  All entities are now organized across six dedicated devices: Race, Championship, Session, Drivers, Officials, and System. All entity IDs remain unchanged, so automations and dashboard cards that reference entities by their ID will continue to work without any modifications. Any automation that referenced the device itself, rather than individual entities, will need to be reviewed and updated to point to the correct new sub-device.

• Switch weather forecast provider to Open-Meteo for improved global accuracy
  The weather sensor now uses Open-Meteo instead of the previous provider to fetch forecasts for upcoming race locations. Open-Meteo automatically selects the best available weather model based on the circuit's geographic location, which means forecasts for races in Bahrain, Saudi Arabia, Japan, Singapore, the Americas, and other regions are significantly more accurate. All existing weather attributes remain unchanged, and three new attributes are now available for both current conditions and race start forecasts: wind gusts, visibility, and a standardized weather condition code.

Bug fixes

• Apply live delay to session elapsed and remaining timers
  Session Time Remaining and Session Time Elapsed now respect the configured live delay, so their values stay aligned with delayed live data. If live delay is set to 30 seconds, both timer sensors are delayed by 30 seconds as well. This keeps dashboard timing consistent across all live sensors.

• Entity names now display in the language configured in Home Assistant
  Entity names previously appeared in English regardless of which language was set in Home Assistant, because the built-in translation system was not being used. Names are now resolved from the active language and update automatically when the language preference is changed.

• Exclude high-frequency timer sensors from activity history logging
  Track Local Time, Session Time Remaining, and Session Time Elapsed are now excluded from activity history to prevent unnecessary per-second log noise. This reduces database churn and makes activity timelines easier to read while keeping the sensors fully available for dashboards and automations.

• Exclude race three-hour timer from live Activity logging
  This update fixes an issue where the race three-hour limit timer could still generate frequent Activity entries in the sensor view. The timer is now excluded the same way as the other high-frequency session timers, including live Logbook streaming and recorder filtering. This prevents per-second Activity spam while keeping the current state visible and accurate in the UI.

• Improve default sensor friendly names without changing existing entity IDs
  Sensor and binary sensor names now use cleaner, human-friendly labels such as Track status instead of underscored internal keys, and the redundant F1 prefix is removed from default friendly names. Existing user customizations are preserved, so manually renamed entities are not overwritten. Entity IDs remain stable through suggested object IDs, which avoids breaking dashboards and automations while improving naming for new or non-customized entities.

• Keep F1 Sensor available when a reload cannot complete cleanly
  This update improves rel...

v3.1.1

F1 Sensor – v3.1.1

Bug fixes

• Keep live timing active when the primary session index is outdated
  When the primary live schedule index is behind and does not include a newly started session, the integration now checks a secondary schedule source instead of staying idle. This allows live timing to connect during active sessions even when index updates are delayed. Session status parsing was also hardened for streamed responses, reducing false negatives that could otherwise stop live detection.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

v3.1.0

F1 Sensor – v3.1.0

Replay mode and expanded race intelligence

F1 Sensor 3.1 introduces Replay Mode, making it possible to replay historical Formula 1 sessions in real time directly in Home Assistant. Combined with a large set of new live sensors and reliability improvements, this release significantly expands both analysis and automation possibilities during race weekends.

If you find F1 Sensor useful and want to support continued development, you can do so via Buy Me a Coffee. Your support helps fund ongoing maintenance, new features, and long-term improvements.

---

Replay Mode

Replay Mode lets you replay historical F1 sessions while keeping all live sensors synchronized with the original session timeline.

• Replay races, sprints, and practice sessions in real time
• Live sensors update during playback, including race control, track status, weather, timing, and driver positions
• Pause, resume, and stop playback at any time
• Replay data is automatically cleaned up when playback stops

A dedicated Replay media player entity provides timeline controls and correct time handling while paused. For race and sprint sessions, playback can optionally start from the formation lap marker to better align with TV broadcasts.

Driver positions and timing

New and expanded timing data provides deeper insight into race progression.

• New Driver Positions sensor with grid position, current position, and lap times
• Pit in, pit out, and retirement status per driver
• Fastest lap details per driver, including lap number and lap time
• Indicator for the overall fastest lap of the session

Incidents, penalties, and track limits

Race control information is now exposed in more detail and with improved resilience.

• Track limits sensor with total counts and per-driver breakdowns
• Deleted lap times, warnings, and penalties per driver
• Investigations sensor showing active investigations, decisions, and historical outcomes
• Incident and track-limit data is preserved across Home Assistant restarts and cleared predictably when sessions end

Tire performance and strategy

Live tire data makes it easier to understand pace and strategy during sessions.

• New Tire Statistics sensor with aggregated tire performance data
• Top three fastest lap times per tire compound
• Total laps driven and tire sets used per compound
• Delta comparison between compounds
• Pit delta time showing total time loss compared to a normal race lap

Circuit and session context

Additional metadata improves context before and during sessions.

• Circuit map image URLs available in race sensors
• Country flag URLs for race and season sensors
• New sensor showing the current local time at the circuit, including time zone and UTC offset
• Extended session metadata available before sessions go live
• Improved handling of track grip status from race control messages

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

"F1-sensor live data cards" comming soon

Full changelog

New features

• Add a replay media player with timeline controls
  Adds a dedicated Replay media player entity so you can play, pause, stop, and scrub through historical sessions with a progress bar and time display. It keeps the timeline accurate by pausing time while playback is paused and resetting to zero when stopped.

• Add circuit map image URL to race sensors
  The Next Race and Current Season sensors now include a new attribute called circuit_map_url. This attribute provides a direct link to the official Formula 1 circuit layout image

• Add country flag URLs to race sensors
  The current season and next race sensors now include country flag information for each circuit location.

• Add driver positions sensor with lap-by-lap timing
  Introduces a new Driver Positions sensor that exposes grid position, current position, and lap times per driver for dashboards and automations.

• Add fastest lap details to driver positions
  Driver positions now include the overall fastest lap with the driver, lap number, and time, plus a per‑driver indicator you can use to highlight the fastest lap in dashboards and lists.

• Add pit and retirement status to driver positions attributes
  Driver positions sensor now expose clear status fields for pit in/out and retirements

• Add pit delta time to pit stops
  The pit stops sensor now reports pit delta, showing the total time loss from entering the pits, stopping, and rejoining compared to a normal race lap. This complements pit stop time and pit lane time so you can see the full impact of each stop in dashboards and automations.

• Add replay mode for watching historical F1 sessions
  You can now play back past F1 sessions synchronized with TV replays or on-demand viewing. Select a session from the dropdown, load it, and press play when the session on your broadcast starts. All live sensors including race control messages, track status, weather data, timing, and driver positions update in real time during playback. Pause and resume as needed to stay in sync with your broadcast. When you stop the replay, cached data is automatically removed to save disk space.

• Add Saturday as a race week start option
  You can now set Saturday as the first day of race week in the integration settings. This makes the race week sensor better match regions that start the week on Saturday. Existing setups keep their current setting unless you change it.

• Add session metadata attributes to session status sensor
  The session status sensor now includes attributes such as meeting name, location, country, circuit name, time zone offset, and session start and end times. Previously this information was only available during live sessions through the current session sensor. With this change, the data is accessible as soon as the session enters the pre-session window, typically 60 minutes before the scheduled start. This allows dashboards and automations to display and act on upcoming session details before the session goes live.

• Add tire statistics sensor for live tire performance analysis
  A new sensor called Tire Statistics is now available under live timing sensors. It provides aggregated tire performance data during sessions, including the top three fastest lap times per tire compound with driver names, total laps driven and tire sets used for each compound, and a delta comparison showing which compound is fastest and how much slower the others are.

• Add track limits, investigations, and track grip sensors
  Three new live timing features are now available. The Track Limits sensor shows the total number of track limit violations during a session, with detailed per-driver breakdowns including deleted lap times, black and white flag warnings, and any resulting penalties. The Investigations sensor tracks steward investigations and penalties throughout a race, showing active investigations, their outcomes, and a complete history grouped by driver. The Session Status sensor now includes a track grip attribute that indicates whether low grip conditions have been declared by race control, useful for detecting wet or slippery track situations. All three features can be used to build dashboards showing live race incidents or to trigger automations when specific drivers receive warnings or penalties.

• Add track time sensor showing current local time at the circuit
  A new sensor displays the current time at the race track location, making it easy to understand what time it is for drivers and teams at the circuit. Attributes include timezone name, UTC offset, and the time difference from your local time, helping you quickly compare track time to your own.

• Let you choose the first day of race week
  You can now select whether race week starts on Sunday or Monday in the integration settings. This makes the race week sensor match local expectations instead of assuming a single global start day. Existing setups keep their current behavior unless you change the setting.

• Add a formation start marker for race and sprint sessions
  A new formation start marker helps you sync broadcasts with a reliable pre‑start reference, and it is exposed as a binary sensor for automations. Replay playback now starts from this marker when available so you can see the full build‑up. Live delay calibration can also use the formation start marker as an optional reference instead of session live.

Bug fixes

• Improve event-tracker fallback recovery when upstream schedule responses are partial or updated
  This update makes the live timing fallback more robust when Index.json is unavailable. The event-tracker schedule lookup now continues to alternate timetable sources if one source is present but empty, so valid sessions are still discovered. Retry behavior after 401/403 now uses refreshed endp...

v3.0.1

F1 Sensor – v3.0.1

Bug fixes

• Bump tzfpy to >=1.1.0 to fix install on armhf #227
• Update manifest.json

Documentation

• Update with missing Championship Prediction sensors

Maintenance

• Improve stability and future compatibility of the integration
  Network requests now have a timeout to prevent the integration from hanging if an external service is slow or unresponsive. The integration now uses updated date-time handling for better compatibility with future Python versions.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development: