Online documentation: compatibility, installation, setup and troubleshooting
xDrip4iOS (xdripswift) is a community-developed, open-source iOS app for displaying and managing real-time continuous glucose monitor (CGM) data. It can connect directly to a compatible CGM in Master mode or retrieve remote readings from an online service in Follower mode.
xDrip4iOS is not related to the xDrip+ project for Android.
Important
xDrip4iOS is experimental software. It is not a regulated medical device and is not approved for making treatment decisions. Never rely on it as the only source of glucose information. Use it at your own risk and confirm readings with approved equipment when necessary.
Master mode currently includes:
- Dexcom G6, Anubis and ONE
- Dexcom G7, ONE+ and Stelo over native Bluetooth, in Primary or Coexistence mode
- Libre 2 and Libre 2 Plus EU sensors over direct Bluetooth
- Compatible Libre sensors through MiaoMiao or Nano/Bubble/Bubble Mini transmitters
Follower mode supports:
- Nightscout, including Loop and OpenAPS/AAPS status data
- Dexcom Share
- Shared Calendar
- CareLink
- LibreLinkUp and LibreLinkUp Russia
- Medtrum EasyView
Sensor support depends on the exact model, region, transmitter firmware and whether an official CGM app must run alongside xDrip4iOS. Check the compatibility guide before choosing hardware or changing your setup.
- Adaptive iPhone and iPad Home layouts, including Clock Mode and configurable glucose chart ranges
- Optional sensor-noise bands, reading history, treatments, local IOB and COB estimates, statistics and time-in-range views
- Custom glucose, missed-reading, device and battery alerts, with scheduled spoken readings and trends
- Nightscout upload and synchronization, Dexcom Share upload and Apple Health integration
- Apple Watch app and complications
- Home Screen and Lock Screen widgets, StandBy support, Live Activities and Dynamic Island layouts, including sensor warm-up status
- Siri and Shortcuts access to the latest reading and Speak Glucose controls
- Optional calendar events and contact-image displays
- AID status displays and open-source data sharing with Loop/iAPS and Trio
- Contextual links to the online documentation and a filterable Activity Log for troubleshooting
- Bluetooth connection diagnostics, signal-strength history and per-device battery history
- Bluetooth output to M5Stack and M5StickC companion displays
- An iPhone or iPad running iOS/iPadOS 16.2 or later
- Apple Watch Series 4 or newer running watchOS 10 or later for Watch features
- An internet connection for follower modes and cloud services
- A compatible CGM setup for Master mode
Some extensions and system features require newer hardware or iOS versions.
xDrip4iOS is primarily a do-it-yourself app and does not have an open public TestFlight. The supported installation paths are building from source with Xcode on a Mac or creating a personal TestFlight build with GitHub Actions and Fastlane.
The current project is configured for Xcode 26, Swift 5, iOS 16.2 and watchOS 10. Stable releases are maintained on master, while ongoing development is merged through develop.
The maintained installation documentation describes the available options and requirements. The repository also contains the supporting personal TestFlight documentation.
- User documentation
- Installation and setup
- Troubleshooting
- GitHub issues for verified, reproducible bugs
Please use the community support channels linked from the documentation for general setup help rather than opening a bug report or contacting maintainers privately.
Bug fixes, translations, documentation improvements and new features are welcome. Base development work on the develop branch and open a pull request with a clear description of the change and how it was tested.
xDrip4iOS is released under the GNU General Public License v3.0.