Releases
Loop Releases¶
The new features added with each Loop release are provided for reference.
For information about version 2 releases and compatibility between version 2 and 3, refer to Older Releases.
Current Release¶
The current released version for the Loop app is 3.4.1. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
What Version Do I Have?¶
Tap on the Settings icon at the toolbar of the Loop app and look at the version information at upper left.
Is the Released Version Newer?¶
Release information is always found on the GitHub LoopKit/Loop release page.
Additional information including links is found here, but be aware that updates to LoopDocs may take some time after a new release comes out.
Loop 3 Version History¶
Loop v3.4.1¶
Loop v3.4.1 was released on 19 July 2024.
This was a patch that fixed errors with the Browser Build. No other changes were made.
Loop v3.4.0¶
Loop v3.4.0 was released on 13 July 2024.
- Link to release notes for Loop 3.4.0
- There are some one-time update steps required for those who Build with Browser:
Summary of Important New Features¶
These features are added:
- Libre support in the Loop app
- Favorite Foods for easy entry of common meals
- Algorithm Experiments:
- Glucose Based Partial Application for Automatic Bolus corrections
- Integral Retrospective Correction
- In app warning when a TestFlight install build is about to expire
- Omnipod and Nighscout Users: automatic update of CAGE to Nightscout when pod is changed
- Dexcom and Nighscout Users: automatic update of SAGE to Nightscout when Dexcom sensor is changed
- Medtronic and Nighscout Users: automatic update of CAGE to Nightscout when set is changed
- Omnipod Users:
- Cannula Insertion uses a slider to minimize accidental insertion before pod is attached to the body
- Pod Deactivate uses a slider to minimize accidental deactivation
- Pod Set up from Pod Pairing until Cannula is inserted now disables auto-lock of screen
- Browser Builders:
- improved error messages and automatic rebuild of app to TestFlight
- automatic addition of all services except App Group to the App Service for Identifiers
Summary of Bug Fixes¶
- Widgets:
- Updated to work with iOS 17
- Dexcom G7 Users:
- fixed how one item was read from the G7, this bug caused a rare time discrepancy
- Omnipod Users:
- prevent unnecessary faults (rare but it could happen)
- improve restarts when app is interrupted during pod setup
- better detection of communication issues
- improve handling of alerts
- Fixes for mmol/L users
- Missed Meal notification calculation is now correct
- Glucose limits can now use the min or max value with no restrictions
- Nightscout as a CGM works again for older iOS versions, it no longer requires iOS 17
Loop v3.2.3¶
Loop v3.2.3 was released on September 19, 2023.
This patch release was required for those who build using the Mac method.
- There are no changes to app functionality
- Version 3.2.2 and earlier cannot be built using Xcode 15, see Cycle Inside Loop
Loop v3.2.2¶
Loop v3.2.2 was released on April 24, 2023.
This is a patch release to fix archiving with Xcode 14.3.
Loop v3.2.1¶
Loop v3.2.1 was released on March 20, 2023.
This is a patch release primarily dealing with localization updates.
- G7 Plugin localization fixed: was defaulting to Spanish in some cases.
- Updated translations from translators on Lokalise.
- Many behind-the-scenes fixes for how strings are tracked in the various frameworks that Loop uses, fixing a large number of broken/missing translations.
Loop v3.2.0¶
Loop v3.2.0 was released on March 17, 2023.
There are some important bug fixes and new features, so please rebuild to this version as soon as possible.
Pete's announcment:
Loop 3.2 Is released! This contains some very important bug fixes for everyone. If you are running latest dev, you do not need to update, but everyone else running older 3.x versions of Loop should consider upgrading as soon as you can.
https://github.com/LoopKit/Loop/releases/tag/v3.2.0
Bug Fixes (Please update ASAP):
- Omnipod bolus tracking issue fixed: link
- Medtronic temp basal tracking issue fixed: link
- Crashes caused by large updates from Apple Health fixed
- Automatic refresh timers for Omnipod (both Dash and Eros) have been removed, to reduce load on pods and reduce frequency of failed pods.
Updates and new Features:
- Missed Meal Notifications. If you want, Loop will detect situations where it looks like you may have consumed carbs but did not enter them into Loop, and will notify you with an easy option to enter the amount, and the time of eating already estimated for you. Find this option in the Alert Management section of Loop settings.
- Tidepool Service added. This lets you upload your diabetes data from Loop to Tidepool! It is in early stages, so there may be issues. Please report any issues you have with this integration on DIY Loop forums, like Zulip, GitHub, or the Looped group.
- Translations! Loop now has very good coverage for several languages, including German, Spanish, Italian, French, Danish, Polish, Dutch, Norwegian, Russian, Turkish, and Romanian!
- Warning - a few items got overwritten by Spanish - if you can't figure it out, try Google translate
- A new safeguard restricts automatic dosing to keep your IOB below a limit of 2 times your max bolus. Manual dosing can still be delivered to put your IOB above this amount. link
- Add missing X-Large watch complications. link
- “Deactivate Pod” button on some screens changed to not be so alarming, as it doesn’t actually deactivate the pod, but takes you to a screen where you can, and has an option to cancel: link
Loop v3.0.0¶
After several years of development and a lot of testing, Loop 3 is here!
Loop v3.0.0 was released on January 14, 2023.
Link to release notes for Loop 3.0
Use Script not Zip
If you follow that link above, there is an Assets
section with a zip link
- Do not try to build from the zip link
- For Browser Build, refer to: GitHub Overview
- For Build with Mac refer to:
Branch Name Change
The branch name associated with the latest Loop release is main
.
- All new Git
repositories
on GitHub will be namedmain
instead ofmaster
starting October 1, 2020 - GitHub provides tools to assist in modifying existing
repositories
to use main
Loop
Version Numbering¶
With the release of Loop 3
, there is a new pattern for identifying the releases as distinct from the development work.
Each release uses 3 numbers: Major.Minor.Patch
- Major is reserved for a significant change in the code, such as occurred going from
Loop 2.2.9
toLoop 3.0.0
- Minor is used when the development branch is released for general use
- Patch typically indicates a modification for a quick bug-fix or to support external events like an Xcode or iOS version update with no feature changes in Loop
To prevent confusion between versions used for development and versions used for release (main
branch
), the Minor values are even for released code. The Minor value for the development branch
(dev
) is incremented as part of the release process and is always odd.
For example:
Loop 3.0.0
was the first released version ofLoop 3
Loop 3.1.0
was the development version beforeLoop 3.2.0
was released
Loop 3.2.0
was the next released versionLoop 3.2.1, 3.2.2 and 3.2.3
are patches toLoop 3.2.0
without changes to the features ofLoop 3.2.x
Loop 3.3.0
was the development version beforeLoop 3.4.0
was released
Loop 3.4.0
was the next released versionLoop 3.4.1
is a patched version (fixed Browser Build) without changes to the features ofLoop 3.4.x
Loop 3.5.0
is the current development version
Remove Apps with Shared App Group¶
The storage of data with Loop 3 is not backward compatible. In other words, if you attempt to build Loop 2.2.x (or FreeAPS) on a phone which has been upgraded to Loop 3, you will not be able to run that app. You can successfully build the app, which will overwrite Loop 3 on the phone, but the app will crash and you will not be able to Loop.
At this point, you can restore your Loop 3 build on your phone and continue using Loop 3 or you delete all apps on your phone with a shared app group. This list includes Loop, FreeAPS, FreeAPS X, iAPS, xDrip4iOS, Glucose-Direct, and the g5 Transmitter Reset app.
If you tried to delete "all" the apps and still have something causing an issue; you can follow the directions to Review Provisioning Profiles and then delete the profiles for all the apps by using the - sign.
You do not need to delete LoopFollow, so if you use LoopFollow - do not delete that provisioning profile.