iOS and WatchOS Client for the Nightscout CGM System

Last update: Dec 28, 2022

Related tags

Health App nightguard

Overview

Nightguard

This is an iPhone and Apple Watch application to display blood glucose values stored at your nightscout server.

Description

Disclaimer! Don't use this App for medical decisions. It comes without absolutely no warranty. Use it at your own risk!

Nightguard is an app that displays your blood glucose values from the Nightscout backend.

It is a native iOS App with support for the Apple Watch. Features are:

Define a range of acceptable blood glucose values.
Whenever your values are out of range you will be alerted.
You can snooze the alerts all the time and for a defined time period.
You can reactivate the alerts all the time.
You can activate alerts if the values are rising or falling too fast.
The app displays yesterdays values as an overlay chart. This way you have a hint about how your values could behave in the future.
Tune your basal rates with the statistics function to overlay different days

For the alarms to work the app has to be active. So you can enable a screen lock that keeps the app running all night long.

Have a look at https://nightscout.github.io for more information about how to setup your own Nightscout backend.

The dark gray region in the chart marks the values that are between 80 and 180.

This small video shows how to check the configuration and demonstrates the available Apple Watch Complication: http://youtu.be/CEcqNyyv_kA

License

nightguard app to display cgm readings on your ios and watchos device
Copyright (C) 2018 Nightguard contributors.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Comments

Watch App crash since iOS 11 update

Hi Dirk,

Thanks for all you do with this app! Have noticed since the recent iOS 11 update the app on my Apple Watch Series 1 has not been as stable, consistently notice it defaults back to main apple watchface and sometimes see a lag in the update. Verified settings are to set to always open on last app and both iPhone and apple watch are running the most recent software. Also noticed the complication is no longer available and while it didn’t always update from the native apple watchface it was nice to be able to have a ‘quick link’ to the Nightguard face. I’m located in Canada. Any suggestions are greatly appreciated and thanks again!
bug

opened by NightscoutLS 60
Alerts

On iphone while the app at the background I’m not getting any alerts, only when I’m opening the app, is it a bug ? How can I get alerts when my phone is in my pocket .. it’s very important ( I did all the correct setting and still is not working ) many thanks

opened by adirazran 43
NightGuard for Apple Watch and disabling all alerts

Hi, not sure if this is a bug or a feature request!

I have Nightguard installed to deliver current readings and the graph to an Apple Watch (on two separate phones / watch pairs). For a whole bunch of reasons we don't want any alarms at all from Nightguard (both on phone and watch). In looks as though the configuration for disabling this is working on the phones (although the low and high don't have an "off" we set them to max low and max high to minimise triggering). However, on the watch we seem to be getting random haptic feedback from Nightguard. Is there a way to ensure that Nightguard does not trigger any haptic feedback on the watch app?

Brilliant app though!
enhancement

opened by fromorbonia 35
Nightguard App - Constant high BG alarms

High alarm slider not working. Constant high BG alarms no matter what BG level is since latest update. Have deleted app several times and re-installed makes no difference
bug

opened by MikeLee1762 32
Improvements to care tab
Can carb entry on the app and watch be free text (with a keypad on the watch)?

TT target values in mmol/L are odd increments - 4.0, 4.5 etc would be better

feature request: pre defined TTs would be nice (like in AAPS) but not essential

enhancement
opened by aliswalker 30
Crash after update to version 3

I updated the app to the last version ( version 3) released yesterday. From that moment on the app crash on my iPhone and on my iPad. Is this my issue or an app issue?

Thanks for your help
bug

opened by AlessioRosi 28
Adding Access Token to enable graph on apple watch

Graph hasn’t been working for a few weeks now and looks to be related to updates and the need to add an access token. Can someone please specify the format for adding the token please? The example on NightGuard app - http://Nightscout?token=mytoken doesn’t make any sense to me!

opened by Kloy40 24
Bg on App badge even when disabled

I have enabled app badge and was unhappy how it is inaccurate and late. Then I disabled it but badge is still there and still showing wrong info. I am on mmol units if that matters
bug

opened by OpossumGit 22
BG value not updated when BG<=2.2

