Skip to content
This repository was archived by the owner on Feb 22, 2026. It is now read-only.

Commit f6b28fa

Browse files
authored
Merge pull request #31 from maheini/dev
Dev Former-commit-id: 236cc89
2 parents b595e2b + df90380 commit f6b28fa

File tree

9 files changed

+288
-155
lines changed

9 files changed

+288
-155
lines changed

Juggluco-solution/juggluco-direct-instructions/de/instructions.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -124,9 +124,9 @@ Nach einem Sensorwechsel wird xDrip+ den neuen Sensor automatisch erkennen und a
124124
- In AndroidAPS gehe zu Config Builder -> BG Source und wählen "xDrip+".
125125
- Wenn AndroidAPS keine Werte empfängt, wenn sich das Telefon im Flugmodus befindet, verwende "Identify receiver".
126126

127-
## Zurück zur originalen Libre 3 App wechseln
127+
## Von Juggluco zurück auf die Libre App wechseln
128128

129-
Es ist möglich, von Juggluco auf die oroginale Libre 3 App zurück zu wechseln. Folgende Schritte sind notwendig:
129+
Es ist möglich, von Juggluco zurück zur Libre 3-App als Empfänger zu wechseln. Folgende Schritte sind notwendig:
130130

131131
1. Libre 3 App neu installieren (Oder Daten löschen in den Einstellungen)
132132
2. Libre 3 App einrichten mit dem Libreview Konto, mit welchem der Sensor aktiviert wurde.
@@ -150,6 +150,7 @@ Bitte beachte, dass der Ortungsdienst eine zentrale Einstellung ist. Es handelt
150150
- Der Android-Ortungsdienst wird nicht erlaubt - bitte aktiviere ihn in den Systemeinstellungen
151151
- automatische Uhrzeit und Zeitzone nicht eingestellt - bitte ändere die Einstellungen entsprechend
152152
- Bluetooth ist ausgeschaltet - bitte einschalten
153+
- Vergewissere dich, dass der Libre 3 Sensor mit keinem anderen Gerät verbunden ist.
153154

154155
### Fehlerbehebung Juggluco keine Messwerte
155156

@@ -159,6 +160,7 @@ Bitte beachte, dass der Ortungsdienst eine zentrale Einstellung ist. Es handelt
159160
- Prüfe ob eine Sensornummer in Juggluco ersichtlich ist
160161
- Üblichweise wird der Sensor innerhalb von 3 Minuten mit dem Smartphone verbunden, kann aber auch länger dauern.
161162
- Kann die Bluetooth Verbindung nicht hergestellt werden, dann versuch einen Neustart vom Smartphone.
163+
- Vergewissere dich, dass der Libre 3 Sensor mit keinem anderen Gerät verbunden ist.
162164

