diff --git a/docs/CROWDIN/cs/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/cs/DailyLifeWithAaps/Automations.md index 678ce10d1828..31d93ec8abed 100644 --- a/docs/CROWDIN/cs/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/cs/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/cs/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/cs/GettingHelp/AccessingLogFiles.md index f7b0a9005e77..cbe66870ca6a 100644 --- a/docs/CROWDIN/cs/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/cs/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Zpřístupnění log souborů * Připojte telefon k počítači v režimu přenosu souborů -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logy](../images/aapslog.png) diff --git a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md index dc15e15e2a11..ab587d000e56 100644 --- a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md b/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md index 189d8459d9bb..c4c75303e927 100644 --- a/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md b/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md index 623e9509952b..124ccd5e61b5 100644 --- a/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md index 9086dc4ba112..e6ae66123f21 100644 --- a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/cs/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/cs/RemoteFeatures/RemoteControl.md index b890039f2391..efa0f3133b82 100644 --- a/docs/CROWDIN/cs/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/cs/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Všimněte si, že **NSClient** byl nahrazen **AAPSClient** pro AAPS verze 3.2 a vyšší. Pro více informací zkontrolujte poznámky k verzi._ - -Pro verze **AAPS**, které jsou starší než AAPS 3.2, pokud máte Android telefon pečovatele/rodiče, můžete si aplikaci [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) přímo stáhnout a nainstalovat. **AAPSClient** vypadá velmi podobně jako samotná aplikace **AAPS** a poskytuje tak pečovateli nástroj na vzdálené ovládání **AAPS**. +**AAPSClient** vypadá velmi podobně jako samotná aplikace **AAPS** a poskytuje tak pečovateli nástroj na vzdálené ovládání **AAPS**. ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -Existují 2 verze apk, které lze stáhnout [zde](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2**, mezi kterými je drobný, ale důležitý rozdíl, jak je vysvětleno níže. +### Download and installation **AAPSClient** můžete nainstalovat do jednoho telefonu nebo do více telefonů sledujících osob (např. telefonu sledujícího rodiče 1 a telefonu sledujícího rodiče 2), aby měli oba pečovatelé přístup a vzdálené ovládání telefonu pacienta **AAPS**. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Pokud pečovatel potřebuje druhou kopii **AAPSClient** ke vzdálenému ovládání dalšího pacienta s Nightscout účtem, může kromě **AAPSClient** nainstalovat navíc **AAPSClient2**. **AAPSClient 2** umožňuje jedinému poskytovateli péče nainstalovat aplikaci **AAPSClient** dvakrát na stejný telefon pečovatele, aby měl současný přístup a ovládání k dvěma různým pacientům. -Chcete-li stáhnout **AAPSClient**, přejděte na [tuto stránku](https://github.com/nightscout/AndroidAPS/releases/) a klepněte na soubor **“app-AAPSClient-release_x.x.x.x”** (může to být novější verze než ta zobrazená na snímku níže): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ Po stažení klikněte na _zobrazit ve složce_, abyste nalezli soubor. Zkopírován do telefonu pečovatele pomocí USB kabelu nebo přetáhnut do adresáře Google drive, připojeného do telefonu pečovatele. Následně klikněte na soubor "app_AAPSClient-release. apk". +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Nastavení synchronizace - AAPSClient a AAPS (pro verzi 3.2.0.0 a vyšší) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). Níže uvedený příklad poskytuje pokyny pro synchronizaci pro NSClient a NSClientV3 pomocí Nightscout15, ale jsou k dispozici i jiné možnosti s __AAPS__ (například xDrip+). diff --git a/docs/CROWDIN/cs/SettingUpAaps/Preferences.md b/docs/CROWDIN/cs/SettingUpAaps/Preferences.md index 690cef7e1ba2..6e3ac7243d0e 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/cs/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Vzhled @@ -154,6 +155,8 @@ Navržený bolus musí být potvrzen, aby byl následně vydán. ![Předvolby > Tlačítko průvodce](../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)= ### Výchozí nastavení dočasných cílů @@ -486,6 +489,12 @@ Můžete pomáhat s vývojem AAPS zasláním hlášení o pádu vývojářům. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md index 2ca7e9f2d796..9002eb1cb6aa 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ V tomto příkladu vybereme reportovací server Nightscout a zkonfigurujeme ho. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` Pro reportovací server Tidepool je nastavení ještě jednodušší, protože je třeba pouze zadání vašch přihlašovacích údajů. diff --git a/docs/CROWDIN/de/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/de/DailyLifeWithAaps/Automations.md index 4f54e7fac5d2..ce7c66c2a571 100644 --- a/docs/CROWDIN/de/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/de/DailyLifeWithAaps/Automations.md @@ -290,7 +290,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automatisierungsprotokolle (Logs) diff --git a/docs/CROWDIN/de/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/de/GettingHelp/AccessingLogFiles.md index 2abc145f7433..61ebe75d43c9 100644 --- a/docs/CROWDIN/de/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/de/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Logdateien erhalten * Verbinde das Smartphone mit dem Computer im Dateiübertragungsmodus -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![Logdateien](../images/aapslog.png) diff --git a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md index e191a6a294ec..1740cbb0d391 100644 --- a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs Updates & Änderungen +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## Dezember 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/de/Maintenance/ExportImportSettings.md b/docs/CROWDIN/de/Maintenance/ExportImportSettings.md index c646dfd7d875..ebebee16bfb8 100644 --- a/docs/CROWDIN/de/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/de/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/de/Maintenance/ReleaseNotes.md b/docs/CROWDIN/de/Maintenance/ReleaseNotes.md index 8ffd6fc98af1..6ad690d1c3d3 100644 --- a/docs/CROWDIN/de/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/de/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Erscheinungsdatum: 29.12.2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Erscheinungsdatum: 29.12.2024 #### Other functionalities -* Exporte im Hintergrund @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Erscheinungsdatum: 29.12.2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * Persistenz-Ebene vom Hauptcode getrennt @MilosKozak * Build-Dateien auf kts umgescrieben @MilosKozak diff --git a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md index 3056e5db233e..deb942149a0f 100644 --- a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md @@ -9,7 +9,11 @@ Aufgrund der gesetzlichen Regelungen für Medizinprodukte ist **AAPS** nicht als * Aktualisiere so bald wie möglich auf die neueste **AAPS**-Version, nachdem sie verfügbar ist. * Sobald eine neue Version verfügbar ist, wird Dir in der **AAPS**-App ein Hinweis darüber angezeigt. * Wenn eine neue Version verfügbar ist, wird darüber auch auf Facebook informiert. -* Nach der Veröffentlichung lies bitte die [Versionshinweise](ReleaseNotes.md) (Release Notes) genau durch, und kläre mögliche Fragen in der Community auf Facebook oder Discord, bevor Du mit dem Update weiter machst. +* Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Übersicht zum Aktualisieren auf eine neue AAPS Version diff --git a/docs/CROWDIN/de/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/de/RemoteFeatures/RemoteControl.md index 807bf75c67b9..b9cd855c1212 100644 --- a/docs/CROWDIN/de/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/de/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ Hierzu gibt es die gesonderte Seite [SMS-Befehle](../RemoteFeatures/SMSCommands. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Ab AAPS Version 3.2 (oder höher) ersetzt der **AAPSClient** den **NSClient**. Details findest Du in den Release Notes._ - -Wenn Du ein Eltern-/Betreuenden-Smartphone haben solltest und eine ältere **AAPS**-Version (vor 3.2) benötigst, kannst Du die [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/)-App direkt herunterladen und installieren. Der **AAPSClient** sieht **AAPS** sehr ähnlich, und stellt den Eltern/Betreuenden einen Reiter zur Verfügung, auf dem Aktionen remote in **AAPS** ausgeführt werden können: +Der **AAPSClient** sieht **AAPS** sehr ähnlich, und stellt den Eltern/Betreuenden einen Reiter zur Verfügung, auf dem Aktionen remote in **AAPS** ausgeführt werden können: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -Es gibt zwei Versionen der apk, die [heruntergeladen werden können](https://github.com/nightscout/AndroidAPS/releases/): **AAPSClient** & **AAPSClient2**, die einen kleinen aber feinen Unterschied, der unten erklärt wird, haben. +### Download and installation **AAPSClient** kann auf einem einzigen Smartphone oder mehreren Follower-Smartphones installiert werden (z.B. auf das Follower-Smartphone des ersten Elternteils und des zweiten Elternteils), um so beiden die Möglichkeit zu geben das zugehörige **AAPS**-Master-Smartphone remote zu steuern. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Sollte die Notwendigkeit bestehen, ein weiteres AAPS-Smartphone (eines anderen Patienten mit einem Nightscout-Konto) zu steuern, ist eine weitere Kopie des **AAPSClient** notwendig. Hierzu muss dann der **AAPSClient2** zusätzlich zum **AAPSClient** installiert werden. Durch den **AAPSClient 2** ist es möglich, dass eine betreuende Person die **AAPSClient** apk zweimal auf dem Follower-Smartphone installieren kann und so den Daten von zwei Patienten gleichzeitig folgen kann. -Um den **AAPSClient** herunterzuladen, navigiere [hierhin](https://github.com/nightscout/AndroidAPS/releases/) und klicke auf das Element **“app-AAPSClient-release_x.x.x.x”** (die im Screenshot unten gezeigte Version kann eventuell älter sein): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![grafik](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ Die **AAPSClient** apk kann nun entweder: Mit einem USB-Kabel auf das Follower-Smartphone übertragen werden, oder in einen Google-Drive Ordner gezogen werden und dann auf das Follower-Smartphone durch klicken auf app-"AAPSClient-release-"-Datei gebracht werden. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronisierung - AAPSClient und AAPS einrichten (für Version 3.2.0.0 und höher) Sobald die __AAPSClient__-APK auf dem Follower-Smartphone installiert ist, muss dafür gesorgt werden, dass die „Einstellungen“ in der KONFIGURATION mit denen für __AAPS__ mit Nightscout 15 abgeglichen sind (siehe Versionshinweise [hier](../Maintenance/UpdateToNewVersion)). Das folgende Beispiel bietet Hilfestellung bei den Synchronisierungs-Einstellungen für NSClient und NSClientV3 im Zusammenspiel mit Nightscout 15. Es gibt daneben auch noch andere __AAPS__-Optionen (z.B. xDrip+). diff --git a/docs/CROWDIN/de/SettingUpAaps/Preferences.md b/docs/CROWDIN/de/SettingUpAaps/Preferences.md index 8103d42afe39..c4127acf919f 100644 --- a/docs/CROWDIN/de/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/de/SettingUpAaps/Preferences.md @@ -45,7 +45,8 @@ The **simple mode** is activated by default when you first install **AAPS**. In **Name des Patienten** -- Kann verwendet werden, wenn Du zwischen verschiedenen Installationen unterscheiden musst (z.B. zwei Kinder mit Typ 1 in Deiner Familie). +- 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)= #### Erscheinungsbild @@ -154,6 +155,8 @@ Der Vorschlag muss bestätigt werden, bevor Insulin abgegeben wird. ![Einstellungen > 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)= ### Vordefinierte temporäre Ziele @@ -486,6 +489,12 @@ Einstellungen sollten selbsterklärend sein. Du kannst bei der Weiterentwicklung von **AAPS** unterstützen, indem Du Absturzberichte an die Entwickler sendest. +**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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md index 2518986cdd39..8e3a63e506e2 100644 --- a/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md @@ -214,7 +214,7 @@ In diesem Beispiel wählen wir Nightscout als Auswertungsserver aus und konfigur :class: Note Klicke [hier](#version3200), um zu den **AAPS** 3.2.0.0 Release Notes zu gelangen, die die Unterschiede zwischen der obersten Option **NSClient** (das ist die „v1“, auch wenn es nicht daneben steht) und der zweiten Option **NSClient v3** erläutern. -Nightscout-Nutzende sollten **NSClientV3** wählen, es sei denn, Du willst über Nightscout die Werte überwachen und remote Behandlungen eingeben(_z.B._ als Elternteil oder Betreuer, das **AAPS** für ein Kind verwendet). In diesem Fall Fall wähle (bis auf weiteres) die erste Option "**Nightscout-Client**". +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` Für Tidepool ist es sogar noch einfacher, da Du nur Deine persönlichen Login-Daten benötigst. diff --git a/docs/CROWDIN/el/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/el/DailyLifeWithAaps/Automations.md index 85d66d1ff20f..1aba0593e7b9 100644 --- a/docs/CROWDIN/el/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/el/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/el/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/el/GettingHelp/AccessingLogFiles.md index aef494d1c64e..4d78022c62fd 100644 --- a/docs/CROWDIN/el/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/el/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Πρόσβαση σε αρχεία καταγραφής * Συνδέστε το τηλέφωνο με έναν υπολογιστή σε λειτουργία μεταφοράς αρχείων -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md index 62dc47fc8549..52c27477096e 100644 --- a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/el/Maintenance/ExportImportSettings.md b/docs/CROWDIN/el/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/el/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/el/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/el/Maintenance/ReleaseNotes.md b/docs/CROWDIN/el/Maintenance/ReleaseNotes.md index 86fd8d59f81d..3dfc99319cd7 100644 --- a/docs/CROWDIN/el/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/el/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md index 08c7194fb945..323c511956e5 100644 --- a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/el/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/el/RemoteFeatures/RemoteControl.md index bf0aadad7d17..ca2a8bdff5cd 100644 --- a/docs/CROWDIN/el/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/el/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/el/SettingUpAaps/Preferences.md b/docs/CROWDIN/el/SettingUpAaps/Preferences.md index d50100918965..88fda605b0bc 100644 --- a/docs/CROWDIN/el/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/el/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md index a783932a5d92..38d322405b5d 100644 --- a/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/es/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/es/DailyLifeWithAaps/Automations.md index 1d9c4f3c923d..0c6d416b01d0 100644 --- a/docs/CROWDIN/es/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/es/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/es/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/es/GettingHelp/AccessingLogFiles.md index 5c162cf6d428..cd9859bfdaa1 100644 --- a/docs/CROWDIN/es/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/es/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Acceder a los logs * Conecte el teléfono a una computadora en modo de transferencia de archivos -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md index 6c11312aa5db..e5851cfe0eb9 100644 --- a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/es/Maintenance/ExportImportSettings.md b/docs/CROWDIN/es/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/es/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/es/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/es/Maintenance/ReleaseNotes.md b/docs/CROWDIN/es/Maintenance/ReleaseNotes.md index 9dcb2ea643d3..ec66da1081c3 100644 --- a/docs/CROWDIN/es/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/es/Maintenance/ReleaseNotes.md @@ -71,8 +71,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -121,7 +121,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -144,6 +144,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md index deced8f99139..4b6ea328f41b 100644 --- a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/es/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/es/RemoteFeatures/RemoteControl.md index 34e9c8e5c7e6..13cb2461ebe9 100644 --- a/docs/CROWDIN/es/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/es/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![imagen](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/es/SettingUpAaps/Preferences.md b/docs/CROWDIN/es/SettingUpAaps/Preferences.md index 8d5d8aa2768b..c5776c205429 100644 --- a/docs/CROWDIN/es/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/es/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Tema @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md index 3d9b50fb8984..3879551d8f36 100644 --- a/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/fr/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/fr/DailyLifeWithAaps/Automations.md index d2d937ad0508..bcb64ee539db 100644 --- a/docs/CROWDIN/fr/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/fr/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/fr/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/fr/GettingHelp/AccessingLogFiles.md index 8d80843896d4..3eb1c00eb031 100644 --- a/docs/CROWDIN/fr/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/fr/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accès aux fichiers log * Connecter le téléphone à un ordinateur en mode de transfert de fichiers -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md index 5d3f0c40bb29..25d74920901a 100644 --- a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Mises à jour et modifications de la documentation +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md b/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md index 4d79e7cfa5c2..1855669705e9 100644 --- a/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md b/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md index fbbf6bf62adf..10d80482cf42 100644 --- a/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md index cb1faaa79d00..5f2959244ff5 100644 --- a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/fr/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/fr/RemoteFeatures/RemoteControl.md index b3b1023970be..e96064b2dba3 100644 --- a/docs/CROWDIN/fr/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/fr/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/fr/SettingUpAaps/Preferences.md b/docs/CROWDIN/fr/SettingUpAaps/Preferences.md index c03595c3c149..6ea8b873306d 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/fr/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Thème @@ -154,6 +155,8 @@ 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)= ### Cibles Temporaires par défaut @@ -486,6 +489,12 @@ Les paramètres doivent être explicites. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md index 190d1d0ff6ba..01cb269e38a6 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ Dans cet exemple, nous sélectionnons Nightscout comme serveur de reporting, et Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` Pour Tidepool, c'est encore plus simple, car vous n'avez besoin que de vos informations de connexion personnelles. diff --git a/docs/CROWDIN/he/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/he/DailyLifeWithAaps/Automations.md index c5c6828a08bc..2ded2d8bfade 100644 --- a/docs/CROWDIN/he/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/he/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/he/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/he/GettingHelp/AccessingLogFiles.md index f2046e4b1b32..89d3935edac4 100644 --- a/docs/CROWDIN/he/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/he/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accessing logfiles * Connect phone to a computer in file transfer mode -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md index 46880a3c0210..4ce4a85c6286 100644 --- a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/he/Maintenance/ExportImportSettings.md b/docs/CROWDIN/he/Maintenance/ExportImportSettings.md index 3e70fd747287..87e26a1bef6f 100644 --- a/docs/CROWDIN/he/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/he/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/he/Maintenance/ReleaseNotes.md b/docs/CROWDIN/he/Maintenance/ReleaseNotes.md index 3d390080a01a..7c861c5c040c 100644 --- a/docs/CROWDIN/he/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/he/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md index 81b223675887..a03d9e7b2411 100644 --- a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/he/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/he/RemoteFeatures/RemoteControl.md index 9aafebf49beb..23d377d1f867 100644 --- a/docs/CROWDIN/he/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/he/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/he/SettingUpAaps/Preferences.md b/docs/CROWDIN/he/SettingUpAaps/Preferences.md index b31635fad0b2..f74178d24d4a 100644 --- a/docs/CROWDIN/he/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/he/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### סקין @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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)= ### ברירות מחדל ערכי מטרה @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md index 20b75428407b..ffa719bdba7d 100644 --- a/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/ko/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/ko/DailyLifeWithAaps/Automations.md index e9394aa231c5..3a9ed7f24ce3 100644 --- a/docs/CROWDIN/ko/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/ko/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/ko/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/ko/GettingHelp/AccessingLogFiles.md index 973da00c9bca..d9ae2f4a586a 100644 --- a/docs/CROWDIN/ko/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/ko/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # 로그파일 접근하기 * 폰을 파일 전송모드로 컴퓨터와 연결합니다 -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md index f0404536f72d..e1fb8915af88 100644 --- a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md index 7328ab2a784e..757a7fb348df 100644 --- a/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md index f750ee43d018..33dc5cd2272c 100644 --- a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/ko/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/ko/RemoteFeatures/RemoteControl.md index 5ee682af7165..06565a879679 100644 --- a/docs/CROWDIN/ko/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/ko/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/ko/SettingUpAaps/Preferences.md b/docs/CROWDIN/ko/SettingUpAaps/Preferences.md index 66c45d338921..b5ef3497e27a 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/ko/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md index ee5b056d2b43..723bbdf96aed 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/lt/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/lt/DailyLifeWithAaps/Automations.md index 2e913871794c..d5f0177ee3f7 100644 --- a/docs/CROWDIN/lt/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/lt/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/lt/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/lt/GettingHelp/AccessingLogFiles.md index adc3a21be398..969065e9616f 100644 --- a/docs/CROWDIN/lt/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/lt/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Žurnalų failų gavimas * Prijunkite telefoną prie kompiuterio failų persiuntimo režimu -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md index 191e407c4061..78631d40f135 100644 --- a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md b/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md index a5cf9691c488..a7af258c390e 100644 --- a/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md b/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md index 0932b3456d80..5ce7051488d2 100644 --- a/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md index 4e8256e53936..75a4a8dbda81 100644 --- a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/lt/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/lt/RemoteFeatures/RemoteControl.md index f5b5f7c7e312..49156d10d828 100644 --- a/docs/CROWDIN/lt/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/lt/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/lt/SettingUpAaps/Preferences.md b/docs/CROWDIN/lt/SettingUpAaps/Preferences.md index 5b0024df0840..30cc3a8440e3 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/lt/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md index ecd88b2ea26a..5c4e19ef7214 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/nl/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/nl/DailyLifeWithAaps/Automations.md index 5fabbec4adcb..bae0d92b2022 100644 --- a/docs/CROWDIN/nl/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/nl/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/nl/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/nl/GettingHelp/AccessingLogFiles.md index 0af3af5ae18a..f03bc00e5698 100644 --- a/docs/CROWDIN/nl/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/nl/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Logbestanden uitlezen * Verbind je telefoon met een computer in bestandsoverdrachtsmodus -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md index 2b02f63d39ee..e60c6a950bbc 100644 --- a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md b/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md index f793cf976bea..f91121094811 100644 --- a/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md b/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md index 81ed7aabe6d0..d781bc9fc4ac 100644 --- a/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md index 37ca5a7b5adb..eeb3c05428d9 100644 --- a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/nl/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/nl/RemoteFeatures/RemoteControl.md index f333354f8985..8604992bc716 100644 --- a/docs/CROWDIN/nl/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/nl/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/nl/SettingUpAaps/Preferences.md b/docs/CROWDIN/nl/SettingUpAaps/Preferences.md index 4fd05aa45ee0..080aad016d3d 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/nl/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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)= ### Standaard tijdelijke streefdoelen @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md index dca98634f269..cf0f1e4527ad 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/pb/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/pb/DailyLifeWithAaps/Automations.md index e9394aa231c5..3a9ed7f24ce3 100644 --- a/docs/CROWDIN/pb/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/pb/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/pb/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/pb/GettingHelp/AccessingLogFiles.md index f2046e4b1b32..89d3935edac4 100644 --- a/docs/CROWDIN/pb/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/pb/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accessing logfiles * Connect phone to a computer in file transfer mode -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md index 6aaee8921e9d..8e545e3a4e7f 100644 --- a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md index 7328ab2a784e..757a7fb348df 100644 --- a/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md index aeadeffa8035..4f7734abcc59 100644 --- a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/pb/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/pb/RemoteFeatures/RemoteControl.md index 931f11bc222d..0cb20ea7263f 100644 --- a/docs/CROWDIN/pb/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/pb/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/pb/SettingUpAaps/Preferences.md b/docs/CROWDIN/pb/SettingUpAaps/Preferences.md index 997314be4097..21f03e62e075 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/pb/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md index 68ead9c7fb7d..1bd8d248b483 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/pl/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/pl/DailyLifeWithAaps/Automations.md index e9394aa231c5..3a9ed7f24ce3 100644 --- a/docs/CROWDIN/pl/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/pl/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/pl/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/pl/GettingHelp/AccessingLogFiles.md index 98139785f948..23b23d87fb06 100644 --- a/docs/CROWDIN/pl/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/pl/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Dostęp do plików logów * Podłącz telefon do komputera w trybie przesyłania plików -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md index 54ecc3769ec7..91f59ca4aaae 100644 --- a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md index 8e041519303c..7f214787de35 100644 --- a/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md index fa1709de991b..bd009dd83ca9 100644 --- a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/pl/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/pl/RemoteFeatures/RemoteControl.md index 7d1069a29162..eb4126a4d847 100644 --- a/docs/CROWDIN/pl/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/pl/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/pl/SettingUpAaps/Preferences.md b/docs/CROWDIN/pl/SettingUpAaps/Preferences.md index 668e9f04242a..35765220ce95 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/pl/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md index 7b7f05641e4b..dc0f87081888 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/pt/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/pt/DailyLifeWithAaps/Automations.md index 1a3e362939ac..5afecc50cd58 100644 --- a/docs/CROWDIN/pt/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/pt/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/pt/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/pt/GettingHelp/AccessingLogFiles.md index 926f3e703f21..a0bf8cf2e2fa 100644 --- a/docs/CROWDIN/pt/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/pt/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Aceder aos arquivos de registo * Ligue o telemóvel a um computador no modo de transferência de arquivos -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md index 146ccb5faa06..99a76985ee18 100644 --- a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md index 99a343a26d65..71d6caf04ca2 100644 --- a/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md index 842222ccca9f..aaf1ecbbdb41 100644 --- a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/pt/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/pt/RemoteFeatures/RemoteControl.md index 9f4080406a2c..03ddac76ad20 100644 --- a/docs/CROWDIN/pt/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/pt/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/pt/SettingUpAaps/Preferences.md b/docs/CROWDIN/pt/SettingUpAaps/Preferences.md index 90a1dec1a4d4..e89c0a2eed45 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/pt/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Tema gráfico @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md index a935083ba947..1ef10c131a94 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/ro/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/ro/DailyLifeWithAaps/Automations.md index 8c17b8f309d1..3fdcac7a14d7 100644 --- a/docs/CROWDIN/ro/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/ro/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/ro/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/ro/GettingHelp/AccessingLogFiles.md index f2046e4b1b32..89d3935edac4 100644 --- a/docs/CROWDIN/ro/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/ro/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accessing logfiles * Connect phone to a computer in file transfer mode -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md index aa617c344fb4..7feca274a15b 100644 --- a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md index d47eb97d5500..a52d727272a5 100644 --- a/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md index aeadeffa8035..4f7734abcc59 100644 --- a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/ro/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/ro/RemoteFeatures/RemoteControl.md index 119c0e26749c..aa90f4b12c03 100644 --- a/docs/CROWDIN/ro/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/ro/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/ro/SettingUpAaps/Preferences.md b/docs/CROWDIN/ro/SettingUpAaps/Preferences.md index 53f862a78dd1..a759fb755cd3 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/ro/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Imagine fundal @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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)= ### Ţinte temp implicite @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md index ee6dd198e6f5..94468ee47994 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/ru/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/ru/DailyLifeWithAaps/Automations.md index 670c2acc6e06..b4caf23632ce 100644 --- a/docs/CROWDIN/ru/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/ru/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Журналы автоматизации diff --git a/docs/CROWDIN/ru/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/ru/GettingHelp/AccessingLogFiles.md index edc2eade3fb2..4f9a68cec390 100644 --- a/docs/CROWDIN/ru/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/ru/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Чтение лог-файлов * Подключите телефон к компьютеру в режиме передачи файлов -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![журнал событий](../images/aapslog.png) diff --git a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md index 17198d88e5e1..1b661ced7265 100644 --- a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Обновления и изменения в документации +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md index ae767e5e4331..e797671e0390 100644 --- a/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md index b4a928b085eb..c8b50965a893 100644 --- a/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md index 9153abb11923..0bff1b3266f1 100644 --- a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * Когда доступна новая версия, в самом приложении **AAPS** появляется информационный баннер об этом. * О новой версии также выходит объявление на Facebook во время релиза. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Обзор порядка обновления до новой версии AAPS diff --git a/docs/CROWDIN/ru/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/ru/RemoteFeatures/RemoteControl.md index 551b067e8293..4dc8f4b964b9 100644 --- a/docs/CROWDIN/ru/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/ru/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Обратите внимание, что **NSClient** теперь заменен на **AAPSClient** для AAPS версии 3. и выше, подробности см. в примечаниях к версиям._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** похож внешне на сам **AAPS**, но позволяет опекунам отправлять команды в **AAPS** дистанционно: +**AAPSClient** похож внешне на сам **AAPS**, но позволяет опекунам отправлять команды в **AAPS** дистанционно: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** позволяет одному опекуну установить apk **AAPSClient** два раза на одном и том же телефоне, чтобы получить одновременный доступ и дистанционное управление для двух различных пациентов. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![изображение](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Перенесено при помощи кабеля USB на телефон опекуна; или перетащено в папку Google диска, а затем добавлено на телефон опекуна после нажатия на app-AAPSClient-release-3. apk. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/ru/SettingUpAaps/Preferences.md b/docs/CROWDIN/ru/SettingUpAaps/Preferences.md index e4d29c310df7..3b5d17bb07ca 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/ru/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Тема оформления @@ -154,6 +155,8 @@ If you click the quick wizard button **AAPS** will calculate and propose a bolus ![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)= ### Временные цели по умолчанию @@ -486,6 +489,12 @@ Select which location service shall be used: 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md index 0575698bebd1..c2688433730d 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ If you select an item here on the left tick box, on the right you can then ticki Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` Для Tidepool проще, так как требуются только персональные данные для входа. diff --git a/docs/CROWDIN/sk/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/sk/DailyLifeWithAaps/Automations.md index e9394aa231c5..3a9ed7f24ce3 100644 --- a/docs/CROWDIN/sk/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/sk/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/sk/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/sk/GettingHelp/AccessingLogFiles.md index f2046e4b1b32..89d3935edac4 100644 --- a/docs/CROWDIN/sk/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/sk/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accessing logfiles * Connect phone to a computer in file transfer mode -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md index b9a366b9b34b..c4ed81115ee5 100644 --- a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md b/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md index 0b2ac955275c..c2004ce33315 100644 --- a/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md b/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md index 7328ab2a784e..757a7fb348df 100644 --- a/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md index aeadeffa8035..4f7734abcc59 100644 --- a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/sk/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/sk/RemoteFeatures/RemoteControl.md index 931f11bc222d..0cb20ea7263f 100644 --- a/docs/CROWDIN/sk/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/sk/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/sk/SettingUpAaps/Preferences.md b/docs/CROWDIN/sk/SettingUpAaps/Preferences.md index 997314be4097..21f03e62e075 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/sk/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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 @@ -154,6 +155,8 @@ The proposal has to be confirmed before insulin is delivered. ![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 @@ -486,6 +489,12 @@ Settings should be self-explanatory. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md index 68ead9c7fb7d..1bd8d248b483 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/tr/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/tr/DailyLifeWithAaps/Automations.md index 51fa4e47f326..c8d5b8dfd1d3 100644 --- a/docs/CROWDIN/tr/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/tr/DailyLifeWithAaps/Automations.md @@ -291,7 +291,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # Automation Logs diff --git a/docs/CROWDIN/tr/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/tr/GettingHelp/AccessingLogFiles.md index c3a6d372b6c7..375314da29d9 100644 --- a/docs/CROWDIN/tr/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/tr/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Günlük dosyalarına erişim * Telefonu dosya aktarım modunda bir bilgisayara bağlayın -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md index f395ba55b33e..dab073b7816c 100644 --- a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Doküman güncellemeleri & değişiklikleri +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md b/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md index c2c332f48489..cc44898fd2cf 100644 --- a/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ It is recommended to do regular settings exports, especially before and after ma **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ -### Exporting or Importing Settings: +### Exporting or Importing Settings To export or import settings, use the **import or export buttons** in the AAPS **maintenance menu** ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### Automating Settings Export: -For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in the maintenance menu preferences. +(ExportImportSettings-Automating-Settings-Export)= +### Automating 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. +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -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. +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**Note:** On importing settings to user always needs to enter the AAPS password!_ diff --git a/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md b/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md index 63f445f50c90..82de447565f6 100644 --- a/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md index f5283d2d2b09..0c5180b002fe 100644 --- a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/tr/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/tr/RemoteFeatures/RemoteControl.md index c665723adf30..3d7cd11fff7b 100644 --- a/docs/CROWDIN/tr/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/tr/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ See the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page. (RemoteControl_aapsclient)= ## 2) AAPSClient -_Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2 and higher, check the version release notes for more information._ - -For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: +**AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**: ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. +### Download and installation **AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone. +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients. -To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ The **AAPSClient** apk can now be either: Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file. +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above) Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](../Maintenance/UpdateToNewVersion)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+). diff --git a/docs/CROWDIN/tr/SettingUpAaps/Preferences.md b/docs/CROWDIN/tr/SettingUpAaps/Preferences.md index 2d1f0e0076d9..53a65998e5ea 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/tr/SettingUpAaps/Preferences.md @@ -46,6 +46,7 @@ The **simple mode** is activated by default when you first install **AAPS**. In **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)= #### Görünüm @@ -154,6 +155,8 @@ If you click the quick wizard button **AAPS** will calculate and propose a bolus ![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)= ### Varsayılan Geçici hedefler @@ -486,6 +489,12 @@ Ayarlar açıklayıcı olmalıdır. 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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md index 49ab11cb3d6e..bd96c79abf5a 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ In this example we select Nightscout as reporting server, and will configure it. Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**. -Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice. +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` For Tidepool it is even simpler, as you only need your personal login information. diff --git a/docs/CROWDIN/zh_CN/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/zh_CN/DailyLifeWithAaps/Automations.md index 0d74bfbc401e..b45ca480a454 100644 --- a/docs/CROWDIN/zh_CN/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/zh_CN/DailyLifeWithAaps/Automations.md @@ -289,7 +289,7 @@ Screenshots detailing the Automation triggers: ![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png) -Note: Export execution will be logged on Careportal +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # 自动操作日志 diff --git a/docs/CROWDIN/zh_CN/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/zh_CN/GettingHelp/AccessingLogFiles.md index f2046e4b1b32..89d3935edac4 100644 --- a/docs/CROWDIN/zh_CN/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/zh_CN/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # Accessing logfiles * Connect phone to a computer in file transfer mode -* Locate the log files in the AAPS data directory, at the location you chose in the [Maintenance tab](#preferences-maintenance-logdirectory). +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![logs](../images/aapslog.png) diff --git a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md index bb4df50db2a6..3f49eb7f2c01 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # Docs updates & changes +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## December 2024 - Documentation of [3.3 version](#version3300) @emilise diff --git a/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md b/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md index 4214e3425dc7..6f0829bf9319 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ **注意**：_导出的设置将使用您的AAPS主密码进行加密：如果没有用于导出的主密码，您将无法导入设置文件！_ -### 导出或导入设置： +### Exporting or Importing Settings 要导出或导入设置，请使用AAPS**维护菜单**中的**导入或导出按钮**。 ![Maintenance menu export/import buttons](../images/Maintenance/maintenance_menu_import_export_400px.png) -### 自动化设置导出： -要进行自动化设置导出[（**请参阅自动化部分**）](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export)，请在维护菜单偏好设置中启用“**无人值守设置导出**”选项。 +(ExportImportSettings-Automating-Settings-Export)= +### Automating Settings Export -启用此功能后，您允许AAPS在没有用户干预的情况下执行设置导出。 为此，主密码将在下次手动导出时安全地存储在您的手机上（仅限于此）。 存储的密码将有效期长达4周。 4周后，您将收到密码即将到期的通知。 在为期1周的宽限期内，您可以通过从维护菜单手动导出设置来刷新密码。 +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -1周的宽限期过后，存储的密码将过期，任何自动化设置导出都将中止，并通知用户重新输入密码。 [（**自动化设置导出**）](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export)将记录在AAPS的“Careportal”和“用户输入”列表下的“治疗”部分。 +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**注意**：在将设置导入用户时，总是需要输入AAPS密码！_ diff --git a/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md b/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md index 7328ab2a784e..757a7fb348df 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ Release date: 29-12-2024 * **[Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md)** feature is no more a dedicated plugin, but is now included as an option of [OpenAPS SMB](#Config-Builder-aps) plugin, along with some changes in its behaviour: * **Profile Switch** and **Profile Percentage** is now taken into account for **Dynamic ISF** in respect of dynamic sensitivity strengthness * The average **ISF** of the last 24h is calculated and this value is used for bolus wizard and **COB** calculation. **Profile ISF** value is not used at all (except fallback when history data is not available) - * If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm - * *** AGAIN: Turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. This is already part of dynamic sensitivity algorithm + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * Do not use a **Profile %** increase of greater than 100% for a long time. If you determine that your **Profile** has changed, create a new **Profile** with your revised values in order to replicate the **Profile** with % * Enable “SMB always” and “SMB after carbs” for FreeStyle Libre 2 and Libre 3 users * Note : Although the limitation was removed on **AAPS** side, this functionality is not fully operational yet, since **AAPS** needs to receive proper identification of the CGM used. See the [bug opened on xDrip+ project](https://github.com/NightscoutFoundation/xDrip/issues/3841). @@ -123,7 +123,7 @@ Release date: 29-12-2024 #### Other functionalities -* Unattended exports @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * New [Automation trigger](#automations-automation-triggers) @vanelsberg * Pod Activation (patch pump only) * New [Automation triggers](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ Release date: 29-12-2024 #### Technical changes +* [log files location change](#Accessing-logfiles-accessing-logfiles) * new internal modules structure @MilosKozak * split persistence layer from main code @MilosKozak * build files rewritten to kts @MilosKozak diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md index aeadeffa8035..4f7734abcc59 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md @@ -10,6 +10,10 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## Overview for updating to a new version of AAPS diff --git a/docs/CROWDIN/zh_CN/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/zh_CN/RemoteFeatures/RemoteControl.md index 8b445c0f2eeb..8a4c993b6a0f 100644 --- a/docs/CROWDIN/zh_CN/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/zh_CN/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ (RemoteControl_aapsclient)= ## 2) AAPSClient -_注意：对于AAPS 3.2及更高版本，**NSClient**已被**AAPSClient**替代，请查看版本发布说明以获取更多信息。_ - -对于**AAPS** 3.2之前的版本，如果您有护理人员/家长的Android手机，可以直接下载并安装[**<0>AAPSClien**](https://github.com/nightscout/AndroidAPS/releases/)apk。 **AAPSClient**在外观上非常类似于**AAPS**本身，为护理人员提供了远程操作AAPS命令的标签： +**AAPSClient**在外观上非常类似于**AAPS**本身，为护理人员提供了远程操作AAPS命令的标签： ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -有两个版本的apk可以从[此处下载](https://github.com/nightscout/AndroidAPS/releases/)，**AAPSClient**&**AAPSClient2**，它们之间有一个细微但重要的区别，如下所述。 +### Download and installation **AAPSClient**可以安装在单个手机或多个跟随者手机上（即家长1的跟随者手机和家长2的跟随者手机），以便两位护理人员都能获得访问权限并远程控制患者的**AAPS**手机。 +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + 如果护理人员需要第二个**AAPSClient**副本来远程控制另一个使用Nightscout账户的患者，他们应该在安装**AAPSClient**之外再安装**AAPSClient2**。 **AAPSClient 2**允许单个护理人员在同一跟随者手机上两次安装**AAPSClient** apk，以便能够同时访问并远程控制两名不同的患者。 -要下载**AAPSClient**，请导航至[此处](https://github.com/nightscout/AndroidAPS/releases/)并点击资源**“app-AAPSClient-release_x.x.x.x”**（它可能是比下方截图中显示的更新版本）： +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![image](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ _注意：对于AAPS 3.2及更高版本，**NSClient**已被**AAPSClient**替代 通过USB数据线传输到跟随者手机上；或者， 拖动到Google Drive文件夹中，然后点击“app-AAPSClient-release”文件将其添加到跟随者手机。 +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### 同步-AAPSClient和AAPS的设置（适用于3.2.0.0及以上版本） 一旦在跟随者手机上安装了__AAPSClient__ apk，用户必须确保其在Config Builder中的“Preferences”正确设置并与Nightscout 15的__AAPS__对齐（请参阅[此处](../Maintenance/UpdateToNewVersion)的发布说明）。 下面的示例提供了使用Nightscout15的NSClient和NSClientV3的同步指南，但__AAPS__还有其他可用选项（例如xDrip+）。 diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/Preferences.md b/docs/CROWDIN/zh_CN/SettingUpAaps/Preferences.md index 88933cde4adc..85c94be52735 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/Preferences.md @@ -45,7 +45,8 @@ The **simple mode** is activated by default when you first install **AAPS**. In **患者名称** -- 如果你需要区分多个设置（例如，家中有两个1型糖尿病患者），可以使用此选项。 +- 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)= #### 皮肤 @@ -154,6 +155,8 @@ Setting hidden in [simple mode](#preferences-simple-mode). ![参数设置 > 快速向导按钮](../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)= ### 默认临时目标 @@ -485,6 +488,12 @@ The options here will vary depending on which pump driver you have selected in [ 您可以通过向开发者发送崩溃报告来帮助**AAPS**进一步发展。 +**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. + (preferences-maintenance-logdirectory)= 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) diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md index e7eb01779711..f936eea0e29c 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md @@ -214,7 +214,7 @@ Confirm that you wish to grant access to **AAPS** to the selected directory: :class: 注意 点击 [这里](#version3200) 查看 **AAPS** 3.2.0.0 的发布说明，其中解释了顶部选项 **NSClient**（这是“v1”，尽管没有明确标记）和第二个选项 **NSClient v3** 之间的差异。 -Nightscout 用户应选择 **NSClient v3**，除非您想通过 Nightscout 监控或发送远程治疗（例如，作为使用 **AAPS** 的儿童的家长或看护人），在这种情况下，请选择第一个选项“**NSClient**”，直到另行通知。 +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` 对于 Tidepool 来说更简单，因为您只需要个人登录信息。 diff --git a/docs/CROWDIN/zh_TW/DailyLifeWithAaps/Automations.md b/docs/CROWDIN/zh_TW/DailyLifeWithAaps/Automations.md index d92a98a842d8..05abb2b12484 100644 --- a/docs/CROWDIN/zh_TW/DailyLifeWithAaps/Automations.md +++ b/docs/CROWDIN/zh_TW/DailyLifeWithAaps/Automations.md @@ -293,7 +293,7 @@ ![在 Pod 註冊時匯出](../images/Automations/automation_settingsexport_podactivation_400px.png) -注意：匯出執行將記錄在照護入口上 +Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export. # 自動化日誌 diff --git a/docs/CROWDIN/zh_TW/GettingHelp/AccessingLogFiles.md b/docs/CROWDIN/zh_TW/GettingHelp/AccessingLogFiles.md index b37e90f43306..ed56fd8e3d50 100644 --- a/docs/CROWDIN/zh_TW/GettingHelp/AccessingLogFiles.md +++ b/docs/CROWDIN/zh_TW/GettingHelp/AccessingLogFiles.md @@ -3,8 +3,10 @@ # 讀取日誌檔案 * 將手機連線到電腦，並選擇檔案傳輸模式 -* 找到 AAPS 資料目錄中的日誌檔案，位於您在[維護選單](#preferences-maintenance-logdirectory)中選擇的位置。 - 根存儲資料夾的命名可能會根據手機略有不同。 +* Locate the log files in the AAPS data directory, in `Android\data\info.nightscout.androidaps\files`. + The naming of the root storage folder may vary a little depending on the phone. +* The location is `Android\data\info.nightscout.aapsclient\files` for [AAPSClient](#RemoteControl_aapsclient). +* Note : log location has changed in **AAPS 3.3**. See the previous versions' documentation if needed. ![日誌](../images/aapslog.png) diff --git a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md index 00b7b074c913..48ea6bc439cd 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md @@ -1,5 +1,9 @@ # 文件更新與變更 +## January 2025 + +- Quick wizard [long press feature](#Preferences-quick-wizard) @emilise + ## 2024年12月 - 文檔 [3.3版](#version3300) @emilise diff --git a/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md b/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md index 461930f6c595..d38eb876d35b 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md @@ -65,17 +65,17 @@ **注意**：_匯出的設定將使用你的 AAPS 主密碼進行加密：若沒有用於匯出的主密碼， 你將無法匯入設定檔！_ -### 匯出或匯入設定： +### Exporting or Importing Settings 要匯出或匯入設定，請使用 AAPS**維護選單中的匯入或匯出按鈕** ![維護選單匯出/匯入按鈕](../images/Maintenance/maintenance_menu_import_export_400px.png) -### 自動化設定匯出： -要進行自動化設定匯出，請[(**參見自動化**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export)啟用選項"**無人操作設定匯出**" 在維護選單的偏好設定中。 +(ExportImportSettings-Automating-Settings-Export)= +### Automating Settings Export -透過啟用此功能，你允許 AAPS 在無需人為干預的情況下執行設定匯出。 為此，主密碼 安全地存儲在你的手機中（僅限於下次手動匯出時）。 存儲的密碼將在最多 4 週內有效。 4 週後，你將收到通知，提示密碼即將過期。 在為期 1 週的寬限期內，可以透過 從維護選單手動匯出設定來刷新密碼。 +For doing automating settings exports [(**see Automation**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) enable the option "**Unattended Settings Exports**" in [Preferences > Maintenance](#preferences-maintenance-settings). -在寬限期過期的 1 週後，存儲的密碼將過期，任何自動化設定匯出將中止，同時通知用戶，要求 重新輸入密碼。 [(**自動化設定匯出**)](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export)將被記錄在 AAPS 的「照護入口」和「用戶輸入」列表下的治療項目中。 +You can now configure [Automation](../DailyLifeWithAaps/Automations.md#automating-preference-settings-export) to export settings, either on a regular basis (_i.e._ each week), or after a pod change. _**注意：**在匯入設定時，用戶始終需要輸入 AAPS 密碼！_ diff --git a/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md b/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md index e04a8af97059..252c8bc0bdf2 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md @@ -73,8 +73,8 @@ WearOS 5, API 等級 34 (Android 14) 有[限制](#BuildingAapsWearOs-WearOS5)。 * **[動態 ISF](../DailyLifeWithAaps/DynamicISF.md)** 功能不再是獨立的外掛，而是現在作為 [OpenAPS SMB](#Config-Builder-aps) 外掛的一個選項，並伴隨一些行為上的變更： * 在動態敏感度強度方面，**動態 ISF** 現在會考慮 **設定檔切換** 和 **設定檔百分比** 的影響。 * 將使用過去 24 小時的平均 **ISF** 計算，該數值將用於注射嚮導和 **COB** 的計算。 **設定檔中的 ISF** 值完全不會被使用（僅在歷史資料無法使用時作為備用） - * 如果您使用**動態 ISF**，請勿在**自動化**設定任何以**血糖**為條件的**設定檔百分比**， 因為這已經是動態敏感度演算法的一部分。 - * *** 再次提醒：請關閉所有**自動化**中與**血糖** 相關的 **設定檔 %**，因為這可能會導致胰島素劑量過多！ ***** + * Reminder: If you use **DynamicISF** and you have **Automation** set for a **Profile %** in relation to **BG**: Turn It Off. 因為這已經是動態敏感度演算法的一部分。 + * *** AGAIN: When using DynamicISF, turn off all **Automations** which activates a **Profile %** in relation to **BG** because it will be too aggressive and may over deliver in insulin! ***** * 請勿長時間使用超過 100% 的 **設定檔百分比** 增加值。 如果你的**設定檔**已有變更，請在「治療頁籤」中的**設定檔**切換，複製帶有% 的**設定檔**來建立新的設定檔。 * 為使用 FreeStyle Libre 2 和 Libre 3 的用戶啟用「始終啟用 SMB」與「碳水後啟用 SMB」選項。 * 注意：儘管在**AAPS** 端已移除限制，但此功能尚未完全運作，因為**AAPS** 需要接收所使用的 CGM 的正確認證。 請參閱[xDrip+ 專案中開啟的錯誤](https://github.com/NightscoutFoundation/xDrip/issues/3841)。 @@ -123,7 +123,7 @@ WearOS 5, API 等級 34 (Android 14) 有[限制](#BuildingAapsWearOs-WearOS5)。 #### 其他功能 -* 無人操作匯出 @vanelsberg +* [Unattended settings exports](#ExportImportSettings-Automating-Settings-Export) @vanelsberg * 新增[自動化觸發](#automations-automation-triggers) @vanelsberg * Pod 註冊（僅限貼片幫浦） * 新增[自動化觸發](#automations-automation-triggers) @jbr77rr @@ -146,6 +146,7 @@ WearOS 5, API 等級 34 (Android 14) 有[限制](#BuildingAapsWearOs-WearOS5)。 #### 技術變更 +* [log files location change](#Accessing-logfiles-accessing-logfiles) * 新的內部模組結構 @MilosKozak * 將持久性層與主程式碼分離 @MilosKozak * 建置檔案重新編寫為 kts @MilosKozak diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md index bb522a621a7c..9c1f99fc0274 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md @@ -9,7 +9,11 @@ * 請在有新版本發布後儘快更新到最新版本的 **AAPS**。 * 當有新版本發布時，你將在 **AAPS** 應用中收到關於新版本的訊息橫幅。 * 新版本也會在發布時於 Facebook 上公佈。 -* 發布後，請詳細閱讀[發布說明](ReleaseNotes.md)，如有任何疑問，請在Facebook或Discord社群中澄清後再進行更新。 +* Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. + + ```{note} + In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. + ``` ## 更新到新版本 AAPS 的概述 diff --git a/docs/CROWDIN/zh_TW/RemoteFeatures/RemoteControl.md b/docs/CROWDIN/zh_TW/RemoteFeatures/RemoteControl.md index 922a2f80907e..788d3a347240 100644 --- a/docs/CROWDIN/zh_TW/RemoteFeatures/RemoteControl.md +++ b/docs/CROWDIN/zh_TW/RemoteFeatures/RemoteControl.md @@ -17,20 +17,19 @@ (RemoteControl_aapsclient)= ## 2) AAPSClient -_請注意，**NSClient** 已被 **AAPSClient** 取代，適用於 AAPS 3.2 及更高版本，請查閱版本發佈說明以了解更多資訊。_ - -對於 AAPS 3.2 以下版本，如果你有照護者/父母的 Android 手機，你可以直接下載並安裝 [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk。 **AAPSClient** 的外觀與 **AAPS** 本身非常相似，提供了照護者可以遠端執行 **AAPS** 指令的標籤頁： +**AAPSClient** 的外觀與 **AAPS** 本身非常相似，提供了照護者可以遠端執行 **AAPS** 指令的標籤頁： ![NSCLIENT_ 2024-05-17 134512](../images/6c66a27c-21d7-4c43-ac66-001669c0634f.png) - -這裡有兩個可以[下載](https://github.com/nightscout/AndroidAPS/releases/)的 apk 版本，分別是 **AAPSClient** 和 **AAPSClient2**，他們有著細微但重要的差異，詳見下方說明。 +### Download and installation **AAPSClient** 可以安裝在一部或多部追蹤者手機上（例如父母一的追蹤者手機和父母二的追蹤者手機），以便兩位照護者都能夠獲得權限並遠端控制患者的 **AAPS** 手機。 +There are 2 versions of the apk that can be [downloaded from the GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below. + 如果某位照護者需要第二個副本來遠端控制另一位患者，且該患者有 Nightscout 帳號，他們應該安裝 **AAPSClient2** 以外加 **AAPSClient**。 **AAPSClient2** 允許單一照護者在同一台追蹤者手機上安裝 **AAPSClient** apk 兩次，以便同時遠端控制兩位不同的患者。 -要下載 **AAPSClient**，請前往 [此處](https://github.com/nightscout/AndroidAPS/releases/)，然後點擊資產**“app-AAPSClient-release_x.x.x.x”**（他可能比下面的截圖顯示版本更新）： +To download **AAPSClient**, navigate to the [GitHUb repository](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below): ![圖像](../images/remote_control_and_following/AAPSClient_download_02.png) @@ -44,6 +43,8 @@ _請注意，**NSClient** 已被 **AAPSClient** 取代，適用於 AAPS 3.2 及 透過 USB 傳輸線傳輸到追蹤者手機；或拖放至 Google 雲端硬碟資料夾，然後透過點擊“app-AAPSClient-release”檔案將其安裝到追蹤者手機。 +Should you be needing **AAPS** for yourself, and **AAPSClient** for monitoring someone else, you will need to build **AAPSClient** yourself instead of downloading it from the Github repository as described above. The reason is that you can't install both **AAPS** and **AAPSClient** on the same phone, signed by a different key.
To build **AAPSClient** yourself, follow the same process as [regular AAPS build](../SettingUpAaps/BuildingAaps.md). On the **Generate signed App Bundle or APK** page, select **aapsclientRelease** instead of **fullRelease**. + ### 同步設置 - AAPSClient 和 AAPS 配置（適用於 3.2.0.0 版本以上） 當追蹤者手機上安裝了 __AAPSClient__ apk，用戶必須確保在 "組態建置工具" 中的“偏好設定”已正確設置並與 __AAPS__ 的 Nightscout 15 對齊（請參閱發佈說明 [此處](../Maintenance/UpdateToNewVersion)）。 以下範例提供了使用 Nightscout 15 的 NSClient 和 NSClientV3 的同步指南，但 __AAPS__ 也有其他選項（例如 xDrip+）。 diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/Preferences.md b/docs/CROWDIN/zh_TW/SettingUpAaps/Preferences.md index 3739c721c07f..fa8b7d6e3a9d 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/Preferences.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/Preferences.md @@ -45,7 +45,8 @@ **患者名稱** -- 如果你需要區分多個設置（例如家中有兩個 T1D 小孩），可以使用此功能。 +- 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)= #### 外觀 @@ -154,6 +155,8 @@ ![偏好設定 > 快速嚮導按鈕](../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)= ### 預設臨時目標 @@ -486,6 +489,12 @@ AMA 的標準值為 5，SMB 的標準值為 8。 你可以通過向開發者發送崩潰報告來幫助進一步開發**AAPS**。 +**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. + (preferences-maintenance-logdirectory)= 維護設定還包括**AAPS** 目錄，該目錄可以直接在維護選單中找到。 此設定允許用戶選擇電話上的一個目錄，**AAPS**將在該目錄中儲存偏好設定、日誌及其他檔案。 ![Pref2020_Maintenance_Directory.png](../images/Pref2020_Maintenance_Directory.png) diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md index f48c5a8b7e64..c9541c5f1ef0 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md @@ -215,7 +215,7 @@ Android將藍牙通訊的使用與位置服務的使用權限相關聯。 你可 點擊 [這裡](#version3200) 查看 **AAPS** 3.2.0.0 的發布說明，其中解釋了第一選項 **NSClient**（這是「v1」，雖然未明確標記）和第二選項 **NSClient v3** 之間的差異。 -Nightscout 使用者應該選擇 **NSClient v3**，除非你想通過 Nightscout 監控或發送遠端治療（例如，作為孩子的父母或照顧者使用 **AAPS**），這種情況下請選擇第一個選項「**NSClient**」，直至另行通知。 +Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout web interface, in which case, choose the first option "**NSClient**" until further notice. ``` 對於Tidepool來說，這更簡單，因為你只需要你的個人登錄訊息。