F1 Sensor – v5.5.0

Your home. On race time. Now with more of the story behind every lap

Was that an overtake or a pit-stop shuffle? Who has the stronger race pace? And where did your favorite driver find those extra tenths?

F1 Sensor 5.5.0 brings a new Weekend Hub, replay lap comparisons, historical results and driver-specific automations to Home Assistant. Alongside the new features, this release includes improvements to live timing, replay, dashboard setup and everyday reliability.

Existing dashboards, entity IDs and configuration remain supported. Favorite Driver is opt-in.

New features

Weekend Hub: your weekend, in one place

The new Weekend Hub brings five complementary views into a single dashboard card:

• Overview — session status, recent events and available analysis.
• Timeline — follow laps, pit stops, Race Control, weather and other available session events together.
• Strategy — explore clean-lap pace, tyre degradation, compound comparisons and estimated undercut or overcut outcomes.
• Telemetry — compare selected laps from a loaded replay.
• Battles — explore likely on-track overtakes and distinguish them from position changes associated with pits, penalties or lapping.

Strategy and battle analysis include confidence and data-availability information, so you can see when the evidence supports a conclusion and when more laps are needed.

Choose a focus driver, gap reference and spoiler setting, and supported cards follow the same dashboard selection.

Replay telemetry: find those missing tenths

The timing screen tells you who was quicker. Now you can explore where the difference appeared.

Inside Weekend Hub, compare up to four driver/lap combinations using speed, throttle, brake, gear and time-delta traces. Compare teammates, revisit a quick lap or see how one driver’s laps differ over a stint.

Telemetry comparison uses selected laps from a loaded replay, where usable archived data is available.

Results Archive: settle the sofa debate

“Who finished ahead that weekend?” now has a convenient answer.

The existing F1 Results card gains an Archive view for historical Race, Sprint and qualifying classifications. Choose a season, event and session to explore published results, with columns suited to each session.

Race and Sprint results also gain completed-lap and total-time or gap information where supplied. Qualifying classifications show Q1–Q3 times.

Historical results load on demand, without starting a replay or changing the session followed by your live entities. No F1TV authentication is required, and existing Session Archive card configurations remain supported.

Favorite Driver: give your home someone to cheer for

Choose a favorite driver once and keep their position, timing, tyres, pit activity and team information available for dashboards and automations.

Five new device triggers let your home react when that driver gains a position, loses a position, enters the pits, leaves the pits or retires. Create a notification for a position gained, or build a lighting automation around their team colour.

Your selection survives restarts, and triggers follow Live Delay. Enable the feature in F1 Sensor’s configuration to get started.

Easier dashboard setup and interaction

Bundled cards now discover their F1 Sensor entities automatically, including renamed IDs and names with suffixes such as _2. Explicit source selections remain respected, with entry selection available for setups using multiple integrations.

Cards also gain standard Home Assistant tap, hold and double-tap actions, improved keyboard and screen-reader support, and more consistent translated interface text with English fallback.

