Welcome to the AAPS documentation
AAPS is an open source app for people living with insulin-dependent diabetes that acts as an artificial pancreas system (APS) on Google Android smartphones. The main components are different openAPS software algorithms which aim to do what a living pancreas does: keeping blood sugar levels within healthy limits by using automated insulin dosing (AID). Additionally, you need at least a supported and FDA/CE approved insulin pump and continuous glucose meter.
The app does not use self-learning artificial intelligence. Instead, the calculations of AAPS are based on the individual dosage algorithm and carbohydrate intake the user manually puts into their treatments profile, but they are verified by the system for safety reasons.
The app is not provided in Google Play - you have to build it from source code by yourself for legal reasons.
Ask for help - Writing Docs
Please don’t be shy, we urgently need support in creating the documentation.
A pull request to edit the documentation is relatively simple to create. You can’t break anything. There are release procedures.
A 3 minute video which explains how to edit the docs via PR is available here.
How to read the documentation?
We have provided this subsection of the documentation especially for those who are new to concept of Do-It-Yourself-APS (Artificial-Pancreas-Systems) in order to best show how to get acquainted with the information we consider to be the most important, especially in terms of understanding the reasons behind the «limits» set in place when you are first beginning your AAPS journey. These safety limits have been developed over many years by observations of the inadvertent mistakes that new users are most likely to make when first learning to set up, build, and then successfully loop with AAPS - as most often those mistakes occur simply because the user was so excited to get started using the system that they may have forgotten to sit down and dedicate the time needed to understand the information within this documentation thoroughly. We have all been there!
Certainly the approach, «read everything» has merit and is certainly true. However, it is not uncommon for newcomers to quickly become overwhelmed by the sheer volume and variety of new information that they are expected to understand all at once! So these next few subsections are meant to lay out the most important foundations of the knowledge necessary to successfully run your own chosen setup with as few hiccups as is possible. New users can refer back to this guide when they run into aspects of the system they are not yet familiar with; and to remind themselves where to go within the Documentation in order to locate more in-depth information, as needed. It is also important to lay out the capabilities of AAPS in an up-front manner, as sometimes it can be disappointing to discover in the middle of reading the documentation that certain necessary tools are currently not available for use (due to constraints on which types of insulin pumps or CGMs are available in some countries vs. other countries etc.) or simply offers less/different functionality than first assumed. Finally, it is important to acknowledge that many experience-related aspects inside this documentation only become pertinent as you begin to use AAPS in real-time. Just as it is nearly impossible to learn to play a sport perfectly just by reading about the rules, it takes a combination of first learning the foundations of the rules for safely operating AAPS and then committing the time learning how best to apply those rules as you navigate through the steps of looping with AAPS.
The Getting started subsection is a must read to understand the general concept of what an artificial pancreas system is designed to do; and is especially pertinent for users of AAPS.
The subsection What do I need? specifies the CGMs (Continuous Glucose Monitors) and insulin pumps which are are available for use with AAPS. This subsection is important to understand so that your AAPS system can be assembled and built correctly the first time around and will function well in real world situations.
The subsection Where to go for help? should help direct you to the best places to go to find help depending upon your levels of experience with AAPS. This is very important so that you don’t feel left out, especially at the beginning, and so that you can get in touch with others as quickly as possible, clarify questions and solve the usual pitfalls as quickly as possible. Experience shows that a lot of people are already using AAPS successfully, but everyone has a question at some point that they couldn’t solve on their own. The nice thing is, however, that due to the large number of users, the response times to questions are usually very quick, typically only a few hours. Don’t worry about requesting help, as there is no such thing as a dumb question! We encourage users of any/all levels of experience to ask as many questions as they feel is necessary to help get them up and running safely. Just try it out please.
In the subsection Glossary we have compiled a list of the acronyms (or short-term names) used throughout AAPS. For example, where to go to find out what the terms ISF or TT, stand for in in the more common (longer) terms.
For parents who want to build AAPS for their children, we recommend the subsection AAPS for children , as there you will find more advanced information specifically tailored for learning the extra steps necessary in order to remotely control your child’s AAPS app as well as a more comprehensive safety profile as compared to adults. You need to be able to support your children and understand the all the advanced concepts that AAPS offers to help you succeed.
Now that you have a solid understanding of the concepts that AAPS uses, know where to go for the the necessary tools to build your APS and are familiar with where to get help in case of an emergency, it is the right time to start building the app! The subsection How to install AAPS? shows you this in detail. Since the requirements are very different from anything you might have set up in the past, we recommend that you really follow the instructions, step-by-step the first few times you build the app, so that you have a stronger sense of how the app building process is supposed to behave when all directions are followed exactly. Please remember to take your time. Later this will go very quickly when you build the app again for a new version. That way you will have a greater chance of noticing when something doesn’t going as planned before too many steps are out of line. It is important to save the your keystore file (.jks file used to sign your app) in a safe place, so that you can always use that exact same keystore file and password each and every time you are asked to create a new updated version of AAPS, as this file is what makes sure that each new version of the app «remembers» all the information that you have provided to it in previous versions of the app and thus ensure that the updates will go as smoothly as possible. On average, you can assume that there will be one new version and 2-3 required updates per year. This number is based on experience and may change in the future. But we do want to at least give you a general guideline on what to expect. When you are more experienced at building updated AAPS app versions all the steps that are required in building an updated app will only take 15-30 minutes, on average. However, in the beginning there can be a rather steep learning curve as these steps are not always considered intuitive by new users! So do not get frustrated if you find that it takes half a day or a whole day with some help from the community before you are finally finished with the update process. If you find that you are getting very frustrated just take a short break, and oftentimes; after a stroll around the block or two…you’ll find that you are better able to approach the problem again. We have also compiled a list of questions and answers to most of the typical errors that are likely to occur the first few updates located within the FAQs section; as well as within «How to install AAPS?» that provides additional information in the subsection «Troubleshooting».
The subsection Component Setup explains how to properly integrate each of the various different separate component parts into AAPS, as well as how to set them up to work as seamlessly as possible together. All components are listed under the separate sections: CGM/FGM, xDrip Settings, Pumps, Phones, Nightscout setup, and Smartwatches. The sensor (BG) values and control of the insulin pump are particularly important information to understand. The subsection Configuration describes the best pump configurations to use in AAPS.
This is followed by a particularly important subsection AAPS Usage, in which you are slowly introduced to the full usage of what AAPS has to offer via a safe and carefully calibrated step-by-step gradual process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, each commonly referred to as the next Objective, until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of AAPS and switch from Open Loop to Closed Loop.
After that there is a subsection General Hints with e.g. information on how to deal with the crossing of time zones as well as knowing what to do during the Spring Forward - Fall Back daylight saving time changes which will occur twice a year while using AAPS.
There is a subsection for the clinicians who have expressed interest in open source artificial pancreas technology such as AAPS, or for patients who want to share such information with their clinicians.
Finally, in the subsection How to help? we would like to provide you with information so that you are able to suggest small or larger changes to the documentation yourself and work together with us on the documentation. We further need support for translation of the documentation By the way, it also very helpful for everyone if you could provide links to the corresponding documentation (or screenshots of where the links are located within the Documentation if you are not familiar with how to send a link) when answering questions from other users. That way the correct information can easily be located again should other users also be trying to find answers to the same types of questions in the future.
Ask for help - Translators Neeeded!!!
The documentation is written in English and translated in different languages. We are searching help by the translation of a) the app and b) the documentation.
The translation process is explained here.
The state of the translations per language for app and documentation can be found here.
Change language
Getting started
- Safety first
- What is a closed loop system
- What is a closed loop system with AAPS
- Docs updates & changes
- February 2022
- January 2022
- December 2021
- November 2021
- October 2021
- September 2021
- June 2021
- April 2021
- March 2021
- February 2021
- January 2021
- December 2020
- Octubre 2020
- Septiembre 2020
- June 2020
- May 2020
- April 2020
- March 2020
- February 2020
- January 2020
- Diciembre 2019
- Noviembre 2019
- Octubre 2019
- Septiembre 2019
- Agosto 2019
What do I need
How to Install AAPS
- Building the APK
- Construyela tú mismo en lugar de descargarla
- Notas importantes
- Configuraciones de equipos recomendadas para generar el archivo apk
- Inicio
- Step by step walkthrough
- Instalar git (si no lo tienes ya)
- Instalar Android Studio
- Set git path in preferences
- Download AAPS code
- Descargar Android SDK
- Generar APK firmado
- Transferir APK a smartphone
- Solución de problemas
- Actualizar a una nueva versión o rama
- Solución de problemas
- Hints and Checks after update to AAPS 3.0
- Checks after update to AAPS 2.7
- Install git
- Troubleshooting Android Studio
- Perdida de almacén de claves
- Gradle Sync failed
- Generate Signed APK generated successfully with 0 build variants
- App was created with compiler/kotlin warnings
- Key was created with errors
- No CGM data is received by AndroidAPS
- App not installed
- App installed but old version
- None of the above worked
- Worst case scenario
- Release notes
- Versión de Android y versión de AAPS
- Versión 3.2.0
- Versión 3.1.0
- Versión 3.0.0
- Versión 2.8.2
- Versión 2.8.1.1
- Versión 2.8.0
- Versión 2.7.0
- Versión 2.6.1.4
- Versión 2.6.1.3
- Versión 2.6.1.2
- Versión 2.6.1.1
- Versión 2.6.1
- Versión 2.6.0
- Versión 2.5.1
- Versión 2.5.0
- Versión 2.3
- Versión 2.2.2
- Versión 2.2
- Versión 2.1
- Versión 2.0
- Dev branch
Component Setup
- CGM/FGM
- xDrip Settings
- Configuración básica para todos los medidores contínuos (CGM), sistemas CGM puros o sistemas flash (FGM)
- xDrip+ & Dexcom G6
- La versión de xDrip+ a utilizar depende del número de serie de los transmisores G6.
- Ajustes específicos de Dexcom
- No se recomiendan reinicios preventivos
- Conectar el transmisor G6 por primera vez
- Estado de la batería de Transmisor
- Extender vida del transmisor
- Sustituir transmisor
- Nuevo Sensor
- Recuperar código de sensor
- Solución de problemas de Dexcom G5/G6 y xDrip+
- xDrip+ & Freestyle Libre
- Pump choices
- Phones
- Nightscout setup
- Smartwatch
Configuration
- Config builder
- Pestañas o menú de hamburguesa
- Perfil
- Insulina
- Fuentes de BG (datos de glucemia)
- Bomba
- Detección de sensibilidad
- APS
- Loop
- Objetivos (programa de aprendizaje)
- Tratamientos
- General
- Preferences
- General
- Inicio
- Treatment safety
- Loop
- Advanced Meal Assist (AMA) or Super Micro Bolus (SMB)
- Ajustes absorción
- Configuración de la bomba
- NSClient
- Comunicaciones SMS
- Automatización
- Alarma local
- Data choices
- Maintenance settings
- Open Humans
AAPS Usage
- AAPS screens
- Pantalla de inicio
- Asistente de bolo (Calculadora)
- Pestaña de Acciones
- Perfil de Insulina
- Estado de la bomba de insulina
- Portal de cuidados (Care Portal)
- Loop, AMA o SMB
- Perfil
- Tratamiento
- Origen de glucosa - xDrip+, Dexcom (BYODA),…
- NSClient
- Objectives
- Objetivo 1: Establecimiento de la visualización y la supervisión, análisis de las basales y las tasas
- Objetivo 2: Aprender a controlar AndroidAPS
- Objetivo 3: Demuestra tus conocimientos
- Objetivo 4: Iniciar en un lazo abierto
- Objetivo 5: Comprensión de su lazo abierto, incluidas sus recomendaciones basales temporales
- Objetivo 6: Empezando a cerrar el lazo con Baja Glucosa Suspender
- Objective 7: Tuning the closed loop, raising maxIOB above 0 and gradually lowering BG targets
- Objetivo 8: ajustar las basales y proporciones si es necesario, y luego habilitar el autosensado
- Objective 9: Enabling additional oref1 features for daytime use, such as super micro bolus (SMB)
- Objective 10: Automation
- Go back in objectives
- Objectives in Android APS before version 3.0
- OpenAPS features
- Autosens
- Super Micro Bolo (SMB)
- Max U/h una basal temporal puede establecerse en (OpenAPS “max-basal”)
- El número máximo de IOB que OpenAPS no puede sobrepasar (OpenAPS «max-iob»)
- Enable AMA Autosens
- Activar SMB
- Habilitar SMB con COB
- Habilitar SMB con Objetivos Temporales
- Habilitar SMB con Objetivo Temporal Alto
- Habilitar SMB siempre
- Habilitar SMB después de Carbohidratos
- Minutos máximos de basal para limitar SMB
- Activar UAM
- Objetivo temporal elevado aumenta la sensibilidad
- Objetivo temporal bajo reduce la sensibilidad
- Ajustes avanzados
- Asistente de comida avanzada (AMA)
- Overview of hard-coded limits
- COB calculation
- Sensitivity detection
- Profile switch
- Temp-targets
- Extended carbs
- Automation
- Autotune (dev only)
- Careportal (discontinued)
- Open Humans Uploader
- Automation with 3rd party apps
- Aplicación Automate de Android
- Requisitos básicos
- Ejemplos de flujo de trabajo
- Ejemplo 1: Si se detecta la actividad (por ejemplo, caminar o correr), establezcer un TT alto. Y si la actividad termina, entonces espere 20 minutos y luego cancele la TT
- Ejemplo 2: Si xDrip+ da una alarma BG alta, entonces se establece un bajo TT para … minutos.
- Ejemplo 3: Para ser añadido por ti!!!
- Si esto, entonces eso (IFTTT)
- Aplicación Automate de Android
- Android auto
General Hints
- Zona horaria viajando con bombas
- Ajuste horario de verano (DST)
- Accessing logfiles
- Accu-Chek Combo tips for basic usage
- Export/Import Settings
- xDrip engineering mode
AAPS for children
Troubleshooting
FAQ
- Preguntas frecuentes para loopers
- General
- AAPS settings
- Algoritmo APS
- Otros ajustes
- Frequent questions on Discord and their answers…
- My problem is not listed here.
- My problem is not listed here but I found the solution
- AAPS stops everyday around the same time.
- How to organize my backups ?
- I have problems, errors building the app.
- I’m stuck on an objective and need help.
- How to reset the password in AAPS v2.8.x ?
- How to reset the password in AAPS v3.x
- My link/pump/pod is unresponsive (RL/OL/EmaLink…)
- Build error: file name too long
- Alert: Running dev version. Closed loop is disabled
- Where can I find settings files?
- How to configure battery savings?
- Pump unreachable alerts several times a day or at night.
- Where can I delete treatments in AAPS v3 ?
- Configuring and Using the NSClient remote app
- I have a red triangle / AAPS won’t enable closed loop / Loops stays in LGS / I have a yellow triangle
- Can I move an active DASH Pod to other hardware?
- Procedure I follow in this:
- How do I import settings from earlier versions of AAPS into AAPS v3 ?
Glossary
Where to go for help
- Useful resources to read before you start
- Where to go for help
- Docs updates & changes
- February 2022
- January 2022
- December 2021
- November 2021
- October 2021
- September 2021
- June 2021
- April 2021
- March 2021
- February 2021
- January 2021
- December 2020
- Octubre 2020
- Septiembre 2020
- June 2020
- May 2020
- April 2020
- March 2020
- February 2020
- January 2020
- Diciembre 2019
- Noviembre 2019
- Octubre 2019
- Septiembre 2019
- Agosto 2019
For Clinicians
- For Clinicians
- The steps for building a DIY Closed Loop:
- How A DIY Closed Loop Works
- How data is gathered:
- How does it know what to do?
- Examples of AndroidAPS algorithm decision making:
- Here are examples of the purple prediction lines, and how they might differ:
- Here are examples of different time frames that influence the needed adjustments to insulin delivery:
- Scenario 1 - Zero Temp for safety
- Scenario 2 - Zero temp for safety
- Scenario 3 - More insulin needed
- Scenario 4 - Low temping for safety
- Optimizing settings and making changes
- OpenAPS
- Summary
How to help
Nota
Disclaimer And Warning
All information, thought, and code described here is intended for informational and educational purposes only. Actualmente Nightscout no dispone de HIPAA privacy compliance. Use Nightscout and AAPS at your own risk, and do not use the information or code to make medical decisions.
Use of code from github.com is without warranty or formal support of any kind. Por favor revise el repositorio de Licencia para más detalles.
All product and company names, trademarks, servicemarks, registered trademarks, and registered servicemarks are the property of their respective holders. Su uso aquí es informativo y no implica afiliación o pago por ello.
Please note - this project has no association with and is not endorsed by: SOOIL, Dexcom, Accu-Chek, Roche Diabetes Care or Medtronic