Message from the Loop and Learn Team:
- We have taken responsibility for updates to the Loop Follow app
- Additional Loop Follow documentation is at Loop and Learn: Loop Follow
- If you are having problems with the app:
- Post in the Loop and Learn Facebook group; indicate that your question is related to Loop Follow
- If you do not use Facebook - please click on this link to file an Issue with your problem
New location for LoopFollow Repository:
- If you previously created a fork of LoopFollow from the JonFawcett username
- Please note the repository name has changed to https://github.com/loopandlearn/LoopFollow
- GitHub should automatically redirect you to this new address
- We have also modifed one branch and one file name to match standard conventions: main (from Main) and README.md (from readme.md)
Message from Jon Fawcett:
- Because our family now uses Omnipod 5, I will no longer be involved in updating LoopFollow
- I have transferred the LoopFollow repository from the JonFawcett to the loopandlearn username
- I will also no longer provide an option for a TestFlight invitation from me. (Jon Fawcett)
- You must build the app yourself.
Message to Developers
- Please click on this link: For Developers
Using so many different apps as a parent or caregiver of a T1D can be very cumbersome. Add in the extra details from Looping and it can be a challenge flipping back and forth between apps. Each app has different strengths and weaknesses.
- Spike is great for alarms.
- Spike and Sugarmate are great for the calendar complication on Apple Watch.
- Nightscout X or Nightscout in Safari are needed for intricate details from NS.
- IFTTT and Pushover are needed for Not Looping alerts.
And there are some functions I've always wished for and not found anywhere such a one-time temporary alert for those nights when Loop is stuck on high and you open loop with a correction. This lets you set a higher low alert for the BG you want to wake up to and close Loop.
Please see Loop and Learn: Loop Follow for all the building options.
With the release of version 2.1.0, there is now an easy option for building up to three instances of the Loop Follow app for multiple Loopers in your family. Each instance can be configured to have the display name you choose with these names being the default:
- LoopFollow
- LoopFollow_Second
- LoopFollow_Third
The display_name is found in a single file.
- Suggestion if you customize the name: use LF {unique name} so you can find the apps easily in iOS Settings screen
Summary instructions by build method:
- Browser Build:
- Fork and setup the repository for each Loop Follow instance you want to use:
- Commit the desired display_name in the LoopFollowDisplayNameConfig.xcconfig file of your forked repository for LoopFollow, LoopFollow_Second or LoopFollow_Third
- Mac-Xcode Build
- First build with script, you will be prompted to enter the desired display_name
- This display_name is used each time you select a fresh download for LoopFollow 1, 2 or 3
- To modify the display_name for subsequent script builds, edit the appropriate file in the ~/Downloads/BuildLoopFollow folder
- LoopFollowDisplayNameConfig.xcconfig
- LoopFollowDisplayNameConfig_Second.xcconfig
- LoopFollowDisplayNameConfig_Third.xcconfig
When modifications and versions are updated, there might be a slight delay for getting the second and third forks updated as well, so if you are using this feature, wait until all three repositories are updated.
Please review the list on Loop and Learn: Loop Follow which may be updated more frequently than this README.md file.
Each time a release is made, the features added or bugs fixed are found at Loop Follow Releases.
Each of the features below is selectable - you decide whether to use them. Additionally, many features are adjustable because YDMV (your diabetes may vary).
- Scrollable/scalable graph display with BG, IOB, COB, Basal, Bolus, and the General Nightscout Care portal info
- Supports Glucose display when Dexcom is available but Nightscout is not
- Supports compatible data from Nightscout when the URL is provided (enable
Show Nightscout Settingsto see the URL, Token and Status rows)- Loop: Loop status, Loop Prediction
- Trio and iAPS: status, Prediction lines, Autosens
- To remove the Data Table associated with NS, enter a blank line in URL
- Tap on Alarms on Toolbar to configure.
- Override DND (Do Not Disturb) and system volume for all alerts with a Snooze All Until and a Mute All Until
- List of Alarms covers the standard high/low/rise/fall/urgent glucose but also include alerts for missed glucose readings, if below configured glucose, IOB, COB, Not Looping, Overrides, Pump, Missed Bolus, SAGE, CAGE, Battery and Rec. Bolus
- Each Alarm has configurable settings including Sound selection, PreSnooze (set to be quiet At Night, During Day or Never) and Snooze Until and in some cases glucose ranges at which they are active
- Calendar entries (displayed on watch and/or carplay at 5 minute intervals) pre-formatted with two lines that the user can modify:
- BG, arrow, delta, MINAGO (minutes ago for reading)
- COB, IOB, Basal (U/hr)
- Background silent audio is played to keep iOS from killing the app; this trick is why it can’t go into the App Store for a simple download and why Loop Follow puts an extra load on the phone battery
- Badge displays the current BG value on the app icon
- Information Display Settings allows user to configure the items selected and their order for the right panel when Nightscout URL is provided
- IOB, COB, Basal, Override, Battery, Pump, SAGE, CAGE, (Recommended) Rec. Bolus, (Glucose Eventually) Pred., Carbs today (Loop, Trio and iAPS)
- Autosens (Trio and iAPS only)
- Pull down on the glucose value to force a refresh from Nightscout (iPhone only - does not work on Mac)
- When adding a Nightscout site, NS Status says "Checking", "Site Not Found", "Token Required", "Invalid Token", or "OK"
- New with v2.1.2: Multiple Loopers (up to 3) are easily supported with either Browser Build or Mac-Xcode build
- New with v2.1.2: The app name (displayed on phone) can be customized when building
- If enabled, that custom name will be displayed on the main Loop Follow display
- This is a DIY open source project that may or may not function as you expect. You take full responsibility for building and running this app and do so at your own risk.
We added version numbers to Loop Follow. Typically the main branch and dev branch are at the same version, but when work is underway, the dev branch may have different code, which we try to indicate with a different version number.
The versioning is:
- major.minor.micro
- For example our first version is 2.0.0
For the most part, the deveopers keep main and dev branches at the same level. But sometimes we want to combine several PR or keep a modification in dev for additional testing.
- If you are interested in assisting with this app and want to work on new features and improvements for Loop, Trio, iAPS and Nightscout functionality, please reach out.
- Issues and Pull Requests in GitHub are monitored and will get a response.
New PR are directed to the dev branch. If you direct one to main, we will move it to point to dev. So always start with your code aligned with dev.
After a PR is merged to dev, the repository maintainers will bump up the verion number before merging to main - please do not modify the version in your branch.
Only the maintainers for Loop Follow will update version numbers. This is done by incrementing the LOOP_FOLLOW_MARKETING_VERSION in Config.xcconfig file.