Mac-Xcode Build: Customize your Loop app
Customizations are the way to create your own personalized Loop app. This page explains how to customize your Loop app using the Mac-Xcode Build for prepared customizations that are available in the Customization Select script. Learn more about other customization options by clicking the links above.
To customize your Mac-Xcode built Loop app:
What is the Customization Select script?
What is the Customization Select script?
The Customization Select script is a series of commands that are grouped together and issued for you. The script automatically locates the most recent download of Loop in the Downloads/BuildLoop folder on your Mac, allows you to customize that download and opens Xcode for you when you are done. As you select your customization options, you will be informed which customizations are already applied, which ones cannot be applied, and which ones are available.
How do I Access the Customization Select script?
There are two easy ways to access the Customization Select script:
- Indirectly (for a fresh build)
- Build Select script
- Paste the command into any terminal window
- Download the latest Loop code
- Build Loop in Xcode to a simulator phone
- Return to terminal, select Option 4) Customization Select
- Chosen customizations will be applied to this Loop download
- Directly (for either a recent or fresh build)
- Customization Select script
- Paste the command into any terminal window
- Chosen customizations will be applied to your most recent Loop download
How do I use the Customization Select script?
Regardless of how you access the Customization Select script, the customization options are the same.
- Choose your customizations one at a time
- To apply a customization, type the number associated with that customization and enter.
- The Customization Select script checks the result of each command and displays a success message and continues or pauses with a warning message if you need to take action.
- Do not worry if the green (success) message scrolls past too quickly for you to read.
- The script will stop with a warning message if there was a problem, and will wait for you to acknowledge the message.
- You can choose as many customizations as desired.
When you’ve finished adding customizations, build your customized version of Loop in Xcode. At the bottom of the list, you have fixed numbers that you type and enter to select:
- 40: To remove a customization (only shown if customizations have been applied)
- 45: To update a customization (only shown if an update is available)
- 50: Exit Script (or return to Build Select Script menu)
- 60: Exit Script and open Xcode
When you’re ready, type 60 and press return to exit the script and open Xcode to build your customized version of Loop.
Repeat this process each time that you update your Loop app.
Loop Customization Select Script
You can run the Loop Customization Select Script by pasting the line below into a terminal window on your Mac and following the menu instructions.
Click on the line below to copy it. You’ll see Copied to Clipboard briefly.
The numbers and items in this image are not always up-to-date. The complete list is available here.
Read the instructions in the terminal screen.
- The terminal window was made taller than the default by dragging the lower right corner
- It is much easier to navigate when you can see all the information in one view
- You can also increase or decrease the font size by holding down the Cmd key and typing + or –
Special Case: Customize a Specific Download
This is not typical, but there are people who might have more than one copy of Loop on their computer and want to customize a specific version. These people will know how to follow these steps. The rest of you can ignore this section.
Before starting the script
- Navigate to the desired LoopWorkspace folder in the terminal
- Start the Customization Script in the terminal in that folder
- Once the script starts, make sure the folder reported is the one you want