iPhone Home Screen and Lock Screen widgets for connected Ford vehicles, built as a single Scriptable script. Developed on a 14th‑gen (2021+) F‑150. Compatibility with other models and individual features is unverified and depends on the vehicle, equipment and Ford account. Electric vehicles are outside the current testing scope.
- Status at a glance: fuel and range, lock state, tire pressures, oil life, 12V battery, doors, odometer, outside temperature and where the vehicle is parked, with your vehicle's own FordPass photo.
- Buttons: Lock, Unlock, Remote start / Stop, and Wake. Every command asks for confirmation first.
- Remote start countdown that ticks live on the widget. Tap it to stop the engine.
- Evening check: once a night, the widget checks the vehicle's last state and notifies you if it's unlocked, a door is open, a tire is low, or fuel is low.
- Every size: small, medium and large Home Screen widgets, plus circular, rectangular and inline Lock Screen widgets. Light and dark mode.
- Customizable: choose what each widget shows.
Unofficial. This uses Ford's private FordPass app API, the same way the open-source ha-fordpass Home Assistant integration does. Ford can change or block it at any time, and using it may be against Ford's terms. Use at your own risk. Not affiliated with Ford.
- An iPhone running iOS 16 or later, with Scriptable installed (free).
- A FordPass account with your vehicle added and its modem activated. Ford app availability does not guarantee that this unofficial integration supports the same features.
- Your 17‑character VIN.
- Get the script onto your phone, using either method:
- Copy and paste: on your iPhone, open the raw
FordWidget.jsand copy all the text. In Scriptable, tap +, paste, then tap the title at the top and rename it FordWidget. - Files: download
FordWidget.jsand move it to iCloud Drive › Scriptable.
- Copy and paste: on your iPhone, open the raw
- Run it in the Scriptable app by tapping the script. It asks for your VIN and a name for the vehicle, like "F‑150 Lariat".
- In the menu, choose Connect FordPass:
- Enter your FordPass email. The password field is optional: it only fills in Ford's login page, and it's never saved.
- Choose Sign in here, then sign in to Ford and finish the verification code or MFA.
- When the page says Signed in, tap Close at the top. You'll see "FordPass connected."
- Choose Fetch telemetry. This downloads your vehicle's status and its FordPass photo.
- Add widgets. See below.
The script must be run in the app first. Widgets only show what the app has already downloaded.
- Long‑press the Home Screen, tap Edit, then Add Widget, and choose Scriptable.
- Pick a size (small, medium or large) and tap Add Widget.
- Long‑press the new widget and choose Edit Widget:
- Script: FordWidget
- When Interacting: Run Script
- Parameter: optional, see Customizing
Add as many widgets as you like; each one can show something different.
Long‑press the Lock Screen, tap Customize, then Lock Screen. Tap the widget area, add Scriptable, then tap the widget to choose FordWidget and a Parameter:
| Widget | Parameter | Shows |
|---|---|---|
| Circle | fuel (default) |
Fuel ring with % |
| Circle | lock |
Lock icon |
| Circle | tires |
Lowest tire pressure |
| Rectangle | status (default) |
Name, lock, fuel bar and range |
| Rectangle | tires |
All four pressures, with low ones flagged |
| Rectangle | parked |
Where the vehicle is parked |
| Inline | — | Fuel · range · lock, above the clock |
While the engine is running from remote start, the circle and rectangle show the countdown instead.
Tap any widget to open the menu:
| Menu item | What it does |
|---|---|
| Fetch telemetry | Downloads the vehicle's latest status from Ford's cloud. Doesn't wake the vehicle. |
| Lock / Unlock | Sends the command after you confirm. |
| Remote start | Locks first, waits for the lock to confirm, then starts. Shows outside temperature. |
| Remote stop | Stops a remote start. |
| Wake / refresh | Asks the vehicle to report fresh data. Limited to once every 15 minutes to protect the 12V battery. |
| View details | Every reading with its time and source. |
| Parked location | Open in Maps, or save the spot as Home. The widget then says "Parked · Home". |
| Customize widgets | Choose what all widgets show, tire units, evening check time, and previews. |
| Widget gallery | Preview Classic, Showcase, and Dashboard designs and select one separately for each widget size. |
| Alerts & attention | Choose evening alert conditions, thresholds and the optional Home Screen attention indicator. |
| Vehicle photo | Ford's photo from another angle, your own photo, or a plain icon. |
| Sign out of Ford | Removes the saved Ford tokens and username from this phone. |
| Run self-test | Offline checks. No network and no commands. |
Widget buttons (Lock, Unlock, Start, Refresh) open Scriptable and ask for confirmation before anything is sent.
A command's receipt means Ford accepted it, not that the vehicle finished it. Fetch telemetry a minute later to confirm.
Widget gallery previews each design using your cached data before saving a choice for small, medium, or large widgets. Classic remains the default. You can also use classic, showcase, or dashboard in an individual widget’s Parameter to override its design.
Customize widgets in the menu sets the defaults for every widget. To change a single widget, type words in its Parameter:
| Word | Effect |
|---|---|
buttons |
Medium widget shows Lock / Unlock / Start / Refresh buttons |
status |
Status‑only layout, no buttons |
fuel tires lock … |
Show only these items |
-photo, -oil … |
Hide these items |
bar / psi |
Tire pressure units |
Items: photo, fuel, battery, tires, oil, lock, odometer, doors, temp, parked.
Examples: buttons -photo · fuel tires · lock oil odometer
Use Alerts & attention in the menu to turn individual conditions on or off and adjust tire, fuel, oil and 12V battery thresholds. These settings apply to the evening check. The optional Home Screen attention indicator shows the first matching condition and the age of cached readings, without an extra network request. Missing readings are unknown; a warning can be stale. Lock Screen widgets do not show this indicator. iOS controls widget refresh and notification timing.
From 9 PM (you can change this or turn it off in Customize), the first widget refresh reads the vehicle's last reported state once. It doesn't wake the vehicle, and it sends you a notification if something needs attention. iOS decides exactly when widgets refresh, so the timing is approximate. It runs inside the widget; no Shortcuts automation is needed.
The optional “all good” notice requires explicit Locked and Closed readings, each with its own measurement timestamp within the past five minutes. A fresh overall response time is not enough. Missing, unknown or older lock/door readings produce a limited-status notice instead; reported problems still trigger alerts.
Door and lock components keep their individual measurement times in the local cache. Newer readings replace that same component before the overall status is calculated; partial responses retain previously reported components. An unchanged old hood reading therefore does not prevent a newer door transition from updating the status. Unknown components stay unknown, and fetch time never becomes measurement time. A whole-vehicle ALL_DOORS lock reading cannot be cleared or made newer by one individually locked door.
Older caches contain only the overall door/lock state. If an older Ajar or Unlocked report cannot be attributed to a component, a later partial closed/locked response shows Unknown rather than assuming the unresolved component is safe. The uncertainty remains until a sufficiently dated whole-vehicle report resolves it; newer individual unsafe readings still show Ajar/Unlocked. This migration does not require clearing the cache, and an unresolved prior Ajar continues to block remote start. Previously healthy aggregate readings retain their original state and time unless newer contrary evidence arrives.
Please read before installing.
- Where things are stored:
- Your Ford tokens and username are kept in the iOS Keychain through Scriptable's Keychain API.
- Your password is never saved.
- The telemetry cache (
Scriptable/FordWidget/ford_vehicle_cache.json) is local to the phone and contains no secrets.
- Scriptable's Keychain is shared by all scripts in the app. Any other Scriptable script you install could read FordWidget's Ford tokens, and those tokens can unlock and start your vehicle. Only install scripts you have read and trust.
- Only get this script from this repository, and read it first. A modified copy could send your Ford login anywhere.
- Network access is limited:
login.ford.comand*.ford.comhandle login, the vehicle photo and the garage list.api.autonomic.aiis Ford's vehicle cloud, used for status and commands.api.open-meteo.comis used only for the remote‑start temperature line, and only when the vehicle's own reading is over 2 hours old. It receives the location rounded to about 1 km, with no account.
- Links can trigger a command prompt. A web page or QR code can open a
scriptable://link to this script, which is why every command shows a confirmation alert. Only tap Send command if you started it. - Parked location is stored on the phone only. Turning it off in Customize widgets erases saved coordinates (your Home spot stays until you clear it).
- To revoke access: choose Sign out of Ford, then change your Ford password. Changing the password signs out all sessions.
- When asking for help, don't post your VIN, location, or screenshots of View details. Error messages never contain tokens or passwords.
- Remote start safety: only start the vehicle when it's parked outdoors, never in a garage.
| Problem | Fix |
|---|---|
| Ford sign‑in page is blank or stuck on "Signing in" | Wait about 20 seconds, then tap Close. The login usually went through. If not, choose Sign in on another device and follow the steps; you paste back the fordapp:// address. |
| "FordWidget is already running" | Scriptable was closed mid‑run. If nothing else is open, tap Take over. |
| "cooling down; try again in N minutes" | Ford returned an error or rate limit, so the script backs off on its own. Wait it out. |
| Widget says "Open Scriptable to set up / fetch" | Run the script in the app and choose Fetch telemetry. |
| Readings say "—" or Unknown | Ford hasn't reported that reading for your vehicle. Not every vehicle or modem reports every value. |
| No vehicle photo | Menu › Vehicle photo › try another view, or choose your own photo. |
| Widget only shows "Scriptable" when adding | Make sure you've run the script in the app at least once. |
Replace the script's contents with the new FordWidget.js and keep the same name. Your settings, sign‑in and cache are kept.
Menu › Sign out of Ford, then delete the script and the FordWidget folder in Scriptable's documents.
Ford login and API details are based on marq24/ha-fordpass, marq24/ha-fordconnect-query and itchannel/fordpass-ha. Thanks to their authors.
The tests live in tests/ and need Node 18 or newer. Run them with node --test tests/. They are offline: the Scriptable APIs are mocked and nothing contacts Ford. You don't need them on the phone.
MIT. Free to use, modify and share. Provided as is, with no warranty. You're responsible for how you use it with your vehicle and Ford account.
After vehicle setup, the offline self-test checks the script. Vehicle features / compatibility suggests readings based on the available cloud or cached data and lets you select features available in your Ford app. Connect an account and rerun the check to obtain cloud suggestions. Missing data is unverified, not proof of an unsupported feature; cached data may be old. You can change selections or rerun the check from the menu. Existing installations retain their settings until they choose to run it.
Selected controls are unverified until the owner optionally tests each one and confirms the vehicle completed it. Tests send real commands and require confirmation; a Ford receipt alone does not verify completion. Remote start first locks the vehicle and should only be tested outdoors. Wake and command cooldowns still apply. This process records the owner's report, not a guarantee of future operation.
The following example rows are unverified; the maintainer can update them as reports arrive. No model year or feature has been tested by implication.
| Model | Year | Powertrain | Feature | Result |
|---|---|---|---|---|
| Bronco | Unverified | Gas / hybrid | Unverified | Unverified |
| Maverick | Unverified | Gas / hybrid | Unverified | Unverified |
| Ranger | Unverified | Gas / hybrid | Unverified | Unverified |
| Mustang | Unverified | Gas / hybrid | Unverified | Unverified |
Electric vehicles, including Mustang Mach-E, require separate testing and are not covered by these examples.