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.4. 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.4¶
Loop v3.4.4 restored the TestFlight expiration date for Browser Build - it was released twice with the same build number. Just make sure your build (for both Browser Build and Mac Build) are later than 12 October 2024.
- The first release on 9 October 2024 inadvertently removed all the improvements from v3.4.3, but did fix the TestFlight expiration date
-
The second release on 12 October 2024 restored the improvements from v3.4.3
Loop v3.4.3¶
Loop v3.4.3 was released on 6 October 2024.
A few days later, it was discovered that the TestFlight expiration date was no longer available for Browser Build (due to a change in 3.4.2). This was quickly remedied with the Loop 3.4.4 release.
This was a minor update to the Loop code with a few bug fixes and some capability extensions.
Please use the main
branch
Some people have become complacent about using the dev
branch to get the latest updates. This is a good time to switch to the main
branch.
New revision will be landing in the dev
branch soon. Don't be surprised - stick with main
until the changes have been tested.
These updates were incorporated in this release. The pull request for each modification is linked in parentheses.
-
CGMBLEKit: Add ONE to the display name (194)
-
G7SensorKit: Add ONE+ to the display name (28)
-
LibreTransmitter:
-
LoopKit:
-
Several fixes for OmniBLE (DASH), OmniKit (Eros)
The Browser Build method was updated to use Fastlane version 2.223.1
. This change (208) fixes a build error reported by several folks across the Open Source app community. This was also added to LoopWorkspace dev
branch (207).
Loop v3.4.2¶
Loop v3.4.2 was released on 5 October 2024.
This was a patch that fixed errors with the expiration date for the Mac-Xcode build method for Xcode 16. No other changes were made. Unfortunately, the method used to fix expiration date for Mac Xcode 16 builders removed the expiration date for Browser Builders. The expiration date for Browser Builders was restored with version 3.4.4.
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¶
There are a number of Open Source apps which use the Loop App Group to share data.
One consequence of this is that if you delete one of those apps, there may be saved information on the phone that is not discarded. Normally this is not a problem, but sometimes you really want to wipe out all the stored information.
If you are in a situation where you want to completely wipe all data from your phone for any of these apps which use the Loop App Group, you might need to delete all of them:
- Active Apps:
Loop
,xDrip4iOS
,Glucose-Direct
,iAPS
- Old Apps that might be hanging around:
FreeAPS
,FreeAPS X
and theG5 Transmitter Reset
app
These apps either have their own App Group or do not use an App Group and do not need to be deleted:
LoopFollow
,LoopCaregiver
,Trio