Skip to content
Merged

3.4 #2503

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions docs/EN/Getting-Started/CompatiblesCgms.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,13 @@ This section provides a brief overview of all compatible **CGMs/FGMs** with **AA
| [Libre 1](../CompatibleCgms/Libre1.md) | [xDrip+](../CompatibleCgms/xDrip.md), Glimp, Tomato or Diabox. Need a transmitter |
| [Eversense](../CompatibleCgms/Eversense.md) | [xDrip+](../CompatibleCgms/xDrip.md) or ESEL/Eversense patched App |
| [Enlite (MM640G/MM630G)](../CompatibleCgms/MM640g.md) | [xDrip+](../CompatibleCgms/xDrip.md) or MM640g + 600SeriesAndroidUploader App |
| [PocTech](../CompatibleCgms/PocTech.md) | PocTech |
| [PocTech](../CompatibleCgms/PocTech.md) | PocTech app |
| Glunovo | Glunovo App |
| Intelligo | Intelligo App |
| [Ottai](../CompatibleCgms/OttaiM8.md) | Ottai |
| [Syai Tag](../CompatibleCgms/SyaiTagX1.md) | Syai Tag |
| Sibionics CGM | [Juggluco](../CompatibleCgms/Juggluco.md) |
| [Syai](../CompatibleCgms/SyaiTagX1.md) | Syai Tag |
| Sibionics CGM | [Juggluco](../CompatibleCgms/Juggluco.md) or Patched SI App |
| Sinocare | Patched Sino App |

(GettingStarted-TrustedBGSource)=

Expand All @@ -43,5 +46,6 @@ Trusted data sources allow **SMB** delivery, all the time.
| Dexcom ONE/ONE+/Stelo | xDrip+ (**Direct, Native**) |
| Libre 2/2+ (EU) | xDrip+ (OOP2 **no calibration**), </br>Juggluco (**xDrip broadcast** without xDrip+, or **Patched Libre** with xDrip+) |
| Libre 2/2+/3/3+ | Juggluco (**xDrip broadcast** without xDrip+, or **Patched Libre** with xDrip+) |
| Syai | Syai App |

**Note: xDrip+ Companion apps and Follower modes (includes 640G/Eversense) are not trusted data sources.**
4 changes: 2 additions & 2 deletions docs/EN/Getting-Started/Phones.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Phones

The current version of **AAPS** (3.3) requires an Android smartphone with Google **Android 11.0 or above**. If you are considering buying a new phone, (as of December 2024), **Android 14 is preferred**.
The current version of **AAPS** (3.4) requires an Android smartphone with Google **Android 12.0 or above**. If you are considering buying a new phone, (as of January 2026), **Android 16 is preferred**, Android 15 is not recommended.

Check [Facebook or Discord](../GettingHelp/WhereCanIGetHelp.md) for latest updates on this subject.

Users are strongly encouraged to keep their build of **AAPS** up to date for safety reasons. However, for users unable to use a device with Android 11.0 or newer, earlier versions of **AAPS** compatible for older Android versions, remain available, see: [Release notes](#maintenance-android-version-aaps-version).
Users are strongly encouraged to keep their build of **AAPS** up to date for safety reasons. However, for users unable to use a device with Android 12.0 or newer, earlier versions of **AAPS** compatible for older Android versions, remain available, see: [Release notes](#maintenance-android-version-aaps-version).

- [Jelly Pro Settings](../CompatiblePhones/Jelly.md)
- [Huawei Settings](../CompatiblePhones/Huawei.md)
Expand Down
4 changes: 2 additions & 2 deletions docs/EN/Getting-Started/PreparingForAaps.md
Original file line number Diff line number Diff line change
Expand Up @@ -216,8 +216,8 @@ This documentation aims to reduce the technical expertise required to an absolut

#### AAPS and Android Versions

The current version of **AAPS** (3.3) requires an Android smartphone with Google **Android 11.0 or above**. If you are considering buying a new phone, (as of December 2024), Android 14 is preferred.<br/>
Users are strongly encouraged to keep their build of **AAPS** up to date for safety reasons. However, for users unable to use a device with Android 11.0 or newer, earlier versions of **AAPS** compatible for older Android versions, remain available, see: [Release notes](#maintenance-android-version-aaps-version).
The current version of **AAPS** (3.4) requires an Android smartphone with Google **Android 12.0 or above**. If you are considering buying a new phone, (as of January 2026), Android 16 is preferred.<br/>
Users are strongly encouraged to keep their build of **AAPS** up to date for safety reasons. However, for users unable to use a device with Android 12.0 or newer, earlier versions of **AAPS** compatible for older Android versions, remain available, see: [Release notes](#maintenance-android-version-aaps-version).

#### Smartphone model choice
The exact model you buy depends on the desired function(s). You can find on the [Phones page](../Getting-Started/Phones.md) recommendations and user feedback about working setups.
Expand Down
2 changes: 1 addition & 1 deletion docs/EN/Getting-Started/Watches.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ It sounds like an attractive option, right? However, at present, only a few enth

While there is no clear specification which helps you to know if a watch will work well for standalone **AAPS** use, the following parameters will help:

1) Android 11 or newer.
1) Android 12 or newer.
2) Being able to take the watchface off “square” mode to make text larger and easier to read.
3) Very good battery life.
4) Good Bluetooth range.
Expand Down
2 changes: 1 addition & 1 deletion docs/EN/Maintenance/ReleaseNotes.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ The chronology of these releases is not available at the moment but as this ques

