Loop Updates

If you are running Loop 3.0.0 (or lower), please update to Loop 3.2.x ASAP.  If you need help, please ask on Facebook.

Loop Recent Release History

Loop 3.2.x:

  • Loop 3.2.3 released 19-September-2023 to enable Xcode 15 to build released version (no effect on app itself)
  • Loop 3.2.2 released 24-April-2023. Update supports Xcode 14.3 archiving (no effect on app itself)
    • Loop with Patches updated to 3.2.2 on 30-April-2023
  • Loop 3.2.1 released 20-March-2023. Primary update is to languages (no more Spanish-only for G7 screen).
  • Loop 3.2.0 released 17-March-2023. This version included some critical fixes and new features.

Loop 3.0.0 DO NOT USE

  • Loop 3.0.0 was the first release of Loop 3 and some critical bugs were found – please do not continue using this build

    Customization Script Updates

    Recent changes to the Customization Script are listed below. To get the latest version:

    • Browser Build: Run the Action Build Loop again with your choices for Customization in the build_loop.yml file
      • If updates to the build_loop.yml file are required, the customization that needs an update is found in parentheses and quotes below, for example (“name”)
    • Mac-Xcode Build: run the Customization Select Script again to be offered the updates

    For both main and dev:

    • The Profile customization was enhanced on 13-September-2023
      • Profile Save & Load (“2002”)
      • updated 23 September 2023 to be compatible with dev, no changes to features

    For main:

    • Limit CGM driven Loop cycle to 5 minutes updated as of 10-August-2023 (“limit_loop_cycle_time”)
    • Algorithm Experiments updated – the Integral Retrospective Correction updates (PR 2028) are included as of 25-July-2023 (“algorithm_experiments”)

    For dev:

    • 23 Sept 2023: “omnipod_cage” is no longer needed – this functionality was added to Loop (thanks again Pete)
    • 22 Sept 2023: “dexcom_sage” is no longer needed – this functionality was added to Loop (thanks Pete)
    • Limit CGM driven Loop cycle to 5 minutes included in dev as of 9-August-2023, so the customization must be removed (“limit_loop_cycle_time”)
    • CustomTypeOne LoopPatches – modified to support recent dev changes: no longer include switcher patch or negative IOB patch (“customtypeone_looppatches”)
    • Algorithm Experiments are included in dev and show as incompatible – this is normal
      • If your build_loop.yml has (“pr1988”) or (“pr2008”) as choices-those must be removed before running the Action to Build Loop again

    Apple Updates

    What are the latest “tested” versions?

    The Version of macOS and Xcode that you need are based upon your phone’s iOS.  These Versions have been tested to operate and build Loop.

    • iOS 17.0 released 18 September 2023 (requires Xcode 15.0)
      • Best practice is to wait when there is a major iOS release
      • Released Loop version updated to 3.2.3 to accomodate Xcode 15, dev branch already worked
      • The Loop widget isn’t working with iOS 17.0.x and Loop 3.2.3.  If this feature is important to you, please wait to update to iOS 17.0.x
    • iOS 16.6.1 released on 7 September 2023 (requires Xcode 14.3).
    • iOS 15.7.9, released on 11 September 2023
    • Xcode 14.3.1 released on 1 June 2023, which requires macOS Ventura 13.0 or greater
    • macOS Ventura 13.5.2  on 7 September 2023

    iOS 15.7.x is the only option available for iPhone 6s, 7, or 1st generation SE.  Newer devices can choose which operating system they prefer.

    Note: When we refer to a version and include “x” in its name, we’re referring to any release of that version of iOS, macOS, or Xcode.  When we describe specific versions, as in the case below for the specific versions of Xcode that will build to an iOS 15.7 device, we mean those very specific versions.

    Important for Loopers on Loop-2.2.x and FreeAPS (as well as iAPS) using Omnipod

    A bug in Loop-2.2.x and FreeAPS (as well as iAPS) can cause your pod and CGM’s transmitter ID to revert to your prior pod and CGM transmitter ID.  If this happens to you, you can easily update your transmitter ID from within the Loop app, but sadly, you’d need to replace your pod.  This bug has been fixed in Loop 3.x.

    Do I need to rebuild before I update my phone iOS?

    Be prepared to rebuild whenever you update your phone iOS – especially for major updates. Whether you need to rebuild first depends upon which iOS you are upgrading from and your build method:

    • For Mac-Xcode build method, update your macOS and Xcode before you update your phone iOS
    • If your Mac can’t update to macOS 13.x or higher, use the Browser Build method

    Mac-Xcode Builders Only

    Loop 3.2.3 was released on 19 September 2023 to allow you to build with Xcode 15 (required by iOS 17).

    Should I update to iOS17.0 or higher?

    Best practice is to wait a bit before accepting a major iOS upgrade on your looping phone.  

    Your Mac must be capable of running macOS 13.5 Ventura or greater.

    How to build Loop to an iOS 17.0 or higher phone

    1. Update your macOS to Ventura 13.5 or greater
    2. Download Xcode 15.0 or greater
    3. Use the Build Select Script to download fresh Loop code and rebuild

    Developer Mode

    When updating your phone to iOS 16 or your watch to watchOS 9, you will be prompted to enable (in Settings) and accept (after reboot) Developer Mode. If you do not do this, Loop (or any app installed from Xcode) will not run.  Once Developer Mode is enabled, Loop will continue running without the need to rebuild. 

    If you try to build Loop and plug in an iOS 16 or 17 phone into your mac without having Developer Mode turned on, you get ‘unavailable device’ in Xcode.  

    iOS 15.7.x

    If you have an iPhone 6s, 7, or 1st generation SE, iOS 15.7 is all that shows up as available.  Apple has announced they will not support those phones with iOS 16.  But you can still build Loop with iOS 15.x and those phones.

    Should I update to iOS 15.7.x?

    Only if your mac is capable of running macOS Monterey and you have Xcode 13.4.1 or 14.0.1 or higher.   Avoid using Xcode 14.0 because Loop CANNOT be built the first time after updating to iOS 15.7.x.

    Our best advice is to update your macOS and Xcode before updating your phone’s iOS, but, if you’ve already updated your phone to 15.7.x …

    How to build Loop to an iOS 15.7.x phone

    1. Update your macOS to Monterey or greater
    2. Download Xcode 13.4.1 or Xcode 14.0.1 or higher
    3. Use the Build Select Script to download fresh Loop code and rebuild


    What about older versions of iOS?

    To see what version of macOS and Xcode will work with your older iOS, check out LoopDocs.

    Turn off auto-update

    Do not set your Loop phone to auto-update the iOS version when using Mac-Xcode build. 

    In iPhone Settings, go to General / Software Update / Automatic Updates.

    1. Turn on “Automatic Downloads”
    2. Turn off “Automatic Updates”

    Once you upgrade the iOS, it can be very difficult (sometimes impossible) to downgrade.

    It’s a good idea to do the same on your computer.  Both the operating system and Xcode should have auto-update turned off. But please, update as soon as the all-clear is sounded.  Updates can provide very important security fixes as well as nifty new features.

    More Information

    You should always be in a position to build Loop, if necessary. The best practice is to upgrade your build computer (Mac) before upgrading the iOS on your iPhone.  Of course, that’s your choice.

    Bookmark this page!  {DO THIS NOW!} Come back when you have a version question in the future.

    This page will be kept up-to-date as new versions are released.  You can also sign up for the newsletter, but new version updates may not always be included in the newsletter.  This page is your best “one-stop shop” to answer general questions about versions and compatability.

    Skip to content