← Back to the board

Support

Help and FAQ

Do I need a TfL API key?

Yes. Tubbie talks directly to TfL’s free Open Data API and uses your personal key so you get the higher per-key rate limit. You can sign up at api-portal.tfl.gov.uk in about two minutes.

Where's the key kept?

In the iOS Keychain — encrypted by iOS, never written to disk in plaintext, never logged, never sent anywhere except to api.tfl.gov.uk when fetching arrivals.

The board won't stop loading

Most often this means your API key was rejected (a typo at paste time, or the key has been revoked / expired). Open Settings → API key, paste it again, and check that the board recovers within a couple of seconds. If the issue persists with a fresh key, it’s a TfL outage — check tfl.gov.uk/status-updates.

No Live Activity on the Lock Screen

Live Activities require iOS 16.2 or later, and the system has to have at least a few seconds of foreground time to register the Activity. Tap a Board row, choose “Track this train”, then lock the device — the banner appears within a second or two. If it still doesn’t show, check Settings → Tubbie → Allow Live Activities is enabled.

The widget's gone stale

The widget refreshes opportunistically via iOS’s background budget — it can run as often as every few minutes, or, on a quiet device, as rarely as every hour. Open the app to force a fresh fetch. If the widget shows times from hours ago, that’s a known cold-cache state; refresh by long-pressing the widget and tapping Edit Widget once.

Overground, Elizabeth, DLR?

All covered. Tubbie renders every line TfL exposes through the Open Data API: 21 lines in total at the time of writing (Bakerloo, Central, Circle, District, Elizabeth, Hammersmith & City, Jubilee, Metropolitan, Northern, Piccadilly, Victoria, Waterloo & City, DLR, plus the six named Overground lines).

Does it work in the tunnels?

The last successful board is cached on your device and the widget will keep rendering it while you’re offline — but live arrivals obviously need a connection. In airplane mode the app shows a clear “offline” banner rather than spinning.

Which iPhones will it run on?

iOS 17 or later. Live Activities and Home Screen widgets work throughout. The fluid iOS 26 Liquid Glass tab bar is a small progressive enhancement on iOS 26+; everything else is identical on iOS 17–25.

Accessibility

Tubbie ships a High Contrast theme designed for outdoor reading and low-vision users; line-colour overrides preserve TfL brand identity while passing WCAG AA on the LED substrate. The app honours Reduce Motion (no scrolling marquees), Reduce Transparency (stronger scanline overlay so glyphs still read), and Dynamic Type for chrome copy.

Contact

For anything not answered above, get in touch via brunobelcastro.com.