Anleitung zum Patchen der App "LibreLink" unter Windows mit optionaler Verbindung zu LibreView#

Grundsätzliches:

Wenn LibreLink als erstes "Gerät" mit einem FreeStyle Libre 2 gekoppelt wird, empfängt es permanent Bluetooth-Daten, um den aktuellen Gewebezucker-Wert zu berechnen und ggf. Alarm zu geben. Angezeigt werden diese Daten jedoch nur, wenn "klassisch" gescannt (der Sensor per NFC ausgelesen) wird. Dieser Patch ermöglicht nun, dass xDrip+ die errechneten Werte von LibreLink auslesen und permanent anzeigen kann - ein Scannen per NFC ist nicht mehr nötig.

Um die gepatchte App auf einem Android Smartphone installieren zu können, muss auf selbigem in den Einstellungen das "Installieren aus unbekannten Quellen" erlaubt, bzw. unter neueren Android-Versionen eine entsprechende App berechtigt werden, "unbekannte Apps zu installieren".

Die original LibreLink App muss vor der Installation deinstalliert werden. Dabei geht die Kopplung zum aktuell laufenden Sensor verloren! Sinnvollerweise wird der Wechsel der App daher beim Wechsel eines Sensors durchgeführt. Sobald die gepatchte App installiert wurde, müssen ihr noch Rechte auf "Standort" (für Bluetooth-Nutzung) und "Speicher" gewährt werden (in neueren Android-Versionen unter "Einstellungen - Apps & Benachrichtigungen - LibreLink - Berechtigungen", ansonsten ggf. den Menüpunkt "Alarme" in der App öffnen und prüfen, ob man dort nach Rechten gefragt wird). Danach kann ein neuer Sensor gekoppelt und die App wie gewohnt genutzt werden.

In den neueren Versionen von xDrip+ (ab "Nightly Build" vom 15. Juli 2019 oder später (auf das obere "Assets" klicken und die APK Datei herunterladen)) gibt es in den Einstellungen die Datenquelle "Libre2 (patched App)". Diese ist auszuwählen, um die Werte ohne klassisches Scannen angezeigt zu bekommen. Es kann etwas dauern, bis die ersten Werte in xDrip+ erscheinen.

Hinweise zu dieser Version und zur Verbindung zu LibreView