On the screenshot you can see that the numerical BG value has not been updated for more than an hour. However the graph shows that there were other values (2.2) which were downloaded, but did not change the numerical value. Similarly the snooze pressed at BG value 2.3 is not counting down (as can be seen on another screenshot), therefore no alarm will be triggered as long as the actual BG value is 2.2. I’m running iOS 15.1.1
bug

opened by annaneubauerova 19
Unexpected switch to the Apple Watch Face

We should distinguish this in contrast to the real app crashes reported by issue24. My hope was that that could be fixed by issue24, but it seems like this is something different.

opened by dhermanns 19
Apple Watch 5 not Displaying

I have an Apple Watch Series 5 and it does not display the graph in complications it only say s Nightguard or the logo until I go into the complication

opened by pemby143 18
Feature Request: Widget/Complication Styles

I love Nightguard! I was wondering if there could be different widget styles for the Lock Screen and Watch Complication - for example, one that had only the bg number and a small arrow for the trend with a gauge

opened by mendelini 0
feature request: increase refresh rate to 1min

We are using Freestyle Libre 3 sensor which gives BG reading to nightscout every minute. Is it possible to increase refresh rate on Nightguard as well to 1min?
enhancement

opened by zibra 4
Feature request Home Screen widget

I'm not sure if this is the appropriate place to make a feature request. I chimed in on #198 since that issue was only regarding Lock Screen widget I thought it best to make a separate feature request dedicated to requesting a Home Screen widget.

I've been using the Home Screen widgets from LinkBluCon and like them a lot.

Is there a more appropriate place for me to discuss feature requests?
enhancement

opened by simensen 1
Tabs not saving layout

Hello,

First I want to thank you for this amazing app! I wanted to report something that I think is unintended behavior.

When I edit the bottom tabs, if I exit the app and let it run in the background the layout will stay the same, but if I force close the app the bottom tabs revert to the default layout.

I have uploaded a video showing the behavior here: https://imgur.com/a/FNKDph8

I am on an iPhone 12 running iOS 16.0.2 (20A380) the app version I am using is 3.7.2
bug

opened by vincentimac 1
Write data from Health Kit to Nightscout?

Most of the big food apps, my fitness pal being one - write total carbs to health kit. It would be great if those values could be written to nightscout. It would save double entry.
enhancement

opened by totalitarian 2

Releases(V3.7.2)

V3.7.2(Sep 23, 2022)
V3.7.2:

Support for iOS 16 Lockscreen Widgets

Optimized Circular Complication that displays the blood glucose even on small watches fine.

Glucose values every minute should be displayed now - if your Sensor supports this.

Source code(tar.gz)
Source code(zip)
V3.6.4(Nov 9, 2021)
THIS UPDATE NEEDS WATCHOS8. DON'T UPDATE IF YOUR WATCH DOESN'T SUPPORT IT ANYMORE!!

V3.6.4:

The last value is displayed is once more preserved.

Delta values for mmol should be displayed now correctly on th fullscreen and in notifications.

Improved stability

V3.6.3:

The Watch Part can now be used even if on WatchOS 7. The Always-On Feature should still be available if your watch is on WatchOS 8.

Suppressed an error message if no data was available at all.

mmol delta values should be display now fine.

Removed the short color flickering before displaying the delta value.

V3.6.2:

Fixed a problem with the new api v2 properties endoint that could occur if you didn't have iob and cob configured on your nightscout backend.

V3.6.1:

Switched from the old Pebble-API to the newer API V2 Properties Endpoint: This should fix the old nightscout bug that delta values are wrong if using mmol.

Source code(tar.gz)
Source code(zip)
V3.6.0(Oct 7, 2021)
THIS UPDATE NEEDS WATCHOS8. DON'T UPDATE IF YOUR WATCH DOESN'T SUPPORT IT ANYMORE!!

V3.6.0:

Support for iOS 15 and WatchOS 8

Always-On support for the nightguard watch part

New Duration-Tab to keep track and define your Sensor, Cannula and Battery Change Dates

Fixes a problem where the initial units on the watch are displayed in mmol, although mgdl has been requested

Fixes a problem with watchOS 8 where mmol values in a complication have been truncated

