FLwatch - Glucose & Insulin

FLwatch displays glucose readings from Abbott FreeStyle Libre 2, Libre 2+, Libre 3, and Libre 3+ sensors, as well as Dexcom G6, G7, and ONE+ sensors, on your iPhone and Apple Watch.

It also lets you record insulin doses and visualizes insulin on board and insulin activity with dedicated graphs, helping you better understand how insulin and glucose levels interact.

FLwatch began as a personal project to support my own diabetes management. I made it publicly available, free and open source, in the hope that it can be useful to others too.

At a Glance

• Glucose, insulin-on-board, and insulin-activity graphs on iPhone and Apple Watch
• Direct Bluetooth, LibreLinkUp, and Dexcom Share connection options
• Configurable glucose and sensor alerts
• Home Screen, Lock Screen, StandBy, and Apple Watch widgets and complications
• Live Activities, CarPlay, Siri, and Shortcuts support
• Apple Health export, plus Nightscout export with a direct FreeStyle Libre 3 or FreeStyle Libre 3+ connection
• Requires iOS 18 and watchOS 10.5

Supported Sensors and Connections

Features

Glucose Monitoring

• Blood glucose graph on iPhone and Apple Watch
• Interactive chart on iPhone — tap to inspect individual readings
• Optional calibration offset for directly connected FreeStyle Libre 3 and FreeStyle Libre 3+ sensors
• Check your current glucose and trend using Siri or Shortcuts
• Optional always-on display mode for quick viewing

Alerts

• Configurable low- and high-glucose alerts on iPhone, Apple Watch, and CarPlay
• Additional critical-low and signal-loss alerts for directly connected FreeStyle Libre 3 and FreeStyle Libre 3+ sensors
• Sensor warm-up status, remaining life, expiry, and replacement notifications for directly connected FreeStyle Libre 3 and FreeStyle Libre 3+ sensors
• Optional Critical Alerts and separate Do Not Disturb times for each alert type

FLwatch alerts are provided on a best-effort basis and are not guaranteed. They may be delayed or missed. Always confirm your glucose reading before taking action.

Insulin Tracking

• Record insulin doses on iPhone or with Siri and Shortcuts on iPhone and Apple Watch
• Basic carbohydrate and insulin calculator using portion size and a configurable insulin-to-carbohydrate ratio
• Insulin on Board (IOB) calculation and graph
• Insulin activity graph
• Support for rapid-acting and fast rapid-acting bolus insulins

Widgets, Live Activities, and CarPlay

• Home Screen widgets, with and without graphs
• Lock Screen and StandBy widgets
• Live Activities for quick glucose updates
• Native Apple Watch app with a wide range of widgets and watch face complications
• Glucose graph directly on Apple Watch
• Live Activity mirroring to the Smart Stack on watchOS 11 or later
• CarPlay view showing current glucose and IOB
• Glucose graphs in CarPlay through widgets and Live Activities

Data Sharing

• Export glucose readings and recorded insulin doses to Apple Health
• With a direct FreeStyle Libre 3 or FreeStyle Libre 3+ Bluetooth connection, export glucose readings and recorded insulin doses to your own Nightscout server

Screenshots

See additional screenshots on the FLwatch App Store page.

iPhone Screenshots

Watch Screenshots

Quick Start

1. Install FLwatch from the App Store.

2. Make sure the watchOS app is installed on your Apple Watch, ideally before starting the iPhone app.
3. On first launch, FLwatch asks you to choose your CGM: FreeStyle Libre through LibreLinkUp, Dexcom through Dexcom Share, or FreeStyle Libre 3 (Bluetooth) for a direct sensor connection.
4. After you make a selection, FLwatch automatically opens the matching Connect screen. Follow the instructions shown there and the relevant notes below.
5. Once connected, allow up to one minute for the first glucose data to appear.

You can change the selected CGM later in Settings.

If the watchOS app is installed, cloud-connection settings and credentials entered in the iPhone app are transferred to the Apple Watch app. You can transfer them again later by pressing the Connect button once more.

Direct FreeStyle Libre 3 and FreeStyle Libre 3+ Connection

On a fresh installation, choose FreeStyle Libre 3 (Bluetooth) in the CGM picker. FLwatch then opens the Bluetooth connection screen automatically.

Before pairing:

• For most users with an already activated sensor, Parallel is the recommended mode. It keeps the sensor’s existing FreeStyle Libre 3 connection credentials valid, making it easier to switch back to the FreeStyle Libre 3 app later.
• Sign in with the LibreView account used to activate the sensor, then tap Get Account ID in FLwatch. Parallel pairing requires the account information to match the activating account. This is different from the LibreLinkUp follower account used for a cloud connection.
• Only one app should access the sensor at a time. Before using FLwatch, fully close the FreeStyle Libre 3 app and turn off its Bluetooth access in iOS Settings. Switching between apps can take two to three minutes.
• When FLwatch asks you to scan, hold the top of your iPhone against the sensor and keep it still until NFC pairing finishes.

The Fresh mode is only for a brand-new, unused sensor. It starts the sensor’s wear period immediately and cannot be undone. Most users should activate the sensor in the FreeStyle Libre 3 app and then pair it with FLwatch using Parallel mode.