Die Originalversion der gepatchten App (https://github.com/user987654321resu/Libre2-patched-App) entfernt jegliche Kommunikation der App mit Abbott und damit auch mit LibreView. Ein User in einem Forum hat die Teile des Patches entfernt, die die Kommunikation mit Abbott stillegen, siehe https://insulinclub.de/index.php?thread/31380-libre-2-entschl%C3%BCsselung/&postID=538465#post538465.

Ein weiterer GitHub-User hat die Originalversion um eine deutsche Anleitung und ein paar Skripte ergänzt, die das Erzeugen der gepatchten App automatisieren: https://github.com/TinoKossmann/LibreLink-xDrip-Patch.

Diese Patch-Version baut darauf auf und lässt den Benutzer entscheiden, ob die Verbindung zu Abbott erhalten bleiben soll oder gekappt wird. Dafür fragt das Skript patch.sh nach, welche Teile des Patches angewandt werden sollen.

Wer die Patches von Hand anwenden will, findet sie im Hauptverzeichnis:

• 0001-Add-forwarding-of-Bluetooth-readings-to-other-apps.patch ist nur der Teil, der das Forwarding zu xDrip anschaltet. Dieser Patch ist bis auf einige Whitespace-Änderungen identisch zu dem aus dem Forums-Post.
• 0002-Disable-uplink-features.patch schaltet zusätzlich die Verbindung zu Abbott ab. Dieser Patch muss nach dem ersten Patch angewandt werden, da es ansonsten Konflikte gibt. Vielleicht kann man diesen Patch auch so anpassen, dass die gepatchte App nur ohne Online-Anbindung funktioniert, ohne die Daten an xdrip weiterzureichen, aber das habe ich nicht ausprobiert.

Wenn man beide Patches anwendet, ist das Ergebnis exakt identisch zum Original-Patch.

WICHTIG: Wenn die Verbindung zu Abbott aktiv bleibt, enthält die App einen Lizenz-Check und diverse Firebase-Messaging-Kanäle zurück zu Abbott. Es ist theoretisch möglich, dass Abbott dadurch herausfinden kann, dass die App gepatcht wurde und deshalb die Garantie verweigern (Austausch von defekten Sensoren etc.). Dieses Risikos sollten Sie sich bewusst sein, wenn Sie die Verbindung zu Abbott bestehen lassen!

Vorgehen

Wer Linux nutzt, kann sich an die englische original Anleitung des ursprünglichen Projekts halten oder die hier enthaltene patch.sh nutzen. Für Windows-Nutzer ist folgende Anleitung eventuell hilfreich, welche im Grunde ein Linux SubSystem in Windows installiert und den Patch innerhalb dieses Systems ausführt.

• Installation des Linux SubSystems

In der Windows Systemsteuerung den Punkt "Windows-Features aktivieren oder deaktivieren" wählen (oder dies einfach in der Cortana-Suchleiste eingeben), dort am Ende den Haken bei "Windows-Subsystem für Linux" auswählen und mittels Klick auf "OK" bestätigen. Den anschließend verlangten Neustart unbedingt durchführen. Im "Microsoft Store" die App "Debian" installieren bzw. in der Microsoft Dokumentation zu dem Thema den Link "Debian GNU/Linux" auswählen und durch den Store bis zur Installation führen lassen. Anschließend das SubSystem Debian starten.

• Einrichtung des Linux SubSystems

Beim ersten Start des SubSystems wird nach einem Benutzernamen gefragt, der frei wählbar ist (hier aber bitte nur Kleinbuchstaben verwenden, ggf. Ziffern dahinter - keine Großbuchstaben). Sinnvollerweise nutzt man hier seinen eigenen Windows-Benutzernamen. Ebenso muss ein Passwort für diesen Benutzer vergeben werden. Hier macht es ggf. auch Sinn, das eigene Windows-Passwort zu setzen (muss aber beides nicht zwingend sein). Das Grundsystem ist nun vorhanden und muss mit benötigten Werkzeugen (Tools) versorgt werden. Dazu wird mittels dem Befehl sudo apt-get update die Paketliste auf den neuen Stand gebracht. Das eben vergebene Passwort wird dabei einmal abgefragt und ist einzugeben. Anschließend wird der Git-Client mittels sudo apt-get install git installiert. Die Frage, ob alle aufgeführten Pakete installiert werden sollen, wird bestätigt (Enter/Return-Taste drücken reicht dazu aus).

• Clone dieses Repositories

Mittels git clone https://github.com/smos-gh/LibreLink-xDrip-Patch wird dieses Repository heruntergeladen und anschließend per cd LibreLink-xDrip-Patch in das neue Verzeichnis gewechselt (Tipp: cd Li eintippen und Tabulator-Taste drücken). Bei Bedarf kann nun mit ls -l der Inhalt geprüft werden.

• Installation weiterer Tools

Weitere, benötigte Tools werden nun mittels ./install-apt-dependencies.sh (Tipp: auch hier, ./inst eintippen und Tabulator-Taste drücken) installiert. Sollte auch hier wieder nach einem Passwort gefragt werden, handelt es sich um das vorhin vergebene. Die Frage nach der Paketliste wird wieder bestätigt.

• Laden der original LibreLink App

Wer die original APK-Datei nicht selbst herunterladen möchte, kann diese mittels ./download.sh herunterladen. Dabei wird auch das zusätzlich benötigte Tool apktool installiert, welches im Debian-Repository in einer hier nicht ohne weiteres funktionierenden Version enthalten ist.

• Patchen und Signieren der App

Mittels ./patch.sh wird alles nötige erledigt. Dies nimmt einige Zeit in Anspruch. Normalerweise sollten alle Schritte mit grünem "okay" abgeschlossen werden und am Ende der Hinweis erscheinen, dass die gepatchte APK-Datei im Verzeichnis C:\APK\ zu finden ist. Per exit kann das Fenster nun geschlossen werden.

Video Walkthrough:

In diesem Video ist die Anleitung einmal durchgespielt worden.

Weitere Hinweise:

Die gepatchte App läuft als sog. "Vordergrunddienst". Es ist daher normal, dass oben in der Taskleiste eine "Foreground Service Notification" erscheint.

Die Verbindung zu LibreView bzw. allen Onlinediensten von Abbott wurden entfernt. Beim Aufruf von patch.sh werden Sie gefragt, ob die Verbindung zu LibreView und den anderen Onlinediensten von Abbott entfernt werden soll.

Weiterhin gilt die Einschränkung, dass ein per Smartphone gestarteter Sensor nicht mit dem Lesegerät ausgelesen werden kann. Die Nutzung der gepatchten App und ihrer Vorteile bedeutet also zwangsweise, dass das Lesegerät nicht mehr genutzt werden kann.

Grundsätzliches Vorgehen:

(nur rudimentär, dies soll nur die Anleitung zum Patchen der App sein)

• original LibreLink deinstallieren
• Installation von Anwendungen aus "unbekannten Quellen" auf dem Smartphone erlauben, ggf. sogar "Play Protect" im PlayStore deaktiviern
• gepatchte LibreLink App installieren
• die Rechte "Standort" und "Speicher" für LibreLink erteilen
• Bluetooth einschalten und eingeschaltet lassen (im Flugmodus funktioniert das ganze nicht)
• Alarme in LibreLink aktivieren (ist das wirklich nötig???)
• xDrip in aktueller Version installieren
• "Libre2 (patchted App)" in xDrip als Datenquelle auswählen
• Libre2 Sensor mit gepatchter LibreLink App aktivieren
• in xDrip Sensor "starten"
• eine Stunde warten
• Ruhe- bzw. Stomsparmodus deaktivieren, falls die Werte nachts auch durchgängig erscheinen sollen

---

Original Anleitung in Englisch

How to patch the Librelink app to provide xDrip with Value received by bluetooth directly from sensor

IF YOU WANT TO USE THIS, YOU NEED TO ACTIVATE A NEW SENSOR AFTER THE INSTALLATION PROCEDURE IS COMPLETED, IT DOES NOT WORK WITH ALLREADY ACTIVATED SENSORS!!

Already activated sensors will also stop sending alarms to the handset device if they had been activated with the unpatched phone app.

Get the APK and Tools

1. Load the Version 2.3.0 of the freestyle Libre App DE, for example from here or here (The German version does have english language, don't worry.)

2. [OPTIONAL] If you want to check if your Version is correct, check the MD5 (for windows you might need to get an App like: http://www.winmd5.com to perform md5 checksumming). The Checksum should be: 420735605bacf0e18d2570079ebaa238

3. Load the apkTool and install it as described here. It seems that the current 2.4 Version of Apktool has some problems on Windows, please download and install an older 2.3 Version if you are using Windows!

4. Open a CMD-Prompt (windows) or Shell (*nix) where you downloaded the apk (e.g. your download folder)

5. Use the apktool: apktool d -o librelink [FILENAME_OF_THE_DOWNLOADED_APK]

6. You should now have a folder named librelink with all the extracted files of the application

7. Copy the patch Files from this repository to the same location as the librelink folder (you should now have a directory with at least the following files/folders: librelink, xdrip2.git.patch, sources and xdrip2.patch)

Patch Application

Use either of the two methods:

OPTION 1: patch method

1. For Windows, get the patch tool from here and install it correctly. Mac, Linux and *nix should have patch onboard, if not install from your trusted repository.
2. Change in the prompt/shell into the librelink folder
3. Use the Patch tool with the patch: patch -p1 --binary --merge < ../xdrip2.patch. for Windows patch -p1 --binary --merge < ..\xdrip2.patch. Be sure to use CMD-Prompt and not PowerShell,a s PowerShell does not support < operation.

OPTION 2: git apply method

1. Get your git client ready. For windows install something like this
2. Change in the prompt/shell into the librelink folder
3. Use igt to apply the patch: git apply ../xdrip2.git.patch, for Windows git apply ..\xdrip2.git.patch

Add Files

1. In your Filebrowser navigate within the librelink folder to the path smali_classes2/com/librelink/app/
2. Copy the following Files from the sources folder of this repository to this folder:
   1. ThirdPartyIntegration.smali
   2. ForegroundService.smali
   3. CrashReportUtil.smali
   4. APKExtractor.smali
3. Rename the Downloaded APK to original.apk
4. Copy the original.apk into the Folder assets in the librelink folder

Rebuild the APK

1. In the Prompt/Shell move into the folder, which contains the librelink folder
2. Use apktool to rebuild the APK: apktool b -o librelink.apk librelink
3. Generate a Signing keystore: keytool -genkey -v -keystore librelink.keystore -alias librelink -keyalg RSA -keysize 2048 -validity 10000
   1. Fill in the necessary informations. You must enter two passwords, one for the keystore, one for the key, you should note them down! I prefer to use rather simple passwords like both times librelink as this keystore is only for the resigned app
   2. If this fails, please install current java developer tools like this
   3. If you need to update the App later, omit this step, as the keystore is now available.
4. Sign the APK: jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore librelink.keystore librelink.apk librelink. If the jarsigner is not found in Windows, please check that your java variables are setup correctly, like described here

Install the new APK

5. Uninstall the current librelink app on the phone.
6. Copy the generated librelink.apk to your phone (USB, google drive, ... gmail will not work) and install it.

Finished

Open the app, go to "Alarms" and give all necessary permissions that the app requests, or else the first sensor you will start with the app will not transmit any data via Bluetooth!!! As an alternative, you can navigate to the app in your android-settings -> security and enbale there all permission (Location and Files)

If all Steps where succesfully executed, you will have now a patched librelink app, capable of sending its data to xDrip.

Wait for more informations about which Version/Patches you need for xDrip to get the Data to Display!