Thanks Markus for the Finnish translation!

Source code(tar.gz)
Source code(zip)
3.5.0(Jun 17, 2021)
V3.5.0:

Custom Alarm Sounds can be uploaded from icloud now - at least if you are using iOS 14.

Source code(tar.gz)
Source code(zip)
V3.2.2(Jun 17, 2021)
V3.2.2:

colored uploader battery on the phone app

colored care data and uploader battery on the watch app

better error message if you secured your backend and forget to enter your security token in nightguard.

Introducing user defined default temporary targets. They can be changed by the user and will be synced to the watch. The last entered temporary target is automatically stored as the new default. And that is done for every temporary target reason.

finer grained carbs entry

More Finnish translations (thanks Markus!)

Source code(tar.gz)
Source code(zip)
V3.4.0(May 22, 2021)
V3.4.0:

Improved rendering of bolus treatments

removed flickering of the time/battery display

Fixed a problem when entering a new nightscout URI

Fixed a problem where no bolus treatments could be visualized

Source code(tar.gz)
Source code(zip)
V3.3.0(Mar 26, 2021)
Displays Correction Bolus as triangles in the chart now

Displays Meal-Bolus Carbs and Insulin in the chart now

Mmol Temporary Targets from AndroidAPS should be correctly converted now

Source code(tar.gz)
Source code(zip)
V3.2.1(Dec 22, 2020)
Switched back to the v1 api. Quit a lot people are still on very old nightscout version => Graphs should be visible now again for these old nightscout backends => But don't forget to update your backend!

Reservoir Units can be displayed now - even if they have decimals

Increased and finer ranges for carbs and temporary targets

Source code(tar.gz)
Source code(zip)
V3.2.0(Nov 30, 2020)
THIS VERSION DOES NOT SUPPORT APPLE WATCH SERIES 0, 1 or 2 ANYMORE!

The UI of the App is renewed to Swift-UI and therefore Apple has no more support for these type of watches. Sorry!

But you can try to stay on V3.1.3 as long as you can...

V3.2.0:

Care- and Loop-Data can be hidden now

Care-Tab remembers the last selected Temporary Target now.

Rewritten WatchOS App in SwiftUI

Temporary Targets can be set on the Watch now.

Carbs can be added on the app and on the watch.

Added the visualization of measured blood glucose values as red dots in the chart.

Removed the RAW Feature for Dexcom G4/G5 Sensors

Possibility to enter the baseURL on the watch by using speech or scribble.

Source code(tar.gz)
Source code(zip)
V3.1.0(Oct 7, 2020)
THIS IS THE LAST VERSION THAT SUPPORTS THE APPLE WATCH SERIES 0, 1 or 2!

Support for these watches will be closed by this version. The UI of the App is renewed to Swift-UI and therefore Apple has no more support for these type of watches. Sorry!

But you can try to stay on V3.1.0 as long as you can...

V3.1.0:

Reservoir Level is displayed on phone and watch now

Bringing some color to the lives of mmol users ;-)

Works around a bug in Nightscout 13.x.x. Hopefully better recognition of mmol usage

added haptic for the alarm sliders

Fixed some mmol problems regarding notifications

V3.0.2:

Fixed some visualization problem for certain users

Temporary Targets should be displayed as mmol now (if mmol is the preferred unit)

The cannula age will now be queried for the last 5 days. I think everyone will have to change it till then, right ;-)

V3.0.1:

Fixed a crash that happened for certain users

V3.0.0:

added Careportal data to the main screen:

Sensor-Age

Cannula-Age

Battery-Age

and Pump Basal Rate Data

Added Carbs-on-Board (cob)

possibility to set temporary targets

new green/yellow/red colors (thanks Gerrit!)

more robust behaviour to distinguish between mgdl and mmol settings

fixed the app badge visualization if you are using mmol settings

provided a button to manually set the preferred display unit (mg/dl or mmol)

the graphiccorner complication displays colored bg values now

improved colors on the statistics view

V2.8.0:

The nightscout web app can be opened using force touch on the target button now.

All alarms can be disabled with just one click. 3.238

Source code(tar.gz)
Source code(zip)
V3.0.0(Sep 9, 2020)
V3.0.0:

