Introduction

xDrip4iOS (also known as "xDrip for iOS" or "xdripswift") is an open-source application to display real time blood glucose data.

It is able to connect as a Master device to various types of Continuous Glucose Monitor systems and display their values on the screen. This is the main way that most people (usually patients with Type 1 Diabetes) will use the app.

It is also able to act as a Follower device and pull remote CGM data from Nightscout. This is a great way for parents and care-givers to be able to remotely monitor loved ones and patients.

FOR XDRIP+ USERS

Please note that xDrip4iOS is not related to the xDrip+ project for Android.

For help and information about the xDrip+ project for Android, please see here or look on Facebook.


What Do I Need?

To run xDrip4iOS you will firstly need an iPhone 7 or newer running minimum iOS13.

To work as a Master device, you will need to have a compatible CGM system (see below). If you want to share your CGM data with Nightscout, then you will also need a working internet connection.

To work as a Follower device, you don't need anything except an internet connection and a working Nightscout site from where to follow the master device.

That's it. Nothing else is needed.

IMPORTANT

Before using xDrip4iOS, it is important to understand several points:

  • This is an open-source, community-based project and is not supported by any company
  • It is not officially approved or regulated for diabetes therapy and/or treatment in any way whatsoever

You must understand that you take full responsibility for using this software and you agree to do so at your own risk.


Compatible Sensors

xDrip4iOS is compatible with many Libre sensors and also certain Dexcom sensors/transmitters.

Libre

Libre 1 (European 14 day)

Transmitter Type     Firmware Version     Compatible?    
MiaoMiao 1 All Yes
MiaoMiao 2 All Yes
Bubble All Yes
Atom All Yes
GNSentry All Yes


Libre 1 (US 14 days) and 2 (European 14 day)

Transmitter Type     Firmware Version     Compatible?    
Direct Bluetooth (no transmitter)    - Yes (2)
MiaoMiao 1 >= 39 Yes (1)
MiaoMiao 2 >= 7 Yes (1)
Bubble All Yes
Atom All Yes
GNSentry - No


(1) The MiaoMiao firmware can be upgraded, if needed, using Tomato App

(2) Only Libre 2 Europe

Libre 2 US/CA/AUS, Libre Pro, Libre H

  • Not compatible

Dexcom

Dexcom G4 (1) / G5

  • Fully compatible with a bridge/Wixel device and using raw data mode.

Dexcom G5

  • Fully compatible using raw mode.

Dexcom G6

  • Fully compatible using either raw data or native modes (see below).

Older 80xxxx/81xxxx G6 transmitters can work in raw mode with the possibility of processing all data using the xDrip algorithm and manual calibration. Sensor session limits do not apply in this mode.

Newer G6 "Firefly" transmitters (>8Gxxxx) will only work in native mode using the algorithm inside the transmitter. This means that xDrip4iOS will be limited to the factory 10 day sensor sessions and is also able to start/stop sensor sessions as well as calibrating.

If you need to use the official Dexcom app to upload data to Dexcom Share or Clarity, you can set xDrip4iOS to "Follow Dexcom App" mode. In this mode, the main connection between the transmitter and your iPhone is handled by the Dexcom app. xDrip4iOS will simply receive a copy of the transmitted data. This allows you to use xDrip4iOS for all features (alarms, graphs, statistics, Nightscout, Watch app etc) without needing to stop using the official app.


Where Can I Get Help?

The main public support group for all support is the xDrip4iOS group on Facebook. Feel free to join the group, ask questions and participate.

You can also find all source code, technical information and register issues in our Github repository.


Development History

This project was started back in 2017 by Johan Degraeve. His idea was to port the original xDrip algorithm to iOS.

The original project he created was called xdripiosreader. This was later re-written in 2019 into native swift code and renamed to xdripswift.

In 2020, the user interface was overhauled, more features were added and the user-facing project was renamed to xDrip4iOS.


How Can I Get Involved?

You'll find the Github source repository for this documentation here. Please don't hesitate to improve or correct anything you see and create a pull request!

You're also welcome to contribute or report any documentation error, unclear explanation, typo, broken link etc by going to Github and opening an issue.