Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
152 lines (117 sloc) 9.06 KB

Bienvenue sur la documentation d'AndroidAPS



The foundation of AndroidAPS safety features discussed in this documentation is built on the safety features of the hardware used to build your system. It is critically important that you only use a tested, fully functioning FDA or CE approved insulin pump and CGM for closing an automated insulin dosing loop. Hardware or software modifications to these components can cause unexpected insulin dosing, causing significant risk to the user. If you find or get offered broken, modified or self-made insulin pumps or CGM receivers, do not use these for creating an AndroidAPS system.

Additionally, it is equally important to only use original supplies such as inserters, cannulas and insulin containers approved by the manufacturer for use with your pump or CGM. Using untested or modified supplies can cause CGM inaccuracy and insulin dosing errors. Insulin is highly dangerous when misdosed - please do not play with your life by hacking with your supplies.


Disclaimer And Warning

  • All information, thought, and code described here is intended for informational and educational purposes only. Nightscout currently makes no attempt at HIPAA privacy compliance. Use Nightscout and AndroidAPS at your own risk, and do not use the information or code to make medical decisions.
  • Use of code from is without warranty or formal support of any kind. Please review this repository's LICENSE for details.
  • All product and company names, trademarks, servicemarks, registered trademarks, and registered servicemarks are the property of their respective holders. Their use is for information purposes and does not imply any affiliation with or endorsement by them.

Please note - this project has no association with and is not endorsed by: SOOIL, Dexcom, Accu-Chek, Roche Diabetes Care.

What is AndroidAPS?

AndroidAPS is a app that acts as an artificial pancreas system (APS) on an Android smartphone. What is an artificial pancreas system? It is a software program that aims to do what a living pancreas does: keep blood sugar levels within healthy limits automatically. An APS can't do the job as well as a biological pancreas does, but it can make type 1 diabetes easier to manage using devices that are commercially available and software that is simple and safe. Those devices include a continuous glucose monitor (CGM) to tell AndroidAPS about your blood sugar levels and an insulin pump which AndroidAPS controls to deliver appropriate doses of insulin. The app communicates with those devices via bluetooth. It makes its dosing calculations using an algorithm, or set of rules, developed for another artificial pancreas system, called OpenAPS, which has thousands of users and has accumulated millions of hours of use.

A note of caution: AndroidAPS is not regulated by any medical authority in any country. Using AndroidAPS is essentially carrying out a medical experiment on yourself. Setting up the system requires determination and technical knowledge. If you don't have the technical know-how at the beginning, you will by the end. All the information you need can be found in these documents, elsewhere online, or from others who have already done it -- you can ask them in Facebook groups or other forums. Many people have successfully built AndroidAPS and are now using it entirely safely, but it is essential that every user:

  • Builds the system themselves so that they thoroughly understand how it works
  • Adjusts the settings to suit their own diabetes
  • Maintains and monitors the system to ensure it is working properly

If you're ready for the challenge, please read on.

Primary goals behind AndroidAPS:

  • An app with safety built in. To read about the safety features of the algorithms, known as oref0 and oref1, click here (
  • An all-in-one app for managing type 1 diabetes with an artificial pancreas and Nightscout
  • An app to which users can easily add or remove modules as needed
  • An app with different versions for specific locations and languages.
  • An app which can be used in open- and closed-loop mode
  • An app that is totally transparent: users can input parameters, see results, and make the final decision
  • An app which is independent of particular pump drivers and contains a "virtual pump" so users can safely experiment before using it on themselves
  • An app closely integrated with Nightscout
  • An app in which the user is in control of safety constraints

What you need to get started:

  • An Android smartphone with Android 5.0 or later. Please update to Android 6 or higher as it is planned to drop support for Android 5.x soon. See this spreadsheet to learn which phones work best with AndroidAPS.
  • A continuous clucose monitor (CGM): Dexcom G4/G5/G6, Freestyle Libre, Eversense, Medtronic Guardian, or PocTech
  • An app on the phone to receive CGM data: xDrip/ xDrip+, Glimp , G5 patched app, PochTech app or 600SeriesAndroidUploader
  • AndroidAPS itself installed on the phone
  • Nightscout cgm-remote-monitor 0.10.2 or later
  • A supported pump: Dana-R or Dana-RS from Sooil, or Accu-Chek Combo or Insight from Roche (unless you are able to build your own driver for another insulin pump)

Getting Started with AndroidAPS

.. toctree::
   :maxdepth: 1

   Safety First <./Getting-Started/>
   Screenshots <./Getting-Started/>
   Phones <./Getting-Started/>
   Pump choices <./Getting-Started/>
   Possible future pump drivers  <./Getting-Started/>
   Sample Setup: Samsung S7, Dana-R, Dexcom G5 and Sony Smartwatch <./Getting-Started/>
   FAQ for loopers <./Getting-Started/>
   Glossary <./Getting-Started/>

How to Install AndroidAPS

.. toctree::
   :maxdepth: 1

   Building the APK <./Installing-AndroidAPS/>
   Update to a new version or branch <./Installing-AndroidAPS/>
   Release notes <./Installing-AndroidAPS/>
   Dev branch <./Installing-AndroidAPS/>
   Nightscout setup <./Installing-AndroidAPS/>


.. toctree::
   :maxdepth: 1

   Config Builder <./Configuration/>
   BG Source <./Configuration/>
   Dexcom G6 hints <./Configuration/>
   Dana-R pump <./Configuration/>
   Dana-RS pump <./Configuration/>
   Accu-Chek Combo pump <./Configuration/>
   Accu-Chek Insight pump <./Configuration/>
   Medtronic pump <./Configuration/>
   Watchfaces <./Configuration/>
   Preferences <./Configuration/>
   Sensitivity Detection and COB <./Configuration/>
   xDrip+ settings <./Configuration/>


.. toctree::
   :maxdepth: 1

   Objectives <./Usage/>
   OpenAPS features <./Usage/>
   Profile switch <./Usage/>
   Temp-targets <./Usage/>
   SMS commands <./Usage/>
   Extended Carbs <./Usage/>
   Crossing timezones with pumps <./Usage/>
   Accessing logfiles <./Usage/>
   Smoothing blood glucose data <./Usage/>
   Accu-Chek Combo tips for basic usage <./Usage/>
   Troubleshooting NSClient <./Usage/>
   Android auto <./Usage/>
   Huawei phones special configuration <./Usage/>
   Jelly Pro - battery life optimization <./Usage/>
   Automation <./Usage/>

Where to go for help

.. toctree::
   :maxdepth: 1

   Useful resources to read before you start <./Where-To-Go-For-Help/>
   Where to go for help <./Where-To-Go-For-Help/>

.. toctree::
   :maxdepth: 1
   :caption: Resources/Reference

   Resources <./Resources/index>
   For Clinicians <./Resources/clinician-guide-to-AndroidAPS>

How to help

.. toctree::
   :maxdepth: 1

   How to help <./Getting-Started/>
   How to translate the app <./>
   How to edit the wiki <./make-a-PR>
You can’t perform that action at this time.