Once paired, keep your iPhone near the sensor. Glucose readings are received directly over Bluetooth about once a minute, without a follower account or cloud connection. A direct connection also enables calibration offset, critical-low and signal-loss alerts, sensor-status notifications, and Nightscout export.

These direct-connection features are not available for FreeStyle Libre 2 or FreeStyle Libre 2+ sensors.

Set Up LibreLinkUp

LibreLinkUp can provide glucose readings from FreeStyle Libre 2, FreeStyle Libre 2+, FreeStyle Libre 3, and FreeStyle Libre 3+ sensors. To use it with FLwatch, invite yourself to become your own follower.

LibreView credentials do not work. Use the credentials of a LibreLinkUp follower account.

1. In the FreeStyle LibreLink or FreeStyle Libre 3 app, go to Share / Connected Apps.
2. Open Connect / Manage LibreLinkUp.
3. Tap Add Connection and enter the email address you want to use for the follower account.
4. Accept the invitation sent to that email address.
5. Install the LibreLinkUp app on your iPhone and complete the setup for that invited follower account.
6. Confirm that you can see your own blood glucose graph in LibreLinkUp.
7. Open FLwatch and enter the follower account credentials on the Connect tab.

The email address for the follower account can be the same as the one used for LibreView. If the follower account has more than one connection, choose the person whose readings FLwatch should display after signing in.

The LibreLinkUp app can then be closed or uninstalled. You may still need it later to accept updated terms or privacy policies, or to verify that the account and connection still work.

LibreLinkUp’s step-by-step guide provides further help.

Set Up Dexcom Share

Dexcom G6, Dexcom G7, and Dexcom ONE+ sensors can provide glucose readings through Dexcom Share.

1. Turn on Share in the Dexcom app. Dexcom requires at least one follower invitation before Share can be enabled.
2. On a fresh installation, choose Dexcom in the CGM picker. FLwatch automatically opens the Dexcom Share connection screen.
3. Sign in with the email address and password of the Dexcom account used by the sensor wearer — the same account used in the Dexcom app on the wearer’s phone — and press Connect. FLwatch detects the account region automatically.

Do not use a follower’s login. Dexcom Share only exposes the wearer’s own readings to third-party apps when the wearer’s account is used.

If the Apple Watch app was not installed when you connected, install it and press Connect again to transfer the credentials. The Dexcom Share connection used by FLwatch is unofficial and may be changed or restricted without notice.

Bluetooth Heartbeat for Cloud Connections

When using LibreLinkUp or Dexcom Share, FLwatch low- and high-glucose alerts require the Bluetooth Heartbeat. Enable it in Settings > Bluetooth Heartbeat and select your nearby sensor transmitter. FLwatch cannot deliver these cloud-connection alerts while the heartbeat is off; continue to use the sensor manufacturer’s alerts as your primary alerts.

The direct FreeStyle Libre 3 and FreeStyle Libre 3+ Bluetooth connection does not use this setting.

Insulin Features

To configure insulin calculation or record a dose, tap the IOB label on the home screen.

Currently supported insulin types:

• Rapid-acting insulin, such as Novolog and Novorapid
• Fast rapid-acting insulin, such as Fiasp and Lyumjev

The built-in calculator uses portion size and a configurable insulin-to-carbohydrate ratio. More insulin types can be added on request.

Apple Watch, Siri, and Shortcuts Tips

• To keep the glucose graph visible on Apple Watch for one hour, open Settings on the watch or the Watch app on iPhone. Go to General > Return to Clock, choose FLwatch, and select After 1 hour.
• Place a widget or complication on your Home Screen, Lock Screen, or watch face for quick access to FLwatch.
• Live Activities on iPhone can be mirrored into the Apple Watch Smart Stack on watchOS 11 or later.
• Siri and Shortcuts can display or read out your current glucose value and record insulin doses.
• For hands-free access, create a shortcut that opens FLwatch, give it a phrase such as glucose graph, and enable Show on Apple Watch if desired.

Technical Notes

FLwatch uses the exponential insulin model from LoopKit. The model uses three parameters: actionDuration, peakActivityTime, and delay.

• For rapid-acting insulin, the parameters are 360, 75, and 10 minutes.
• For fast rapid-acting insulin, the parameters are 360, 55, and 10 minutes.

Project Status

FLwatch is an experimental open-source project. Use it with caution. It comes with no warranty and is used at your own risk.

FLwatch is also available for beta testing on TestFlight.

Support and Feedback

For support, please open a GitHub issue, start a GitHub discussion, or email flwatch [at] cmdline [dot] net.

Feedback is very welcome and can be sent through the same channels.

Donations

Donations are always very welcome.

• paypal.me/lovemyhusky
• buymeacoffee.com/poml88

Credits

Please have a look at these projects as well:

DiaBLE, LoopKit, GlucoseDirect, Nightguard, Nightscout LibreLink Up Uploader

All product names, trademarks, and registered trademarks are the property of their respective owners. Their use here is for identification purposes only and does not imply affiliation with or endorsement by the trademark holders.

FLwatch is not affiliated with or endorsed by Abbott Diabetes Care Inc. or Dexcom, Inc.