The Loop Features in Development provided by the Customization Select Script are:
- Bundled Code Fixes
- When bugs are indentified and fixed, or improvements made, it can take time to be released
- These fixes and improvements are provided early, after being tested by the Loop and Learn team
- Profiles Save & Load
- Save and load named Profiles, which contain a subset of your Therapy Settings
- The name of the current profile is uploaded to Nightscout and can be viewed using LoopFollow when you use those auxilliary applications
- Basal Lock
- Live Activity and Dynamic Island
- This feature adds Live Activity and Dynamic Island features to Loop 3.4.x.
- Requires iPhone 14 or newer, iOS 16.2 or newer
If you have never used the Customization Select Script before, please go to that link and read about it.
Users of Loop dev branch:
- The Loop and Learn team suggests only using the main branch at this time
- After the release of Loop 3.4.4, the dev branch is not supported by the customization script
This page is devoted to describing features that are more complicated than simple line edits. These customizations are available as part of the Customization Select script. Some may eventually be added to Loop in the future.
WARNING: These are development features and you are responsible for understanding them prior to use. These are NOT supported by the Loop developers. Please post issues on Loop and Learn Facebook including what you tried to customize on what version of code. If you do not use Facebook, you can post your question here: https://github.com/loopandlearn/lnl-scripts/issues
Bundled Code Fixes
This customization provides known fixes and improvements to Loop 3.4.4.
When bugs are indentified and fixed, or improvements made, it can take time to be released.
These fixes and improvements are provided early, after being tested by the Loop and Learn team.
Bolus Display Bug
There is an intermittent bug where sometimes the bolus progress message (1.2 of 2.3 U) in the middle of a 2.3 U bolus uses an old value for the expected delivery total. This affects all pumps.
- You might see a final bolus progress message of 1.2 of 0.1 U and get concerned that Loop is over-delivering
- You might see a final bolus progress message of 1.2 of 2.3 U and be concerned that delivery stopped early
This was reported by many people and finally a method to cause it to happen was developed and the bug was fixed.
- For detailed information please see Loop Pull Request 2264: Update progressCell for Bolus Display
Eros Pod Clock Icon
The clock icon, which shows on the main screen when there is a time change, is missing for Eros pods (OmniKit submodule) for Loop 3.4.4 (as well as older Loop 3.x versions). This can make it less obvious that the pump time and phone time do not match. The clock icon was added and now the expected clock icon shows up on the main screen during travel or seasonal time changes for those using Eros pods.
- For detailed information please see OmniKit Pull Request 46: return clock icon when isClockOffset is true
Various OmniXXX Improvements
A number of improvements were added to both OmniBLE (DASH pods) and OmniKit (Eros pods). They cover unusual events that can and have happened. Adding these improvements may prevent you from having to quit and restart because there was communication that was missed – these cases are handled more cleanly. This portion covers 7 different pull requests merged into OmniBLE and OmniKit. The list is provided below for those who are interested.
- https://github.com/LoopKit/OmniBLE/pull/134
- https://github.com/LoopKit/OmniBLE/pull/135
- https://github.com/LoopKit/OmniBLE/pull/136
- https://github.com/LoopKit/OmniBLE/pull/137
- https://github.com/LoopKit/OmniBLE/pull/138
- https://github.com/LoopKit/OmniKit/pull/44
- https://github.com/LoopKit/OmniKit/pull/45
Profiles Save & Load
The Profile feature is crafted to swiftly save and transition between therapy setting subsets tailored to your needs.
This is a work in progress, but even with the current code, it is quite useful. After adding this customization, the Profiles row is found on the Loop Settings screen below the Therapy Settings option. A pump must be added to Loop for the Profiles screen to be visible.
On 20 January 2024, this feature was enhanced to upload the name of the current Profile to Nightscout. This was added at the request of caregivers who also use Loop Follow. Note that only the current Profile is uploaded to Nightscout.
- Therapy Settings included in the saved Profile
- Basal Rate Schedule
- Correction Schedule
- Carb Ratio Schedule
- Insulin Senstivity Factor Schedule
The User can save new profiles (from their current Therapy Settings), and they can load, rename or delete saved profiles
- The Profiles are saved in the local Loop Storage on the users phone
- To edit an existing profile that is currently selected
- Edit Therapy Settings and Save
- Go to the Profiles screen and Update the profile
- To create a new profile
- Edit Therapy Settings and Save
- Go to the Profiles screen and Cancel instead of updating the profile
- Tap on the + sign to create a new Saved Profile and name it
- To load a Saved Profile
- Go to the Profiles screen and select the desired profile
- After reviewing the settings, select the Load Profile button to update to those saved Therapy settings
Loop Settings Screen with Profiles Added
The graphic below shows an updated Loop Settings screen when the profiles customizations is added.
The Profiles feature is accessed by tapping on the Profiles button underneath Therapy Settings.
Reverse Chronology of Updates
- September 2024
- The script was updated so the either “2002” or “profiles” can be used in the build_loop.yml file to add this customization for Browser Build
- Users of the menu driven customatization script (using Xcode) will not notice a difference
- January 2024: added writing the current Profile name to Nightscout
- To accommodate the requirements of Nightscout, the “.” and “<” characters cannot be used in a profile name
- Any existing, or new, profile names will automatically have those characters replaced with an underscore (“_”) – feel free to rename again, just find something other than “.” or “<” to use – they will be replaced when you save
- The length of the name is now truncated to 32 characters to improve legibility in Nightscout and in LoopFollow
The original formal PR is found at https://github.com/LoopKit/Loop/pull/2002. That PR is no longer being updated and is not aligned with the current customization.
Basal Lock
This feature replaces the basal lock that used to be in CustomTypeOne LoopPatches.
It now has proper guardrails and can be adjusted in the app using a new Preferences Row found on Settings below Favorite Foods and above Services.
Live Activity and Dynamic Island
This feature adds Live Activity and Dynamic Island features to Loop 3.4.x.
- This only works on iPhones 14 and newer
- The dynamic island support is found on iPhone 14 Pro models
- The minimum iOS is 16.2
- The configuration for the Live Activity widget on the lock screen is found under Loop, Settings, Notifications, Live Activity
- You must also enable Live Activity under iPhone settings, Loop, tap on Live Activites and enable Allow Live Activites and More Frequent Update
- There may still be a few display issues regarding overrides – please review [DRAFT] feature: Live Activity