Skip to main content

F1TV Token Helper

F1TV Token Helper connects your own Formula 1 browser session to F1 Sensor through a short-lived Home Assistant pairing link. Use this page when Home Assistant opens an external website while you are connecting F1TV access.

Experimental feature

F1TV access is currently a beta feature and requires F1 Sensor v4.3.0-beta.3 or later. Public live timing continues to work without F1TV access.

What this does​

The helper reads the F1TV live timing token from your local browser session and sends it to your own Home Assistant instance. It does not ask for your Formula 1 password, does not send the token to a project server, and does not make F1TV access required for public live timing.

Install the helper from the Chrome Web Store before you start pairing from Home Assistant.

Step-by-step​

Step 1 - Keep this tab open​

  1. Leave this page open after Home Assistant sends you here.
  2. Open the F1TV Token Helper extension from the Chrome toolbar.
  3. Confirm that the helper shows your Home Assistant pairing.
tip

The helper reads the pairing link from this active tab. If it does not find the pairing automatically, open Pairing link in the helper and paste the full URL from this page.

Step 2 - Sign in if needed​

  1. If the helper says no token is available, select Sign in.
  2. Sign in to Formula 1 in the browser.
  3. Return to the helper and select Fetch.

The helper keeps the Home Assistant pairing while you sign in. You should not need to start over in Home Assistant unless the pairing expires.

Step 3 - Send to Home Assistant​

  1. Wait until the helper says it is ready to send.
  2. Select Send to Home Assistant.
  3. Return to Home Assistant and complete the flow if Home Assistant is still waiting for confirmation.

Home Assistant stores only the live timing authorization value it needs. If the token expires later, public live timing continues to work.

Troubleshooting​

For Home Assistant debug logs, see Debug Logging and Logs.

The helper does not show Home Assistant pairing​

Keep this page as the active tab and open the helper again. If that does not work, copy the full browser URL from this page, open Pairing link in the helper, paste the URL, and select Connect.

The helper says the pairing expired​

Return to Home Assistant and start Connect F1TV access again. Pairing links are intentionally short-lived.

Home Assistant cannot be reached​

Make sure the Home Assistant URL in the pairing link is reachable from the same browser. If you are away from home, use a Home Assistant URL that your browser can access.

Privacy​

The helper processes the token locally and sends it only to the Home Assistant callback URL that was generated by your pairing session. Read the F1TV Token Helper Privacy Policy for the full privacy details.