# Préférences - **Open preferences** by clicking the three-dot menu on the top right side of the home screen. ![Open preferences](../images/Pref2020_Open2.png) - You can jump directly to preferences for a certain tab (i.e. pump tab) by opening this tab and clicking Plugin preferences. ![Open plugin preferences](../images/Pref2020_OpenPlugin2.png) - **Sub-menus** can be opened by clicking the triangle below the sub-menu title. ![Open submenu](../images/Pref2020_Submenu2.png) - With the **filter** on top of the preferences screen you can quickly access certain preferences. Just start typing part of the text you are looking for. ![Preferences filter](../images/Pref2021_Filter.png) ```{contents} :backlinks: entry :depth: 2 ``` (Preferences-general)= ## General ![Preferences > General](../images/Pref2020_General.png) **Units** - Set units to mmol/l or mg/dl depending on your preferences. **Language** - New option to use phone's default language (recommended). - In case you want **AAPS** in a different language than your standard phone language, you can choose from a broad variety. - If you use different languages, you might sometimes see a language mix. This is due to an android issue where overriding the default android language sometimes doesn't work. - Setting hidden in [simple mode](#preferences-simple-mode). (preferences-simple-mode)= **Simple mode** The **simple mode** is activated by default when you first install **AAPS**. In **simple mode**, a significant amount of settings is hidden and preferences are replaced by predefined values. [Additional graphs](#AapsScreens-section-g-additional-graphs) on the HomePage are also predefined for you. You should switch off Simple mode once you become familiar with **AAPS** user interface and settings. **Patient name** - Can be used if you have to differentiate between multiple setups (i.e. two T1D kids in your family). - Displayed in the [Dual Watchface](../WearOS/WearOsSmartwatch.md). (Preferences-skin)= ### Skin Setting hidden in [simple mode](#preferences-simple-mode). Vous pouvez choisir parmi quatre thèmes : ![Select skin](../images/Pref2021_SkinWExample.png) 'Low resolution skin' comes with shorter labels and age/level removed to have more available space on a very low resolution screen. Difference between the other skins depends on the phone's display orientation: #### Portrait orientation - **Thème d'origine** et **Les boutons sont toujours affichés en bas de l'écran** sont identiques - **Large Display** has an increased height for all graphs compared to other skins #### Landscape orientation - En utilisant **Thème d'origine** et **Grand écran**, vous devez défiler vers le bas pour voir les boutons en bas de l'écran - **Large Display** has an increased height for all graphs compared to other skins ![Skins depending on phone's display orientation](../images/Screenshots_Skins.png) (Preferences-protection)= ## Protection ![Preferences > General - Protection](../images/Pref2020_General2.png) (Preferences-master-password)= ### Master password Mandatory to be able to [export settings](../Maintenance/ExportImportSettings.md) as they are encrypted from version 2.7. **Biometric protection may not work on OnePlus phones. This is a known issue of OnePlus on some phones.** ![Définir le mot de passe principal](../images/MasterPW.png) ### Settings protection - Protect your settings with a password or phone's biometric authentication (i.e. [child is using **AAPS**](../RemoteFeatures/RemoteMonitoring.md)). If you enable this feature, you will be prompted for authentication each time you want to access any Preferences related view. - Custom password should be used if you want to use master password just for securing [exported settings](../Maintenance/ExportImportSettings.md), and use a different one for editing the preferences. - If you are using a custom password click on line "Settings password" to set password as described [above](#Preferences-master-password). ![Protection](../images/Pref2020_Protection.png) ### Application protection If the app is protected, you must enter the password or use the phone's biometric authentication to open **AAPS**. **AAPS** will shut down immediately if a wrong password is entered - but will still run in background if it was previously opened successfully. ### Bolus protection - Bolus protection might be useful if **AAPS** is used by a small child and you [bolus via SMS](../RemoteFeatures/SMSCommands.md). - Dans l'exemple ci-dessous, vous voyez l'invite de protection biométrique. If biometric authentication does not work, click in the space above the white prompt and enter thr master password. ![Prompt biometric protection](../images/Pref2020_PW.png) ### Password and PIN retention Define how long (in seconds), the preferences or bolus functionalities remain unlocked after you successfully enter the password. ## Aperçu In the **Overview** section, you can define the preferences for the home screen. ![Preferences > Overview](../images/Pref2020_OverviewII.png) ### Keep screen on Option 'Keep screen on' will force Android to keep the screen on at all times. This is useful for presentations etc. But it consumes a lot of battery power. Therefore, it is recommended to connect the smartphone to a charger cable. (Preferences-buttons)= ### Buttons - Define which buttons are visible on the bottom of your home screen. - Setting hidden in [simple mode](#preferences-simple-mode). ![Preferences > Buttons](../images/Pref2020_OV_Buttons.png) - The **Increment** options allow you to define the amount for the three buttons in the carb and insulin dialogues, for easy entry. ![Preferences > Buttons > Insulin](../images/Pref2020_OV_Buttons2.png) ![Preferences > Buttons > Carbs](../images/Pref2020_OV_Buttons3.png) (Preferences-quick-wizard)= ### Assistant Rapide Create customized buttons for certain standard meals or snacks which will be displayed on the home screen. Useful for standard meals frequently eaten. For each button, you define the carbs and calculation method for the bolus. Then, you define during which time period the button will be visible on your home screen - just one button per period. The button will not be visible if outside the specified time range or if you have enough IOB to cover the carbs defined in the QuickWizard button. If different times are specified for the different meals you will always have the appropriate standard meal button on the home screen, depending on the time of day. ![Preferences > Quick Wizard Button Setup](../images/Pref2020_OV_QuickWizard.png) If you click the quick wizard button **AAPS** will calculate and propose a bolus for those carbs based on your current ratios (considering blood glucose value or insulin on board if set up). La proposition doit être confirmée avant l'injection de l'insuline. ![Preferences > Quick Wizard Button](../images/Pref2020_OV_QuickWizard2.png) Only one QuickWizard button can show up at the same time. If you want to execute a different one : long press on the Quick Wizard button currently showing. It will take you to the list of all Quick Wizard options. To execute one, long press on it. You will have to confirm before execution. (Preferences-default-temp-targets)= ### Default temp targets Setting hidden in [simple mode](#preferences-simple-mode). [Temporary targets (TT)](../DailyLifeWithAaps/TempTargets.md) allow you to change your blood glucose target for a certain time period. When setting a default TT, you can easily change your target for activity, eating soon etc. Here you can change the target and the duration for each predefined TT. Preset values are: * Eating soon: target 72 mg/dL / 4.0 mmol/l, duration 45 min * Activity: target 140 mg/dL / 7.8 mmol/l, duration 90 min * Hypo: target 125 mg/dL / 6.9 mmol/l, duration 45 min ![Preferences > Default temp targets](../images/Pref2020_OV_DefaultTT.png) Learn how to [activate Temp Targets here](#TempTargets-where-can-i-select-a-temp-target). ### Fill/Prime standard insulin amounts Setting hidden in [simple mode](#preferences-simple-mode). If you want to fill the tube or prime cannula through **AAPS** you can do this through the [**Actions** tab](#screens-action-tab). Les valeurs prédéfinies peuvent être configurées dans cette boite de dialogue. Choose the default amounts of the three buttons in fill/prime dialogue, depending on the length of your catheter. (Preferences-range-for-visualization)= ### Range for visualization Choose the high and low marks for the BG-graph on **AAPS** overview and smartwatch. It is only the visualization, not the target range for your BG. Example: 70 - 180 mg/dl or 3.9 - 10 mmol/l ![Preferences > Range for visualization](../images/Pref2020_OV_Range2.png) ### Shorten tab titles Setting hidden in [simple mode](#preferences-simple-mode). Useful to see more tab titles on screen. Par exemple, l'onglet "OpenAPS AMA" devient "OAPS", "Objectifs" devient "OBJ" etc. ![Preferences > Tabs](../images/Pref2020_OV_Tabs.png) (Preferences-show-notes-field-in-treatments-dialogs)= ### Show notes field in treatments dialogs Setting hidden in [simple mode](#preferences-simple-mode). Vous permet d'ajouter des textes courts de notes à vos traitements (assistant bolus, glucides, insuline...) ![Preferences > Notes in treatment dialogs](../images/Pref2020_OV_Notes.png) (Preferences-status-lights)= ### Voyants d'état Setting hidden in [simple mode](#preferences-simple-mode). Status lights give a visual warning for: - Age du capteur - Sensor battery level for certain smart readers (see [screenshots page](#screens-sensor-level-battery) for details). - Âge de l'insuline (jours d'utilisation du réservoir) - Niveau du réservoir (unités) - Âge de la canule - Âge Pile Pompe - Âge Pile Pompe (%) If the warning threshold is exceeded, values will be shown in yellow. If the critical threshold is exceeded, values will be shown in red. The last option allows you to import those settings from Nightscout if defined there. See [Nightscout documentation](https://nightscout.github.io/nightscout/setup_variables/#age-pills) for more information. ![Preferences > Status Lights](../images/Pref2020_OV_StatusLights2.png) (Preferences-deliver-this-part-of-bolus-wizard-result)= ### Deliver this part of bolus wizard result Set the [default percentage](#AapsScreens-section-j) of the bolus calculated when using the bolus wizard. Default is 100%: no correction. Even when setting a different value here, you can still change each time you use the bolus wizard. If this setting is 75 % and you had to bolus 10U, the bolus wizard will propose a meal bolus of only 7.5 units. When using [SMB](#objectives-objective9), many people do not meal-bolus 100% of needed insulin, but only a part of it (e.g. 75 %) and let the SMB with UAM (Unattended Meal Detection) do the rest. Using a value lower than 100% here can be useful: * for people with slow digestion: sending all the bolus upfront can cause hypo because the insulin action is faster than the digestion. * to leave more room to **AAPS** to deal by itself with **BG rise**. In both cases, **AAPS** will compensate for the missing part of the bolus with SMBs, if/when deemed adequate. ### Old glycemia time threshold If the last **BG** received is older than this threshold, then the bolus wizard will by default offer a 100% dose instead of the **Deliver this part of bolus wizard result** setting above. The reason for this is that when **BG** is missing, **AAPS** will not be able to send the remaining part of the bolus afterward (the loop is not running), which would result in high **BG**. ### Enabled bolus advisor Setting hidden in [simple mode](#preferences-simple-mode). ![Bolus Advisor](../images/BolusAdvisor.png) When enabled, when you use the bolus wizard as you are in hyperglycemia, you will get a warning, prompting you if you wish to pe-bolus and eat later, when your **BG** gets back in range. ### Enabled bolus reminder Setting hidden in [simple mode](#preferences-simple-mode). % todo (Preferences-advanced-settings-overview)= ### Advanced Settings (Overview) ![Preferences > Advanced Settings](../images/Pref2021_OV_Adv.png) #### Superbolus Setting hidden in [simple mode](#preferences-simple-mode). Activer les Superbolus dans l'Assistant. le principe des [Superbolus](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus/) est "d'emprunter" de l'insuline du débit de basal dans les deux prochaines heures pour éviter les pics. It is different from *super micro bolus*! Use with caution and do not enable it until you learn what it really does. Basically, the basal for the next two hours is added to the bolus and a two hour zero-temp activated. **AAPS looping functions will be disabled - so use with care! If you use SMB **AAPS** looping functions will be disabled according to your settings in ["Max minutes of basal to limit SMB to"](#Open-APS-features-max-minutes-of-basal-to-limit-smb-to), if you do not use SMB looping functions will be disabled for two hours.** Details on super bolus can be found [here](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus). ## Traitements de sécurité (preferences-patient-type)= ### Patient type - Les limites de sécurité sont établies en fonction de l'âge sélectionné dans ce paramètre. - Si vous commencez à atteindre ces limites restrictives (comme le Maximum Bolus), il est temps de changer d’un cran. - It's a bad idea to select higher than real age because it can lead to overdosing by entering the wrong value in the insulin dialog (by skipping the decimal dot, for example). - If you want to know the actual numbers for these hard-coded safety limits, scroll to the algorithm feature you are using on [this page](../DailyLifeWithAaps/KeyAapsFeatures.md). ### Max allowed bolus - Defines the maximum amount of bolus insulin, in insulin units, that **AAPS** is allowed to deliver at once. - Ce paramètre existe comme une limite de sécurité pour empêcher l'injection d’un bolus trop important dû à une saisie accidentelle ou une erreur de l’utilisateur. - Il est recommandé de définir cette valeur à un montant raisonnable qui correspond approximativement à la quantité maximale d’insuline de bolus que vous êtes susceptible d’avoir besoin pour un repas ou pour une dose de correction. - Cette restriction s’applique également aux résultats de l'assistant bolus. ### Max allowed carbs - Defines the maximum amount of carbs, in grams, that **AAPS** bolus calculator is allowed to dose for. - Ce paramètre existe comme une limite de sécurité pour empêcher l'injection d’un bolus trop important dû à une saisie accidentelle ou une erreur de l’utilisateur. - Il est recommandé de définir cette valeur à un montant raisonnable qui correspond approximativement à la quantité maximale de glucides que vous êtes susceptible d’avoir dans d'un repas. ## Boucle As of [AAPS version 3.4](#version3400), it is no longer possible to set the loop mode here. See [AAPS Screens > The Homescreen > Loop status](#AapsScreens-loop-status) to change loop mode now. (Preferences-minimal-request-change)= ### Minimal request change When using **Open loop**, you will receive notifications every time **AAPS** recommends adjusting the basal rate. To reduce the number of notifications you can either use a [wider bg target range](#profile-glucose-targets) or increase the percentage of the minimal request rate. Ce paramètre défini le changement relatif minimum qui déclenchera une notification. ## Assistance Améliorée Repas (AAR ou AMA) ou Super Micro Bolus (SMB) Depending on your settings in [Config builder > APS](../SettingUpAaps/ConfigBuilder.md) you can choose between two algorithms: - [Advanced meal assist (OpenAPS AMA)](#Open-APS-features-advanced-meal-assist-ama) - state of the algorithm in 2017 - [Super Micro Bolus (OpenAPS SMB)](#Open-APS-features-super-micro-bolus-smb) - most recent algorithm recommended for beginners As of [**AAPS** version 3.3](#version3300), [Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md) feature has been moved as part of OpenAPS SMB. ### OpenAPS AMA All the settings for OpenAPS AMA are described in the dedicated section in [Key AAPS Features > Advanced Meal Assist (AMA)](#Open-APS-features-advanced-meal-assist-ama). (Preferences-openaps-smb-settings)= ### OpenAPS SMB All the settings for OpenAPS SMB are described in the dedicated section in [Key AAPS Features > Super Micro Bolus (SMB)](#Open-APS-features-super-micro-bolus-smb). ## Paramètres d’absorption (Preferences-min_5m_carbimpact)= ### min_5m_carbimpact Setting hidden in [simple mode](#preferences-simple-mode). The algorithm uses BGI (blood glucose impact) to determine when [carbs are absorbed](../DailyLifeWithAaps/CobCalculation.md). At times when carb absorption can’t be dynamically worked out based on your blood's reactions, **AAPS** inserts a default decay to your carbs. Basically, it is a failsafe. This value is only used during gaps in **CGM** readings or when physical activity “uses up” all the blood glucose rise that would otherwise cause **AAPS** to decay COB. Pour le dire simplement: L'algorithme "sait" comment vos glycémies *devraient* se comporter quand elles sont affectées par la dose actuelle d'insuline, etc. Chaque fois qu'il y a un écart positif par rapport au comportement attendu, certains glucides sont absorbés/décomposés. Gros changement = beaucoup de glucides, etc. Le min_5m_carbimpact définit l'impact par défaut de l'absorption des glucides par 5 minutes. Pour plus de détails, voir la [documentation OpenAPS](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html?highlight=carbimpact#min-5m-carbimpact). La valeur standard pour AMA est de 5, pour SMB c'est 8. Le graphique GA sur l'écran d'accueil indique quand min_5m_impact est utilisé en plaçant un cercle orange en haut. ![COB graph](../images/Pref2020_min_5m_carbimpact.png) ### Meal max absorption time Si vous mangez souvent des repas riches en matières grasses ou en protéines, vous devrez augmenter votre temps d'absorption des repas. ### Advanced settings - autosens ratio ![Paramètres d’absorption](../images/Pref2020_Absorption.png) - Define min. and max. [autosens](#Open-APS-features-autosens) ratio. - Normalement les valeurs standards (max. 1,2 et min. 0,7) ne devrait pas être modifiées. ## Pump ### BT Watchdog Activate BT watchdog if necessary (e.g. for Dana pumps). It switches off bluetooth for one second if no connection to the pump is possible. This may help on some phones where the bluetooth stack freezes. ## Paramètres de la pompe The options here will vary depending on which pump driver you have selected in [Config Builder > Pump](#Config-Builder-pump). Pair and set your pump up according to the [pump related instructions](../Getting-Started/CompatiblePumps.md). ## Tidepool More information on the dedicated [Tidepool](../SettingUpAaps/Tidepool.md) page. (Preferences-nsclient)= ## NSClient ![NSClient](../images/Pref2020_NSClient.png) Original communication protocol, can be used with older Nightscout versions. - Set your *Nightscout URL* (i.e. ). - **Vérifiez bien que l'URL est SANS /api/v1/ à la fin.** - The *[API secret](https://nightscout.github.io/nightscout/setup_variables/#api-secret-nightscout-password)* (a 12 character password recorded in your Nightscout variables). - This enables data to be read and written between both the Nightscout website and **AAPS**. - Vérifiez deux fois les fautes de frappe ici si vous êtes coincé dans l'objectif 1. ## NSClientV3 ![NSClientV3](../images/Pref2024_NSClientV3.png) [New protocol introduced with AAPS 3.2.](#Important-comments-on-using-v3-versus-v1-API-for-Nightscout-with-AAPS) Safer and more efficient. ```{admonition} V3 data uploaders :class: warning When using NSClientV3, all uploaders must be using the API V3. Since most are not compatible yet, this means **you must let **AAPS** upload all data** (BG, treatments, ...) to Nightscout and disable all other uploaders if they're not V3 compliant. ``` - Set your *Nightscout URL* (i.e. ). - **Vérifiez bien que l'URL est SANS /api/v1/ à la fin.** - In Nightscout, create an *[Admin token](https://nightscout.github.io/nightscout/security/#create-a-token)* (requires [Nightscout 15](https://nightscout.github.io/update/update/) to use the V3 API) and enter it in the **NS access token** (not your API Secret!). - This enables data to be read and written between both the Nightscout website and **AAPS**. - Vérifiez deux fois les fautes de frappe ici si vous êtes coincé dans l'objectif 1. - Leave Connect to websockets enabled (recommended). (Preferences-nsclient-synchronization)= ### Synchronization ![Synchronization options](../images/Pref2025_NSclient_Synchronization.png) Synchronization choices will depend on the way you will want to use **AAPS**. You can select which data you want to [upload and download to or from Nightscout](#Nightscout-aaps-settings). ### Alarm options ![Alarm options](../images/Pref2024_NSClient_Alarms.png) - Alarm options allows you to select which Nightscout alarms to use through the app. **AAPS** will alarm when a Nightscout alarm triggers. - For the alarms to sound you need to set the Urgent High, High, Low and Urgent Low alarm values in your [Nightscout variables](https://nightscout.github.io/nightscout/setup_variables/#alarms). - They will only work whilst you have a connection to Nightscout and are intended for parent/caregivers. - If you have the **CGM** source on your phone (i.e. xDrip+ or BYODA) then use those alarms instead of Nightscout Alarms. - Create notifications from Nightscout [announcements](https://nightscout.github.io/nightscout/discover/#announcement) will echo Nightscout announcements in the **AAPS** notifications bar. - You can change stale data and urgent stale data alarms threshold when no data is received from Nightscout after a certain time. ### Connection settings ![NSClient connection settings](../images/ConfBuild_ConnectionSettings.png) - Connection settings define when Nightscout connection will be enabled. - Restreignez le téléchargement de Nightscout au Wi-Fi seulement ou même à certains SSID Wi-Fi. - If you want to use only a specific Wi-Fi network you can enter its Wi-Fi SSID. - Plusieurs SSID peuvent être séparés par un point-virgule. - Pour supprimer tous les SSID, entrez un espace dans la zone. (Preferences-advanced-settings-nsclient)= ### Advanced settings (NSClient) ![NS Client advanced settings](../images/Pref2024_NSClientAdv.png) Options in advanced settings are self-explanatory. ## Communicateur SMS More information on the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. ## Automatisation Select which location service shall be used: - Use passive location: **AAPS** only takes locations if other apps are requesting it - Utiliser la localisation par le réseau : Localisation de votre Wifi - Utiliser la localisition GPS (Attention ! Peut entrainer une consommation excessive de la batterie !) ## Alertes locales ![Alertes locales](../images/Pref2020_LocalAlerts.png) Les paramètres doivent être explicites. (preferences-maintenance-settings)= ## Paramètres de maintenance ![Paramètres de maintenance](../images/Pref2020_Maintenance.png) **Email recipient**: Standard recipient of logs is . **Data Choices** ![Choix de données](../images/Pref2020_DataChoice.png) You can help develop **AAPS** further by sending crash reports to the developers. **Unattended Settings Export**
By enabling this feature, you allow **AAPS** to execute settings exports without user intervention. For this the master password is securely stored on your phone (only) at the next manually export. The stored password will be used for up to 4 weeks. After 4 weeks you will be notified the password is about to expire. During a grace period of 1 week, the password can then be refreshed by manually exporting settings from the maintenance menu. After the grace period of 1 week has passed the stored password expires and any automated settings export will abort while notifying the user, asking to reenter the password. [(**Automated settings exports**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) will be logged to the **AAPS** 'Careportal' and 'User entry' lists under Treatments. After enabling this option, make sure to perform a manual settings export, where you will be requested for your password, so that **AAPS** can store it. ### Log files AAPS will save logs for troubleshooting. Do not disable this feature: it will help understanding the reasons if something goes wrong. If you need to send the logs to the developers, make sure you file accurately the mail contents to describe the issue. It is preferable to send logs only after being requested to do so, following an [issue report in GitHub](https://github.com/nightscout/AndroidAPS/issues). You can find AAPS logs in your phone memory -> Android -> data -> info.nightscout.androidaps -> files. ![Log files options](../images/Pref2020_Maintenance_Logs.png) (preferences-maintenance-logdirectory)= ### Setting the local AAPS directory Maintenance settings also include the **AAPS** directory, which can be found directly under the Maintenance tab. This setting allows the user to choose a directory on their phone where **AAPS** will store preferences, logs, and other files. ![Pref2020_Maintenance_Directory.png](../images/Pref2020_Maintenance_Directory.png) It is strongly recommended to use a directory directly in the main entry of your phone memory. Default is AAPS. ![Local directory location](../images/preferences/maintenance_settings_directory.png) If you select a subdirectory of AAPS, you will see an error message. Tap "OK" and retry, selecting the correct directory (one above). Do not select "DISMISS" unless you clearly know what you are doing. ![Local directory location](../images/preferences/maintenance_settings_wrongdirectory.png) (preferences-maintenance-cloud)= ### Setting a cloud directory You can export your settings, logs and CSV data to a cloud service. 1. Select Cloud directory 2. Select your cloud service 3. Enable cloud export ![Cloud directory](../images/preferences/maintenance_settings_cloud.png) You can then define what data will be uploaded to the cloud. ![Cloud directory data](../images/preferences/maintenance_settings_clouddata.png) You can disable cloud export. ![Cloud directory disable](../images/preferences/maintenance_settings_cloudoff.png) ## Open Humans Vous pouvez aider la communauté en faisant don de vos données à des projets de recherche ! Details are described on the [Open Humans page](../SupportingAaps/OpenHumans.md). In Preferences, you can define when data shall be uploaded - only if connected to Wi-Fi - uniquement si en charge