[Explore shared card options](https://nicxe.github.io/f1_sensor/cards/shared-options)

Improvements and bug fixes

Replay keeps its place. Loading, seeking, pausing, switching and stopping sessions are more reliable. Weekend Hub follows playback changes, Race Control history is restored when starting or seeking, and old session data no longer carries into a newly selected session. Live-session cleanup also leaves an active replay running.

Session clocks keep ticking. Elapsed time, remaining time and the three-hour race limit update continuously, with corrected pause, resume and session-end handling.

Qualifying times belong to the right part. Q1 times no longer appear as Q2 or Q3 efforts. Drivers without a time in the displayed part show a placeholder, while the wide layout retains qualifying history.

Timing and messages stay consistent. Official best laps, corrections and deleted times are handled more accurately. Duplicate Race Control messages are removed, and timestamps respect Home Assistant’s timezone and 12/24-hour preference.

Live views recover more reliably. Connection interruptions and integration reloads are handled more smoothly, while analysis remains aligned with Live Delay.

Less unnecessary background work. Live timing resources start when needed, Track Map connections close with the card, and opening a tracking card outside an active session no longer activates live data incorrectly.

Compatibility fixes round things out. Settings remain accessible on supported older Home Assistant versions, F1TV Token Helper pairing works more reliably with Container and proxy setups, and partial tyre updates no longer produce misleading missing-compound warnings.

Documentation and updating

The documentation has a refreshed homepage, clearer navigation, focused card and entity references, and more practical dashboard and automation examples.

After updating, restart Home Assistant and reload your dashboard to load the matching bundled cards. Then try adding Weekend Hub, opening Archive in Results, or enabling Favorite Driver.

[Card installation and update guide](https://nicxe.github.io/f1_sensor/cards/installation)

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development

All changes

New features

• Add a unified Weekend Hub for session analysis
  The new Weekend Hub keeps the selected session, driver, spoiler setting, and gap reference aligned across supported F1 cards. It brings live and replay timelines, clean-lap strategy estimates, selected-lap telemetry comparisons, and confidence-based battle analysis into one responsive experience. Capability-aware states explain when data is still waiting or unavailable without adding raw telemetry to Home Assistant states.
• Add favorite driver entities and automation triggers
  F1 Sensor now lets users persist a favorite driver, exposes that driver’s live race and team-color data, and provides device triggers for position, pit, and retirement changes. Existing configurations remain unchanged unless the new feature is enabled.
• Add on-demand history to F1 Results
  The F1 Sensor integration now includes completed laps and total time or gap values in race and Sprint result attributes. The F1 Results card keeps the current season as its default and adds an on-demand Archive for race, Sprint, and qualifying classifications with session-appropriate columns. Existing Session Archive card configurations continue to work, while empty telemetry and data-coverage panels are no longer shown.
• Add resilient realtime updates to the F1 Sensor integration and live data card
  The F1 Sensor integration now recovers more reliably from interrupted live sessions, authentication limits, and temporary connection failures. The live data card reconnects cleanly, preserves useful information while data is unavailable, and improves keyboard and screen reader support. Existing setups continue to work without configuration changes.
• Automatically bind bundled cards to F1 entities
  Bundled F1 cards now discover entities from the integration registry, including renamed and suffixed entity IDs. Cards infer a configuration entry from an existing selection, preserve explicit overrides, and avoid guessing when multiple entries are ambiguous.
• Improve F1 Sensor and live data card accessibility, localization, and reliability
  The F1 Sensor integration and live data card now provide consistent translations with English fallback, native card actions, and improved keyboard and screen-reader support. Responsive behavior is verified across common display sizes and accessibility settings. Stronger performance, dependency, and release integrity checks make future updates more reliable without requiring changes to existing setups.
• Improve F1 Sensor efficiency and live data card loading
  The F1 Sensor integration now starts live timing resources only when needed and stops temporary Track Map connections when the card closes, reducing unnecessary traffic. The live data card loads on demand and uses more efficient Track Map updates with automatic recovery. Existing entities, card names, dashboards, and configuration choices are preserved and migrated automatically, so no user action is required.
• Complete F1 Sensor security and quality hardening

Bug fixes

• Connect F1TV Token Helper reliably from Home Assistant Container setups
  The F1 Sensor integration now sends tokens to the Home Assistant address currently used by the browser instead of an inaccessible container address. This allows F1TV pairing to complete reliably across container and proxy-based installations. Fixes #628.
• Correct best laps and duplicate Race Control messages
  The F1 Sensor integration and live data card now use each driver's official best lap even when earlier laps are missing, and keep corrections and deleted times consistent. The Race Control card shows each source event once. Reloading the integration also cancels pending driver-position updates.
• Improve F1 Sensor reliability and live data card timing
  The F1 Sensor integration now handles setup, reloads, configuration migration, live-session transitions, authentication validation, and cached data more reliably. The live data card keeps session time locally without generating unnecessary Home Assistant state updates and remains accurate when opened during an active session. Existing configurations continue to work without user action.The F1 Sensor integration now handles setup, reloads, configuration migration, live-session transitions, authentication validation, and cached data more reliably. The live data card keeps session time locally without generating unnecessary Home Assistant state updates and remains accurate when opened during an active session. Existing configurations continue to work without user action.
• Keep documentation checks green while indexing is active
  Treat an already-running documentation index as a successful outcome after retries. Genuine request failures continue to fail the workflow, while concurrent indexing no longer creates a misleading red check.
• Keep F1 analysis and replay reliable through reloads
  The F1 Sensor integration and live data card now recover their live views after integration reloads and keep analysis aligned with Live Delay. Switching or stopping replay no longer leaves playback stuck, and telemetry from a previous session cannot overwrite the current selection. The update also improves cleanup during interrupted setup and readability of the mobile strategy view.
• Keep replay isolated from live session cleanup
  The F1 Sensor integration now keeps replay running when a previous live session closes, including paused playback with No Spoiler Mode enabled. Returning to live timing clears replay analysis so position changes reflect the current data. The live data card also keeps its replay selection aligned with the selected session.
• Preserve Race Control messages when replay starts or seeks
  The F1 Sensor integration now restores real Race Control messages from saved replay snapshots in their original order. Empty timing responses no longer appear as generic messages in the live data card.
• Prevent misleading tyre data warnings after compounds arrive
  The F1 Sensor integration now recognizes partial live tyre updates after compounds have already been received. Existing tyre data remains visible without an incorrect warning that the upstream feed is missing compounds.
• Prevent the live tracking card from starting outside active sessions
  The F1 Sensor integration now keeps the live tracking card idle when no live or replay session is active. The card remains available without incorrectly activating live session data or related sensors.
• Restore live data card loading in Home Assistant dashboards
  The live data card now loads reliably so existing F1 dashboard cards render again instead of showing configuration errors. Existing dashboard configurations continue to work without any user action.
• Restore Race Control timestamps and respect Home Assistant time preferences
  The live data card now displays Race Control timestamps correctly using your Home Assistant time zone preference. Times follow your selected 12-hour, 24-hour, language, or system format, while circuit times retain the circuit's time zone.
• Restore Race Control timestamps and respect Home Assistant time preferences
  The live data card now displays Race Control timestamps correctly using your Home Assistant time zone preference. Times follow your selected 12-hour, 24-hour, language, or system format.
• Restore session clock updates in the F1 Sensor integration
  Session elapsed time, remaining time and the three-hour race limit now update continuously. Correct pause, resume and session-end handling prevents time jumps and keeps final values stable. Integration reloads and shutdowns now clean up reliably, including when the connection cannot close normally. Fixes #641.
• Update Weekend Hub when replay pauses or stops
  F1 Sensor now keeps open Weekend Hub cards in sync when replay is paused, resumed, stopped or finishes. Stopping playback clears old session data and telemetry without waiting for another timing update.
• Keep F1 Sensor settings available on older Home Assistant versions
  The F1 Sensor integration settings remain accessible on all supported Home Assistant versions, including 2024.11. This restores compatibility while preserving the settings behavior on newer versions.
• Keep settings available on older supported Home Assistant versions
  F1 Sensor settings now open correctly on Home Assistant 2024.11 as well as current versions. Existing preferences and credentials remain unchanged.
• Keep settings available on older supported Home Assistant versions
  F1 Sensor settings now open correctly on Home Assistant 2024.11 as well as current versions. Existing preferences and credentials remain unchanged.
• Preserve release history for promoted branches
• Prevent scheduled work from outliving integration shutdown
• Run releases after all required checks pass
  Release drafts and documentation updates now proceed when all applicable checks pass, including runs where unrelated checks are intentionally skipped. Failed or cancelled checks still prevent release, and publishing remains a manual step.
• Show qualifying times in the correct session part
  Qualifying cards now show a time only when it belongs to the displayed qualifying part. Drivers without a time in Q2 or Q3 show a placeholder until they complete a timed lap, while the full qualifying history remains available in the wide layout.

Documentation

• Bring release guides and Home Assistant screenshots into development

• Bring the search shortcut contrast correction into dev

• Clarify the scope of historical tyre troubleshooting notes
  The tyre troubleshooting notes now clearly describe observations from the 2026 Chinese Grand Prix. They distinguish that past investigation from current live-session behavior and clarify how to collect evidence for a new issue.

• Correct automation trigger documentation
  The automation reference now describes the Session live trigger accurately and includes the existing Team Radio device trigger on the Drivers device.

  (cherry picked from commit 96ce362)

• Correct automation trigger documentation
  The automation reference now describes the Session live trigger accurately and includes the existing Team Radio device trigger on the Drivers device.

• Explain new dashboard features with real Home Assistant screenshots
  The documentation now guides you through Weekend Hub analysis, replay telemetry, historical results and shared dashboard controls. Real Home Assistant screenshots show the replay views and race and qualifying archives alongside the setup steps. The guides are prepared for the main release and clarify data availability, spoiler controls and existing card compatibility.

• Improve search shortcut readability in the documentation
  Search keyboard hints now have readable contrast in both light and dark themes. Accessibility checks cover the shortcuts shown on Linux and macOS.

• Refresh F1 Sensor documentation and navigation
  The documentation now has a redesigned home page, clearer navigation, and focused guides for dashboards, entities, and common tasks. Updated examples, card previews, and the animated flag lighting demonstration make it easier to discover features and get started. Existing documentation links remain available, and the latest automation documentation corrections are included.

• Refresh F1 Sensor documentation and navigation
  The documentation now has a redesigned home page, clearer navigation, and focused guides for dashboards, entities, and common tasks. Updated examples, card previews, and the animated flag lighting demonstration make it easier to discover features and get started. Existing documentation links remain available, and the latest automation documentation corrections are included.

• Show how F1 Sensor brings race day into your home
  Refresh the project introduction with practical examples of race dashboards, flag lighting and automations, including an animated lighting demonstration. Explain how Live Delay, Replay Mode and No Spoiler Mode support watching live or catching up later, and clarify which features need optional F1TV access.

• Synchronize the documentation refresh from content into dev
  Both branches now include the refreshed documentation and the latest automation corrections. Development quality checks remain in place.

• Explain dashboard test coverage for contributors

Maintenance

• Improve reliability of F1 Sensor release checks
  Improve internal release checks so large releases avoid unnecessary file comparisons and live data card visual checks remain consistent after a scheduled race date passes. This maintenance keeps release verification reliable without changing the integration or live data card behavior.
• Keep release promotion history consistent
  Release preparation now retains the previous beta promotion in its history so the required checks can validate the next candidate.
• Refresh development dependencies to address security advisories (#615)
  Updates development and release tooling to patched versions where available. This reduces known security exposure without changing user configuration or runtime behavior.
• Remove obsolete F1 Sensor documentation patch (#617)
  Removes a development-only patch for a package that is no longer installed. This restores clean automated releases and documentation publishing without changing F1 Sensor behavior or user configuration.
• Restore reliable F1 Sensor documentation builds (#616)
  Refreshes development dependency lock data so automated releases and documentation publishing install consistently. This maintenance change does not affect F1 Sensor behavior or user configuration.
• Strengthen checks for delayed live updates
  The F1 Sensor integration now has an additional check that opening a live view preserves the configured delay. This verifies that a newly connected view receives the same delayed session data as existing views.
• Validate F1 Sensor dependency patches during releases (#618)
  Ensures changes to development dependency patches run through the release workflow. This improves publishing reliability without changing F1 Sensor behavior or user configuration.

☕ Support This Project

If you find F1 Sensor useful, consider supporting its development