AndroidAPS screens

The Homescreen

Homescreen V2.1

This is the first screen you will come across when you open AndroidAPS and it contains most of the information that you will need day to day.

Section A

  • navigate between the various AndroidAPS modules by swiping left or right

Section B

  • change the loop status (open loop, closed loop, suspend loop etc)
  • see your current profile and do a profile switch
  • see your current target blood glucose level and set a temporary target.

Long press on any of the buttons to alter the setting. I.e long press the target bar in the upper right (“110” in the screenshot above) to set a temp target.

Section C

  • latest blood glucose reading from your CGM
  • how long ago it was read
  • changes in the last 15 and 40 minutes
  • your current basal rate - including any temporary basal rate (TBR) programmed by the system
  • insulin on board (IOB)
  • carbs on board (COB)

The optional status lights (CAN | INS | RES | SEN | BAT) give a visual warning for low reservoir and battery level as well as overdue site change.

The insulin on board figure would be zero if just your standard basal was running and there was no insulin remaining from previous boluses. The figures in brackets show how much consists of insulin remaining from previous boluses and how much is a basal variation due to previous TBRs programmed by AAPS. This second component may be negative if there have recently been periods of reduced basal.

Section D

Click the arrow on the right side of the screen in section D to select which information is displayed on the charts below.

Section E

Is the graph showing your blood glucose (BG) as read from your glucose monitor (CGM) it also shows Nightscout notifications such as fingerstick calibrations, and carbs entries.

Long press on the graph to change the time scale. You can choose 6, 8, 12, 18 or 24 hours.

The extended lines show the predicted BG calculations and trends - if you have it selected.

  • Orange line: COB (colour is used generally to represent COB and carbs)
  • Dark blue line: IOB (colour is used generally to represent IOB and insulin)
  • Light blue line: zero-temp
  • Dark yellow line: UAM

These lines show you the different predictions based on current carb absorption (COB); insulin only (IOB); showing how long it will take BG to level off at/above target if deviations suddenly cease and we run a zero temp until then (zero-temp) and unannounced meal/effect detection where carbs are detected but have not been entered into the system by the user (UAM).

The solid blue line shows the basal delivery of your pump. The dotted blue line is what the basal rate would be if there were no temporary basal adjustments (TBRs) and the solid blue line is the actual delivery over time.

Section F

This section also configurable using the options in section D. In this example we are showing the IoB (Insulin on Board) - if there were no TBRs and no remaining boluses this would be zero, the sensitivity, and the deviation. GREY bars show a deviation due to carbs, GREEN that BG is higher than the algorithm expected it to be and RED that it is lower than the algorithm expected.

Section G

Enables you to administer a bolus (normally you would use the Calculator button to do this) and to add a fingerstick CGM calibration. Also a Quick Wizzard button would be displayed here if configured in Config Builder.

The Calculator


When you want to make a meal bolus this is where you will normally make it from.

Section A

contains is where you input the information about the bolus that you want. The BG field is normally already populated with the latest reading from your CGM. If you don’t have a working CGM then it will be blank. In the CARBS field you add your estimate of the amount of carbs - or equivalent - that you want to bolus for. The CORR field is if you want to modify the end dosage for some reason, and the CARB TIME field is for pre-bolusing so you can tell the system that there will be a delay before the carbs are to be expected and the bolus will be delayed. You can put a negative number in this field if you are bolusing for past carbs.

SUPER BOLUS is where the basal insulin for the next two hours is added to the immediate bolus and a zero TBR is issued for the following two hours to take back the extra insulin. The idea is to deliver the insulin sooner and hopefully reduce spikes.

Section B

shows the calculated bolus. If the amount of insulin on board already exceeds the calculated bolus then it will just display the amount of carbs still required.

Section C

shows the various elements that have been used to calculate the bolus. You can deselect any that you do not want to include but you normally wouldn’t want to.

Combinations of COB and IOB and what they mean

  • If you tick COB and IOB unabsorbed carbs that are not already covered with insulin + all insulin that has been delivered as TBR or SMB will be taken into account
  • If you tick COB without IOB you run the risk of too much insulin as AAPS is not accounting for what’s already given.
  • If you tick IOB without COB, AAPS takes account of already delivered insulin but won’t cover that off against any carbs still to be absorbed. This leads to a 'missing carbs' notice.

