Skip to content

Customize using Browser


This page is only relevant when building with a browser.

For Mac, please see: Customize with Mac

For new Loopers, please build the code before you make any changes. Start with Open Loop and familiarize yourself with the interface. Later, you can make the customization(s) you desire and build again. The second build will be much easier than your first build.

These customizations require you to modify the code used to build the Loop app and then build the app again with the modified code.

You take responsibility

You are responsible when you decide to use customizations.

Be sure to report what changes you made if you need to ask for assistance with your app.

Customizations Prepared for You

Some customizations are the same for everyone and have been prepared for easy use.

The Loop and Learn team commits to maintaining these prepared customizations and provides an easy method to add your selection from these customizations to your version of Loop.

Please read the documentation for these on the Loop and Learn: Customization Select Page:

  • List of Customizations Available
  • When building using a browser you will be modifying one of the special files that enable the GitHub action to build the Loop app. This file is called the build_loop.yml file and can be located at your fork of your LoopWorkspace repository. There are several sections you need to review on the Loop and Learn page:

Add Libre Support to 3.2.3

If you are using main branch to build Loop 3.2.3 and rely on either xDrip4iOS or GlucoseDirect to read your CGM and transfer the readings to the Loop app, you need to review this section of the Loop and Learn customization page.

Alternatively, you can switch to the dev branch, which already supports Libre. Build Loop dev with Browser

Personal Customizations

Some customizations must be created for yourself. These are of two basic types: Custom Edits and Build-Time Flag.

The information needed to modify the code to make these customizations is found in the Versions tab because the information is independent of build method (think of these as your personal versions). The links are found below.

  • Version: Custom Edits
    • The page linked above indicates how you can modify behavior by editing the code
  • Version: Build-Time Flag
    • By enabling or disabling features controlled by a Build-Time Flag, you are turning on or off features included in the code by the developers that they configured to be off or on by default
    • Please read about these flags on the page linked above

When preparing these personal edits using a browser, there is a page explaining how to get these edits into your personal fork of LoopWorkspace prior to building.

The code changes required for these customizations are the same regardless of the build method. The pages that provide the documentation on modifying and incorporating these changes are found at the links above.