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.

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.

The Token Helper is the recommended way to connect optional F1TV Auth. Manual Bearer token entry is an advanced fallback for users who already know how to inspect their own browser session safely.

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

info

F1TV live timing tokens are short-lived. Expect to renew F1TV access about every four days. Home Assistant shows a repair issue in the UI when F1TV access needs renewal.

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. Formula 1 opens in a new browser tab. Sign in there.
  3. After signing in, return to the original tab that Home Assistant opened.
  4. Open F1TV Token Helper from that original tab and select Fetch.

The helper keeps the Home Assistant pairing in the original Home Assistant tab while you sign in. Use that tab when you fetch the token, because Send to Home Assistant needs the original pairing link.

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.

After pairing, sensor.f1_f1tv_token_status and sensor.f1_f1tv_token_expires_at show the saved token health. The token normally needs to be renewed about every four days. You can start a new pairing later with button.f1_refresh_f1tv_access or remove the saved token with button.f1_clear_f1tv_access.

For the full live timing availability model, see F1TV Auth. For setup steps, see F1TV Auth Setup.

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.

Send to Home Assistant does not work after signing in

Formula 1 opens in a new tab when you select Sign in. After you have signed in, go back to the original tab that Home Assistant opened and open F1TV Token Helper there. The helper needs that original tab so it can use the Home Assistant pairing link when you select Send to Home Assistant.

The helper says the pairing expired

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

The F1TV token expires after a few days

This is expected. F1TV live timing tokens are short-lived and normally need to be renewed about every four days. Start a new pairing with button.f1_refresh_f1tv_access when the token status shows that F1TV access needs attention.

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.