163165
### Fehlerbehebung Blutzuckerwerte werden nicht auf Libreview hochgeladen
164166

Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
# Freestyle Libre 3 instructions
2+
3+
## Information
4+
5+
The Freestyle Libre 3 system can automatically report dangerous blood glucose levels. The Libre3 sensor sends the current blood glucose value to a receiver (reader or smartphone) every minute. The receiver triggers an alarm if necessary. With the help of the Juggluco app, the sensor can be taken over after the start and connected to Xdrip+, AndroidAPS or Libreview. In this way, the blood sugar values can be transmitted directly. It is even possible to receive historical data from the sensor's memory (two hours of minutely glucose and two weeks of once per 5 minute historical data) to be sent to Juggluco.
6+
7+
The sensor can be calibrated in the range of -40 mg/dl to +20 mg/dl (-2.2 mmol/l to +1.1 mmol/l) to compensate for differences between the bloody reading and the sensor readings.
8+
9+
### Current restrictions
10+
11+
- This solution currently does not work with the US variant of Libre3
12+
- If you have a rooted system, you have to hide it. You can find instructions here: [Link](https://www.reddit.com/r/Freestylelibre/comments/s22vlr/comment/hw2p4th/?utm_source=share\&utm_medium=web2x\&context=3).
13+
(There are several apps to find out if the smartphone is rooted, one of them is e.g. [root-checker.org](https://root-checker.org/))
14+
- The Juggluco app only supports English, Dutch and Italian languages.
15+
16+
## Step 1: Download and set up the Libre3 app
17+
18+
Install the Libre 3 app from the Playstore and open it. On the home screen, click Sign In. Registration with your Libreview account is mandatory - if you don't have one yet, you can create one.
19+
20+
![Libre3 start screen](../images/1.jpg) ![Libreview login](../images/2.jpg)
21+
22+
You must then accept Abbott's Terms of Service. The last one is optional and can also be rejected.
23+
24+
![Libre 3 Term](../images/4.jpg) ![Libre 3 Term](../images/5.jpg) ![Libre 3 Term](../images/6.jpg)
25+
26+
Adjust the app step by step according to your needs. If you see this message about disabling battery optimization, tap "Allow".
27+
28+
![Libre 3 battery optimization](../images/10.jpg)
29+
30+
After setting up the Libre 3 app, you can already activate your first sensor. To do this, scan the sensor as shown and wait for the sensor to warm up within the next 60 minutes.
31+
32+
![Enable Libre 3 Sensor](../images/12.jpg)
33+
34+
## Step 2: Stop Libre 3 app
35+
36+
After the sensor has started successfully and the first sensor reading is visible, you can continue. Now open the settings and select the menu option for "Apps".
37+
38+
![App settings](../images/13.jpg)
39+
40+
You then search for the Libre 3 app. Once you have found it, tap on it.
41+
42+
![Libre 3 app settings](../images/14.jpg)
43+
44+
Now tap "Stop" or "Force stop". The exact button may vary depending on the Android version.
45+
46+
![Exit Libre 3](../images/15.jpg)
47+
48+
If there is another request, you can confirm it with "OK".
49+
50+
![Exit Libre 3](../images/16.jpg)
51+
52+
## Step 3: Install & set up Juggluco
53+
54+
Now install the [Juggluco App](https://play.google.com/store/apps/details?id=tk.glucodata) from the Playstore (version 4.0.1 or higher). With the help of this app, the blood sugar readings can be sent directly to Xdrip and AndroidAPS. For this purpose, the active sensor (which is registered on Libreview) is used within Juggluco. This also explains why a Libreview account is mandatory.
55+
56+
After installing Juggluco, several messages may appear. Allow Juggluco to find, locate and connect nearby devices.
57+
58+
![Allow Juggluco connections](../images/17.jpg)
59+
60+
A request to deactivate the battery optimization may appear as well. Tap "Allow". This is important to keep the app running in the background.
61+
62+
![Disable Juggluco battery optimization](../images/18.jpg)
63+
64+
Tap OK when Juggluco is introduced.
65+
66+
![Disable Juggluco battery optimization](../images/19.jpg)
67+
68+
Now you will see the Juggluco home screen. Click onto the empty space within the upper left half. You can see the approximate position here.
69+
70+
![Open Juggluco Menu](../images/20.jpg)
71+
72+
This menu will open. Here you can select "Settings".
73+
74+
![Juggluco Menu](../images/21.jpg)
75+
76+
This page will then show up. In the selection "1." you have two options:
77+
78+
1. "Send to xDrip" -> With this setting, the blood sugar readings are sent to xDrip. Select "Libre2 patched" or "Libre 2 (patched app)" as the recipient within xDrip.
79+
2. "xDrip broadcast" -> With this setting, the minutely blood sugar reading are sent directly to AndroidAPS. The blood glucose source must be set to "xDrip+" within AndroidAPS.
80+
81+
To start the sensor, choose "2." the "Libreview" checkbox.
82+
83+
![Juggluco Settings](../images/22.jpg)
84+
85+
In the next screen you have to enter your login data for Libreview. It must be the account with which the sensor was activated. Then click on "Get Account ID".
86+
87+
![Connect Libreview](../images/23.jpg)
88+
89+
If everything went well, a multi-digit number should now be visible below the "Resend data" button. This process may take some time - if the number still doesn't appear, check your internet connection and try the previous steps again.
90+
91+
**Note:** If you want to upload blood sugar readings to Libreview, you can check the "Send to Libreview" checkbox.
92+
93+
![Check libreview](../images/24.jpg)
94+
95+
Now it's time to restart the sensor! Go back to the Juggluco home screen and scan your previously activated sensor. The sensor will start and may enter a 60 minute warm-up period again. After the 60 minutes, the readings should be visible on the Juggluco home screen.
96+
97+
![Check libreview](../images/25.jpg)
98+
99+
Done, that's it! If the readings are not visible, you can find more information in the "Experiences and troubleshooting" section.
100+
101+
## Step 4 (optional): Set up xDrip
102+
103+
The blood sugar values are received on the smartphone by the xDrip+ App.
104+
105+
- If not already set up then download xDrip+ app and install one of the latest nightly builds from [here](https://github.com/NightscoutFoundation/xDrip/releases).
106+
- In xDrip+ select "Libre2 (patched App)" as data source
107+
- disable battery optimization and allow background activity for xDrip+ app
108+
- If necessary, enter "BgReading:d,xdrip libre_receiver:v" under Less Common Settings->Extra Logging Settings->Extra tags for logging. This will log additional error messages for trouble shooting.
109+
- In xDrip+ go to Settings -> Interapp Compatibility -> Broadcast Data Locally and select ON.
110+
- In xDrip+ go to Settings -> Interapp Compatibility -> Accept Treatments and select OFF.
111+
- to enable AAPS to receive blood sugar levels (version 2.5.x and later) from xDrip+ please set Settings -> Interapp Settings -> Identify Receiver "info.nightscout.androidaps".
112+
- If you want to be able to use AndroidAPS to calibrate then in xDrip+ go to Settings -> Interapp Compatibility -> Accept Calibrations and select ON. You may also want to review the options in Settings -> Less Common Settings -> Advanced Calibration Settings.
113+
114+
## Step 5 (optional): Start sensor within xDrip
115+
116+
In xDrip+ start the sensor with "Start Sensor" and "not today". It is not necessary to hold the mobile phone onto the sensor. In fact "Start Sensor" will not physically start any Libre 3 sensor or interact with them in any case. This is simply to indicate xDrip+ that a new sensor is delivering blood sugar levels. If available, enter two bloody measured values for the initial calibration. Now the blood glucose values should be displayed in xDrip+ every 5 minutes. Skipped values, e.g. because you were too far away from your phone, will not be backfilled.
117+
118+
Wait at least 15-20 minutes if there is still no data.
119+
120+
After a sensor change xDrip+ will automatically detect the new sensor and will delete all calibration data. You may check you bloody BG after activation and make a new initial calibration.
121+
122+
## Step 6 (for looping only): Configure AndroidAPS
123+
124+
- In AndroidAPS go to Config Builder -> BG Source and check "xDrip+"
125+
- If AndroidAPS does not receive BG values when phone is in airplane mode, use "Identify receiver"
126+
127+
Until now, using Libre 3 as BG source you cannot activate 'Enable SMB always' and 'Enable SMB after carbs' within SMB algorithm. The BG values of Libre 3 are not smooth enough to use it safely.
128+
129+
## Switch back to the Libre app from Juggluco
130+
131+
It is possible to switch back from Juggluco to the Libre 3 app as receiver. The following steps are necessary:
132+
133+
1. Reinstall Libre 3 app (Or clear data in settings)
134+
2. Set up the Libre 3 app with the Libreview account with which the sensor was activated.
135+
3. Stop the Juggluco app in the settings, similar to the Libre 3 app in the instructions.
136+
4. In the Libre 3 menu, click "Start Sensor", select "Yes", "Next" and scan your sensor.
137+
5. The 60-minute warm-up phase should then begin. This is necessary after every change and cannot be skipped.
138+
139+
## Experiences and troubleshooting
140+
141+
### Necessary settings for a successful sensor start
142+
143+
- NFC enabled / BT enabled
144+
- Storage and location permission enabled
145+
- Location service enabled
146+
- automatic time and time zone setting
147+
148+
Please note that the location service is a central setting. It is not about the location permission of the app, which must be set as well!
149+
150+
### Troubleshooting Libre3 no readings
151+
152+
- Android location service is not granted - please enable it in the system settings
153+
- automatic time and time zone not set - please change the settings accordingly
154+
- Bluetooth is switched off - please switch on¨
155+
- Make sure the Libre 3 sensor is not connected to any other device.
156+
157+
### Troubleshooting Juggluco no readings
158+
159+
- Check if the Libre 3 app is stopped.
160+
- Rescan the Libre 3 sensor within the Juggluco app
161+
- Make sure the sensor has been activated with the current Lireview account
162+
- Check if a sensor number is visible in Juggluco
163+
- The sensor is usually connected to the smartphone within 3 minutes, but it can also take longer.
164+
- If the Bluetooth connection cannot be established, try restarting the smartphone.
165+
- Make sure the Libre 3 sensor is not connected to any other device.
166+
167+
### Troubleshooting Blood sugar readings not uploading to Lireview
168+
169+
- Check your internet connection
170+
- Make sure Juggluco is receiving blood sugar readings
171+
- Ensure the "Send to Libreview" checkbox is checked within Juggluco->Settings->Libreview
172+
173+
### Further help
174+
175+
Original instructions: [jkaltes website](http://jkaltes.byethost16.com/Juggluco/libre3/)
176+
177+
Additional Github repo: [Github link](https://github.com/maheini/FreeStyle-Libre-3-patch)

README.es.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,39 +4,32 @@ Este texto está auto traducido. debes leer la versión en inglés o en alemán
44

55
<a href="README.md"><img alt="EN" src="https://user-images.githubusercontent.com/65506676/190852356-073bf576-6e3a-45f3-a658-be1c4a8d7286.png" width="18px" /> Léame en inglés</a>
66

7-
Repo público para impulsar el desarrollo de Libre 3. Este repo debe ser utilizado para intercambiar información sobre Libre 3. Los posibles objetivos son el descifrado y la creación de una interfaz para Xdrip.
7+
Repositorio público para impulsar el desarrollo de interfaces de Libre 3 para aplicaciones como xDrip+ o AndroidAPS. Este repositorio está destinado al intercambio de información sobre las soluciones actuales, así como el Libre 3.
88

99
## Descargo de responsabilidad
1010

11-
El uso de la información y la aplicación de github.com es a su propio riesgo y sin garantía o apoyo formal de ningún tipo. este proyecto no tiene ninguna asociación con y no está respaldado por Abbott.
11+
El uso de la información y la aplicación de github.com es bajo su propio riesgo y sin ningún tipo de garantía o soporte. Este proyecto no está afiliado ni respaldado por Abbott.
1212

1313
## Solución Juggluco
1414

15-
Un enorme agradecimiento a [jkaltes](http://jkaltes.byethost16.com/) por todo el trabajo. Con la [new FSTL3 patch](http://jkaltes.byethost16.com/Juggluco/libre3/),
16-
por fin hay una solución offline que no requiere acceso root y está totalmente integrada con Xdrip. puedes encontrar las instrucciones aquí: [Instrucciones para el parche de Libre3 con Juggluco](./Juggluco-solution/instructions/en/instructions.md). O puede utilizar el [enlace de descarga](./Juggluco-solution/versions/latest/Libre-3-patch.apk?raw=1).Tenga en cuenta: Esta solución es bajo su propio riesgo y sin garantía o apoyo formal de ningún tipo. Este proyecto no tiene ninguna asociación con Abbott ni está respaldado por ella.
15+
Muchas gracias a [jkaltes](http://jkaltes.byethost16.com/) por todo el trabajo. Con la aplicación Juggluco es posible enviar las lecturas de glucosa en sangre desde el sensor Libre 3 a xDrip+, AndroidAPS, etc. sin conexión y sin raíz. Puede encontrar instrucciones detalladas aquí: [Instrucciones de conexión de Libre 3 con Juggluco] (./Juggluco-solution/juggluco-direct-instructions/en/instructions.md). O puede usar el [enlace de descarga] (./Juggluco-solution/versions/latest/Juggluco.apk?raw=1). Tenga en cuenta: este proyecto es bajo su propio riesgo y sin ningún tipo de garantía o soporte. Este proyecto no está afiliado ni respaldado por Abbott.
1716

18-
Por favor, tenga en cuenta: No estuve involucrado en el desarrollo de Juggluco y el parche final de Libre 3, pero me encanta compartir todo el trabajo de desarrollo que se está llevando a cabo.
17+
## Otras soluciones para FSL 3 (necesita raíz o conexión a Internet)
1918

20-
## Otras soluciones para FSL 3 (requieren root o conexión online)
21-
22-
- Libre 3: Una solución offline -> requiere root y algunos conocimientos, también sólo soporta la aplicación Libre 3 hasta la versión 3.3.1. [Enlace (alemán)](https://insulinclub.de/index.php?thread/33795-free-three-ein-xposed-lsposed-modul-f%C3%BCr-libre-3-aktueller-wert-am-sperrbildschir/)
23-
->Última descarga: [Enlace](https://mega.nz/file/H51h3ILS#65mfhvDvPbtnbdWSOeXHHNxABDD60nP7iODxaDN_QPk)
24-
- Librelink to Nightscout sideloading: [Github repo](https://github.com/timoschlueter/nightscout-librelink-up)
25-
- App (LLU Client) para descargar datos de Linkup y compartir con Xdrip (fuente: Libre 2): [Link (alemán)](https://insulinclub.de/index.php?thread/33987-llu-client/&postID=654144#post654144)
26-
- LinkUpConnect](https://github.com/cmtjk/LinkUpConnect): una alternativa al cliente LLU que puede mostrar BG como notificaciones en Xdrip+.
27-
- Web Follower](https://xdrip.readthedocs.io/en/latest/install/webfollower/): función en la versión nocturna de Xdrip+ (la calibración no es posible)
28-
- En desarrollo para iOS: DiaBLE -> tratando de aprovechar las capacidades de FSTL3. [Github repo](https://github.com/gui-dos/DiaBLE)
19+
- Free Three: una solución fuera de línea -> requiere root y algunos conocimientos, y solo se admite la aplicación Libre 3 hasta la versión 3.3.1 [Enlace (alemán)] (https://insulinclub.de/index.php?thread /33795-free-tres-ein-xposed-lsposed-modul-f%C3%BCr-libre-3-aktueller-wert-am-sperrbildschir/)
20+
-> Descarga más reciente: [Enlace] (https://mega.nz/file/H51h3ILS#65mfhvDvPbtnbdWSOeXHHNxABDD60nP7iODxaDN_QPk)
21+
- Librelink a la carga lateral de Nightscout: [Github repo](https://github.com/timoschlueter/nightscout-librelink-up)
22+
- Aplicación (Cliente LLU) para descargar los datos de enlace y compartirlos con Xdrip (fuente de azúcar en sangre: Libre 2): [Enlace (alemán)](https://insulinclub.de/index.php?thread/33987-llu- cliente/&postID=654144 #post654144)
23+
- [LinkUpConnect](https://github.com/cmtjk/LinkUpConnect): una alternativa para LLU Client, que puede mostrar la glucosa en sangre como notificación (sin Xdrip+).
24+
- [Seguidor web] (https://xdrip.readthedocs.io/en/latest/install/webfollower/): función en la versión nocturna de Xdrip+ (las calibraciones no son posibles)
25+
- En desarrollo para iOS: DiABLE -> Intenta ampliar las posibilidades de FSTL3. [Repositorio de Github](https://github.com/gui-dos/DiaBLE)
2926

3027
## Estado actual
3128

32-
El descifrado se acaba de romper :smiley:. Por fin hay una solución para teléfonos no rooteados, que funciona con Android y Xdrip.
29+
El descifrado se descifró con éxito :smiley:. Ahora hay una solución final para dispositivos no rooteados que funcionan con Android y Xdrip.
3330

3431
## Cómo contribuir
3532

36-
Si tienes alguna información útil sobre Libre 3, compártela en la pestaña [discusiones](https://github.com/maheini/FreeStyle-Libre-3-patch/discussions).
37-
38-
## Información de encriptación
39-
40-
Las siguientes cosas son conocidas sobre la aplicación Libre 3: Después de iniciar, la aplicación se comprueba si hay alguna modificación. Allí se utiliza la protección de código WhiteCryption.
33+
Si tiene información útil sobre Libre 3, compártala en la [pestaña de discusiones] (https://github.com/maheini/FreeStyle-Libre-3-patch/discussions).
4134

4235
### #WeAreNotWaiting

0 commit comments

Comments
 (0)