added Careportal data to the main screen:

Sensor-Age

Cannula-Age

Battery-Age

and Pump Basal Rate Data

Added Carbs-on-Board (cob)

possibility to set temporary targets

new green/yellow/red colors (thanks Gerrit!)

more robust behaviour to distinguish between mgdl and mmol settings

fixed the app badge visualization if you are using mmol settings

provided a button to manually set the preferred display unit (mg/dl or mmol)

the graphiccorner complication displays colored bg values now

improved colors on the statistics view

Source code(tar.gz)
Source code(zip)
V2.7.5.542(Jun 14, 2020)
the app is now localized for the german and finish language (Thanks Markus and Sabine!)

localized clock visualization

Source code(tar.gz)
Source code(zip)
V2.7.4.512(Jan 7, 2020)
Landscape mode should work again when in fullscreen mode

Fixed the font in the snooze popup for iphone x/xs/11

Internal switch to Swift version 5

Source code(tar.gz)
Source code(zip)
V2.7.4.510(Dec 23, 2019)
Landscape mode should work again when in fullscreen mode

Internal changes to Swift 5

Source code(tar.gz)
Source code(zip)
V2.7.486(May 2, 2019)
Are you waving your hands sometimes during sleep and have nightguard near your bed? Then this is for you:

Slide-to-Snooze Button for additional security to not doing an accidental snooze.

Further more, an extra Night-Monitor mode can be activated. It has extra big letters for optimal readability at night. Thanks Florian for providing this!

Snooze and ignored missed readings are now persistent on the watch and pretty nice synced between the ios and the watch app. Once more thanks florian for that!

Added a disclaimer to keep in mind that this app is a volunteers project without any warranty. Use at your own risk!
Source code(tar.gz)
Source code(zip)
V2.6.254(Apr 24, 2019)

Display some statistics for the most recent readings. The stats panel contains 3 circular views + a period selector view, each of them having a number of "pages"; tapping the circular view will "turn the page", presenting another stats aspect. The views:

glucose average & A1c estimation + glucose variation (standard deviation & coefficient of variation); along the values, a color-meter border gives feedback about the values (green - great, yellow & values in between - ok, red - not so good)

glucose distribution view: percents/time for having the glucose readings in low/in/high ranges readings count, invalid readings view

period selector - toggles the period between Last 24h / Last 8h / Today / Yesterday / Today & Yesterday. For the moment, the Low & High thresholds are the Low & High alarm values.

Thanks Florian for this nice feature!
Source code(tar.gz)
Source code(zip)
V2.5.443(Mar 26, 2019)
Many new features - once again thanks florian!

Completely new configuration UI

override system volume, progressive volume & vibrate (configurable in volume subscreen)

quick snooze feature (configurable short snoozing when shaking the phone or volume buttons)

dim screen when idle feature (configurable after how many minutes of idle)

Apple watch also got some consistent things:

all the alarm settings & relevant prefs are synchronized more consistently than before

Snooze on watch also snoozes the phone (and reverse)

"Night Safe" indicator in watch (a small green dot on bottom) when phone is activated, lock screen is on and audible volume - for people who do not want to sleep with their phones, just check on the watch that the phone alarms will be effective

Source code(tar.gz)
Source code(zip)
V2.4.385(Feb 21, 2019)
Florian did a lot of work. Thanks for that Florian! So you get new features & fixes:

Fixes for consolidating updates of watch app on activation & double-tap

Nightscout service & cache always call completion (even when the request is served from cache), so more consistent handling in clients

Sync current BG reading time with Nightscout

Fix timer in phone app that could stop working when the app went to background (and no alarms were ever played)

Show current BG on app badge - inspired by Spike app

Local user notifications when alarm is activated and the app is in background

Facelifts in all screens

More consistent keyboard handling in Prefs, URI error handling & reporting

Show alarm reason in notification, main screen & watch

Smart snooze feature (do not alert when high or low but the BG is going in the right direction or predicted to leave the zone in next 30mins) - inspired by xdrip+

Low prediction alert - also from xdrip+

Show next predicted values in charts - cooler than in xdrip+ ;)