If you bolus for additional food shortly after a meal bolus (i.e. additional desert) it can be helpful to untick all boxes. This way just the new carbs are being added as the main meal won’t necessarily be absorbed so IOB won’t match COB accurately shortly after a meal bolus.

Slow carb absorption

As of version 2.4, AAPS warns if slow carb absorption is detected. There will be an additional text on the confirmation screen after calculator usage. The risk is that COB would be overestimated and to much insulin might be given.

Slow carb absorption

In this example 41% of time min_5m_carbimpact was used instead of value calculated from deviations.

In this case you should think about pressing “Cancel” and calculate again with COB unticked. If from your manual calculation you see the need for a correction bolus enter it manually. But be careful not to overdose!

Insulin Profile

Insulin Profile

This shows the activity profile of the insulin you have chosen. The PURPLE line shows how much insulin remains after it has been injected as it decays with time and the BLUE line shows how active it is.

You will normally be using one of the Oref profiles - and the important thing to note is that the decay has a long tail. If you have been used to manual pumping you have probably been used to assuming that insulin decays over about 3.5 hours. However, when you are looping the long tail matters as the calculations are far more precise and these small amounts add up when they are subjected to the recursive calculations in the AndroidAPS algorithm.

For a more detailed discussion of the different types of insulin, their activity profiles and why all this matters you can read an article here on Understanding the New IOB Curves Based on Exponential Activity Curves

And you can read an excellent blog article about it here: Why we are regularly wrong in the duration of insulin action (DIA) times we use, and why it matters…

And more at: Exponential Insulin Curves + Fiasp

Pump Status

Pump Status

Here we see the status of the insulin pump - in this case an Accu-Chek Combo. The information displayed is self explanatory. A long press on the HISTORY button will read the data from your pump history, including your basal profile. But remember only one basal profile is supported on the Combo pump.

Care Portal

Care Portal

This replicates the functions you will find on your Nightscout screen under the “+” symbol which allows you to add notes to your records. Functions such as recording when you change a pump site, or insulin cartridge should be self explanatory. BUT this section does not issue any commands to your pump. So if you add a bolus using this screen it simply makes a note of this on your Nightscout record, the pump won’t be instructed to deliver a bolus.

Loop, MA, AMA, SMB

You don’t normally need to worry about these, they show the results of the OpenAPS algorithm which runs each time the system gets a fresh reading from the CGM. These are discussed elsewhere.



AndroidAPS can run using a number of different profile configuratons. Typically - as shown here - the Nightscout profile has been downloaded via the built in Nighscout client and is displayed here in read-only form. If you wanted to make any changes you would do this from your Nightscout user interface and then do a Profile Switch in AndroidAPS to activate the changes. Data such as the basal profile would then be automatically copied over to your pump.

DIA: stands for Duration of Insulin Action and it is discussed above in the section on insulin profiles.

IC: is Insulin to Carb ratio. This profile has a number of different values set for different times of day.

ISF: is Insulin Sensitivity Factor - the amount by which one unit of insulin will reduce your blood glucose assuming that nothing else changes.

Basal: is the basal profile programmed into your pump.

Target: is the blood glucose level that you want the rig to be aiming for all the time. You can set different levels for differenttimes of day if you wish, and you can even set an upper and lower range so that the rig will only start to make changes when the predicted blood glucose value falls outside, but if you do that then the rig will respond more slowly and you are unlikely to achieve such stable blood sugars.

Treatment, xDrip, NSClient

These are simply logs of treatments (boluses and carbs), xDrip messages and messages sent to Nightscout via the built-in Nightscout client. You don’t normally need to worry about any of these unless there is a problem.

Config Builder

Config Builder

This is where you will set up the configuraton of your AndroidAPS rig. This screenshot shows a pretty typical rig using a Combo pump, a Dexcom G5 CGM sensor being managed via xDrip+ and running with NovoRapid insulin on an Oref profile and connected to a Nightscout cloud based server.

The tick box on the right determines if that particular module will be displayed in the top menu bar (see section A at Homescreen) and the small gear wheel symbol allows access to the setting for that module, if there are any.

Settings and Preferences

At the top right of the navigation bar you will find three small vertical dots. Pressing on these takes you to the app’s preferences, history browser, setup wizard, about the app information and the exit button that will close AAPS.