RACINGCLOCK
Back to Home
Phone Widgets

Add F1 race countdown widgets to your phone's home screen. Works on both iPhone and Android.

iPhone Widget

Via Scriptable app (free)

1
Install "Scriptable" from the App Store

Free app that runs JavaScript widgets on your home screen.

Open App Store
2
Copy the widget script

Tap the button below to copy, then paste into a new Scriptable script.

Open Script
3
Open Scriptable → Tap +

Create a new script, name it "RacingClock". Paste the script URL content or copy-paste the code.

4
Add widget to home screen

Long-press home screen → "+" → Search "Scriptable" → Choose size → Edit widget → Select "RacingClock" script.

Tip: The widget supports Small, Medium, and Large sizes. Medium shows upcoming races. Large adds a season progress bar.

Android Widget

Via KWGT or Tasker

1
Option A: KWGT (easiest)

Install "KWGT Kustom Widget Maker" from Play Store. Create a new widget and use the HTTP module to fetch our API.

2
Option B: Tasker + HTTP Request

Create a Tasker task that fetches the API URL above and displays race info in a Tasker widget or notification.

3
Option C: Chrome shortcut

Open racingclock.com in Chrome → Menu → "Add to Home Screen". This creates an app shortcut that opens directly to the calendar.

KWGT Formula
$wg("https://racingclock.com/api/widget/next-race", json, .countdown.text)$

Use this in a KWGT text field to show the countdown. Replace.countdown.text with.race.name,.race.flag, etc.

Install as App

Works on any phone — no app store needed

RacingClock is a Progressive Web App (PWA). You can install it directly from your browser — it works offline, sends notifications, and feels like a native app.

Chrome (Android)

1
Open racingclock.com in Chrome

Make sure you're using Google Chrome browser.

2
Tap the menu (⋮) → "Install app" or "Add to Home screen"

Chrome will show a banner or menu option to install. Tap Install.

3
Done! App icon appears on your home screen

Opens fullscreen without browser bars. Gets updates automatically.

Safari (iPhone)

1
Open racingclock.com in Safari

Must be Safari — Chrome on iOS doesn't support PWA install.

2
Tap the Share button (□↑) → "Add to Home Screen"

Scroll down in the share sheet if you don't see it. Tap "Add".

3
Done! App icon appears on your home screen

Opens fullscreen with status bar integration. Feels like a native app.

Native Apps

Coming Soon

Native iOS and Android apps with home screen widgets, live activities, lock screen countdown, and push notifications are in development. Stay tuned!

App Store
Google Play

API Reference

Public API for building your own widgets or integrations.

GET /api/widget/next-race
Next race name, circuit, date, country, flag
Countdown: days, hours, minutes, race day flag
Weekend schedule, sprint flag, upcoming 3 races