Open Nightscout in app - Spike again

Source code(tar.gz)
Source code(zip)
V2.2.295(Nov 7, 2018)

-Support for the Apple Watch Series 4 -Added new Complications for the Infograph Watchface -Fixed a problem during daylight saving switches (thanks go to Florian)
Source code(tar.gz)
Source code(zip)
V2.1.1(Jul 30, 2018)
Florian added the raw-bg feature for dexcom users - thanks for that!

Fixed some stability issues.

Fixed an issue with the snooze popup.

Fixed an issue where a HTTP timeout warning was displayed (too often).

Source code(tar.gz)
Source code(zip)
V2.1.0(May 6, 2018)
V2.1.0 comes with an improved Snooze-Screen:

45min snooze now possible (special for marcos ;-) - much better to read at night (especially when you are short-sighted like me ;-)

Source code(tar.gz)
Source code(zip)
V2.0.0(Apr 2, 2018)
Completely Rewritten Background Updates on Watch and App

Completely Rewritten Complications. You will love them now ;-) Florian managed to struggle down the difficult background job api from apple!

Invalid values (e.g. due to bad sensor) lower than 10 are ignored in the chart now. The display space is used more efficient due to that.

Better Alarm-Slider usability

Better Alarm-Value synchronization to the watch

All contributed by Florian! Thanks for this amazing job!
Source code(tar.gz)
Source code(zip)
V1.7.0(Mar 4, 2018)
Did you had the problem that the snooze button was pressed accidentally at night? This has been fixed in 1.7.0: The snooze button now snoozes for 30 seconds during the popup screen. If you don't select a snooze time, you will get alarms even if the popup stays in front. That is a feature for my loving wife - happy birthday Konny ;-).

New progress indicator on the watch. You can double tap to refresh the current values. Thanks Florian for providing this feature!

(Hopefuly) fixed a crash which could have happened if you have alerts for consecutive values right after midnight

Source code(tar.gz)
Source code(zip)
V1.6.0(Feb 25, 2018)
the trend arrow is now conforming to the nightscout one (thanks for the hint goes to hummelstrand ;-)

experimentally implemented alarms on the watch

Source code(tar.gz)
Source code(zip)
V1.5.1(Jan 25, 2018)
Potentially fixes issue24 which causes the watchOS to crash in some situations => If you still have this issue afterwards, please try to deinstall/reinstall the whole iOS app. This will clear your local app cache.

Improved watchOS app layout

Source code(tar.gz)
Source code(zip)
V1.5.0(Nov 23, 2017)
Completely rewritten data update and caching mechanism

Improved update speed and data consumption

Fixed an update issue on the apple watch. That was a hard one - sorry for the delay!

now displays insulin-on-board (thanks to Miguel!)

Updated for the iPhone X

Source code(tar.gz)
Source code(zip)
1.4.2(Oct 18, 2017)
Version 1.4.2:

Recompiled to be used with IOS11

Removed alarms in background. IOS didn't allow them to work correctly. Instead they started to play immediately when opening up the app - which was irritating.

Fixed zooming and scrolling on the apple watch

Updated for watchos4

Source code(tar.gz)
Source code(zip)
V1.4.0(Mar 28, 2017)
the chart can be swiped and moved around now.

the chart can be scrolled using the digital crown on the watch

by force pressing a zoom mode can be selected on the watch. Afterwards the crown will zoom in and out the chart on the watch.

fixed an issue with changing the device orientation when switching from the stats view to the main view.

Have fun!
Source code(tar.gz)
Source code(zip)

Owner

GitHub

:globe_with_meridians: Small iOS app to show some COVID-19 health, data, news and tweets

covid19.swift Small iOS app to show some COVID-19 health, data, news and tweets ⚡ Requirements Xcode 12, iOS 14 Credits API: COVID-19 API: News Tweets

26 Nov 30, 2022

Intuitive cycling tracker app for iOS built with SwiftUI using Xcode. Features live route tracking, live metrics, storage of past cycling routes and many customization settings.

GoCycling Available on the iOS App Store https://apps.apple.com/app/go-cycling/id1565861313 App Icon About Go Cycling is a cycling tracker app built e