## Android version and AAPS version

If your smartphone uses an Android Version older than Android 11 you will not be able to use AAPS v3.3 and up as it requires at least Android 11.
If your smartphone uses an Android Version older than Android 12 you will not be able to use AAPS v3.4 and up as it requires at least Android 12.

In order to allow users with older Android to use older version of AAPS new versions were pushed which only change version verification. No other improvements are included.

Expand Down
3 changes: 2 additions & 1 deletion docs/EN/SettingUpAaps/ComputerBuild.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details.
| [3.2.0.4](#version3204) | Hedgehog (2023.1.1) | up to Otter | 8.2 | 17 |
| [3.3.1.3](#version3300) | Ladybug Feature Drop (2024.2.2) | up to Otter | 8.10 | 21 |
| [3.3.2](#version3300) | Meerkat (2024.3.1) | up to Otter | 8.11.1 | 21 |
| [3.3.2.1](#version3321) | Narwhal (2025.1.2) | Otter | 8.13 | 21 |
| [3.3.2.1](#version3321) | Narwhal (2025.1.2) | up to Otter | 8.13 | 21 |
| [3.4](#version3400) | Otter 2 Feature Drop (2025.2.2) | | 9 | 21 |

The "preferred version" is packaged with the appropriate JVM version. The preferred version is also the minimal version you can use to build **AAPS**. You will **NOT** be able to build on a version older than the "preferred" one. If using a different version, you may encounter issues related to JVM version. See the [Troubleshooting Android Studio](#troubleshooting_androidstudio-uncommitted-changes) page to help solve these issues.
If your current Android Studio version is not listed in the table, you must update it first.
Expand Down
86 changes: 47 additions & 39 deletions docs/EN/SettingUpAaps/SetupWizard.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ If there is an error in the documentation or you have a better idea for how some

This is just the welcome message which you can skip with the "NEXT" button:

![image](../images/setup-wizard/Screenshot_20231202_125636.png)
![Welcome](../images/setup-wizard/Wizard01.png)

## License agreement

Expand All @@ -34,105 +34,113 @@ If you don't understand, or can't agree to the end user license agreement please

If you understand and agree, please click the "I UNDERSTAND AND AGREE" button and follow the Setup Wizard:

![image](../images/setup-wizard/Screenshot_20231202_125650.png)
![EULA](../images/setup-wizard/Wizard02.png)

## Required permissions

**AAPS** needs some requirements to operate correctly.

In the following screens you are asked several questions you have to agree to, to get **AAPS** working. The Wizard itself explains why it asks for the relevant setting.
In the following screen you are asked several questions you have to agree to, to get **AAPS** working. The Wizard itself explains why it asks for the relevant setting.

In this screen, we aim to give some more background information, translate more technical speak into common language or explain the reason.
In this screen, we aim to give some more background information, translate more technical speak into common language or explain the reason. Continue reading below to see each permission request.

Please click the "NEXT" button:
![Permissions](../images/setup-wizard/Wizard03.png)

![image](../images/setup-wizard/Screenshot_20231202_125709.png)

### Notification and battery optimization
### Notifications

Android requires special permission for apps if they want to send you notifications.

While it is a good feature to disable notifications _e.g._ from social media apps, it is essential that you allow **AAPS** to send you notifications.

Please click the first "ASK FOR PERMISSION" button:

![image](../images/setup-wizard/Screenshot_20231202_125721.png)
![Notifications](../images/setup-wizard/Wizard04.png)

Select the "AAPS" app:

![image](../images/setup-wizard/Screenshot_20231202_125833.png)
![AAPS over other apps](../images/setup-wizard/Wizard04-AndroidSettings1.png)

Enable "Allow display over other apps" by sliding the slider to the right:

![image](../images/setup-wizard/Screenshot_20231202_125843.png)
![image](../images/setup-wizard/Wizard04-AndroidSettings2.png)

The slider should look this way if it is enabled:

![image](../images/setup-wizard/Screenshot_20231202_125851.png)
![image](../images/setup-wizard/Wizard04-AndroidSettings3.png)

### Battery optimization

Battery consumption on smartphones is still a consideration, as the performance of the batteries is still quite limited. Therefore, the Android operating system on your smartphone is quite restrictive about allowing applications to run and consume CPU time, and therefore battery power.
Battery consumption on smartphones is a consideration, as the performance of batteries is still quite limited. Therefore, the Android operating system on your smartphone is restrictive about allowing applications to run and consume CPU time, and therefore battery power.

However, **AAPS** needs to run regularly, _e.g._ to receive the glucose readings every few minutes and then apply the algorithm to decide how to deal with your glucose levels, based on your specifications. Therefore it must be allowed to do so by Android.

You do this by confirming the setting.

Click the second "ASK FOR PERMISSION" button. Please select "Allow":
Click the second "ASK FOR PERMISSION" button.

![image](../images/setup-wizard/Screenshot_20231202_125750.png)
![Allow Background](../images/setup-wizard/Wizard05.png)

Click the "NEXT" button:
Please select "Allow":

![Screenshot_20241207-161454.png](../images/setup-wizard/Screenshot_20241207-161454.png)
![Allow Background](../images/setup-wizard/Wizard05-Background.png)

### Location

Android links the use of bluetooth communication to the ability to use location services. Perhaps you have seen it with other apps too. It's common to need location permission if you want to access bluetooth.
### Storage permission

**AAPS** uses bluetooth to communicate with your CGM and insulin pump if they are directly controlled by **AAPS** and not another app which is used by **AAPS**. Details may differ from setup to setup.
**AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage.

Click the first "ASK FOR PERMISSION" button:

![image](../images/setup-wizard/Screenshot_20231202_125924.png)
![Allow Background](../images/setup-wizard/Wizard06.png)

This is important. Otherwise **AAPS** can not work properly at all.
Click "Allow":

Click "While using the app":
![image](../images/setup-wizard/Wizard06-Memory.png)

![image](../images/setup-wizard/Screenshot_20231202_125939.png)
Click "AAPS Directory". This opens the filesystem on your phone and allows you to choose where you want AAPS to store its information.

Click the second "ASK FOR PERMISSION" button:
![AAPS Directory](../images/setup-wizard/Wizard07.png)

![Screenshot_20241207-154117.png](../images/setup-wizard/Screenshot_20241207-154117.png)
The default directory is **AAPS**, but you can use any dedicated directory of your liking. Create the directory if necessary, enter it, and choose "Use this folder":

Select "Allow all the time".
![Select folder](../images/setup-wizard/Wizard07-Folder.png)

Confirm that you wish to grant access to **AAPS** to the selected directory:

![Select folder](../images/setup-wizard/Wizard07-Confirm.png)

Click the "NEXT" button:

![image](../images/setup-wizard/Screenshot_20231202_130002.png)
![Finish Permissions](../images/setup-wizard/Wizard08.png)

### Storage permission
### Location

**AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage.
Android links the use of Bluetooth communication to the ability to use location services. Perhaps you have seen it with other apps too. It's common to need location permission if you want to access Bluetooth.

**AAPS** uses Bluetooth to communicate with your CGM and insulin pump if they are directly controlled by **AAPS** and not another app which is used by **AAPS**. Details may differ from setup to setup.

Click the first "ASK FOR PERMISSION" button:

![image](../images/setup-wizard/Screenshot_20231202_130012.png)
![Allow Location](../images/setup-wizard/Wizard09.png)

Click "Allow":
This is important. Otherwise **AAPS** can not work properly at all.

![image](../images/setup-wizard/Screenshot_20231202_130022.png)
Click "While using the app":

![Location](../images/setup-wizard/Wizard09-location.png)

Click "AAPS Directory". This opens the filesystem on your phone and allows you to choose where you want AAPS to store its information. The default directory is **AAPS**, but you can use any dedicated directory of your liking. Create the directory if necessary, enter it, and choose "Use this folder":
Click the second "ASK FOR PERMISSION" button:

![Screenshot_20241207-155358.png](../images/setup-wizard/Screenshot_20241207-155358.png)
![Location 2](../images/setup-wizard/Wizard10.png)

Select "Allow all the time".

![Location all the time](../images/setup-wizard/Wizard10-allthetime.png)

Confirm that you wish to grant access to **AAPS** to the selected directory:

![Screenshot_20241207-155833.png](../images/setup-wizard/Screenshot_20241207-155833.png)

Click the "NEXT" button:

![image](../images/setup-wizard/Screenshot_20231202_130031.png)
![Location 2](../images/setup-wizard/Wizard11.png)

## Master password

Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added docs/EN/images/setup-wizard/Wizard01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/setup-wizard/Wizard02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/setup-wizard/Wizard03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/setup-wizard/Wizard04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/setup-wizard/Wizard05.png
Binary file added docs/EN/images/setup-wizard/Wizard06-Memory.png
Binary file added docs/EN/images/setup-wizard/Wizard06.png
Binary file added docs/EN/images/setup-wizard/Wizard07-Confirm.png
Binary file added docs/EN/images/setup-wizard/Wizard07-Folder.png
Binary file added docs/EN/images/setup-wizard/Wizard07.png
Binary file added docs/EN/images/setup-wizard/Wizard08.png
Binary file added docs/EN/images/setup-wizard/Wizard09.png
Binary file added docs/EN/images/setup-wizard/Wizard10.png
Binary file added docs/EN/images/setup-wizard/Wizard11.png
2 changes: 1 addition & 1 deletion docs/EN/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
```{admonition} Latest Release
:class: note
14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions.
31/12/2025 : Version 3.4 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions.
```

Expand Down