Das Xiaomi Smart Band 10 mit Gadgetbridge koppeln (unter Fedora Linux)

Wenn du dein Xiaomi Smart Band 10 nicht mit der proprietären Mi Fitness App nutzen willst, hast du wahrscheinlich mitgekommen, dass es die Alternative Gadgetbridge gibt.

Gadgetbridge is a free and open source Android application that allows you to pair and manage various gadgets such as smart watches, bands, headphones, and more without the need for the vendor application. So in short, you can use Gadgetbridge instead of relying on your gadget’s own proprietary app. – gadgetbridge,org

Während ich den Beitrag schreibe, fragte mich meine Freundin, ob es schwer war, meine Antwort: „Der Normi hätte warscheinlich vor 3 Stunden aufgegeben!“ Ich habe nicht ganz drei Stunden gebraucht, aber 2,5 sicher. 🤨

Ich hoffe, dass ich dir mit einer halbwegs sauberen Anleitung die Implementierungszeit verkürze. Lass uns beginnen!

Mi Fitness App innstallieren und Band koppeln

Ja du hörst/siehst/liest richtig. Wir müssen Mi Fitness erst installieren um es loszuwerden.Wie man das macht überlasse ich dir (das schaffst du ohne mich!). Du musst auf jeden Fall ein Konto anlegen, dich mit diesem anmelden, das Band koppeln und es synchronisieren – Einmalig!

Während dieses Vorgangs wird in einer Logdatei der Authentifizierungs-Key erstellt, den wir zum koppeln des Bandes in der Gadgetbridge benötigen. Um dies tun zu können werden wir uns mit adb in das Smartphone einhängen und den Key mit ein Paar befehlen extrahieren.

Installation der android-tools

Um adb nutzen zu können brauchen wir das Paket android-tools. Auf Fedora installierst du es von der Kommandozeile mit:

sudo dnf install android-tools -y

Wenn du eine andere Linux-Distribution nutzt, wir die AI deiner Wahl bestimmt den passenden Befehl kennen.

Verbinden des Smartphones

Stecke dein Smartphone nun mit einem funktionierenden USB-Kabel an deinen PC/Laptop und gehe in die Entwickleroptionen und aktiviere USB-Debugging. Die Entwickleroptionen findest du normalerweise unter Einstellungen > System.

Wenn du die Entwickleroptionen noch nicht aktiviert haben solltest, kannst du es durch mehrmaliges drücken auf die Buil-Nummer-Fläche in Einstellungen > Über dein Smartphone tun. Wenn du oft genug auf die Fläche drückst, steigst du in den Entwickler-Mode ein. Gratulation! Dann wie gesagt, das USB-Debugging aktivieren, siehe oben.

Mit adb den Auth-Key extrahieren

Steigen wir zurück in die Kommandozeile. Im besten Fall hast du die android-tools schon installiert und dein Gerät in den USB-Debugging-Modus gesetzt. Wohoo!

Wir checken erst mal ob unser Gerät erreichbar ist mit dem Befehl:

adb devices

Meine Ausgabe liefert:

List of devices attached
51161JEKB03201	device

Okay, wir haben das Smartphone. Nun hängen wir uns ins Smartphone rein mit dem Befehl:

adb shell

Wir navigieren zu den relevanten Verzeichnis in dem die Logfiles sind:

cd /sdcard/Android/data/com.xiaomi.wearable/files/log

Mit und können die Inhalte des Verzeichnisses einsehen:

ls -la

Du solltest unter anderem diese Files sehen (und ein paar andere).

...
-rw-rw----  1 u0_a279 ext_data_rw 2197353 2026-04-06 21:54 Transfer.device.log
...
-rw-rw----  1 u0_a279 ext_data_rw 5916271 2026-04-06 21:55 XiaomiFit.device.log
...

Mit einen Filterbefehl gehen wir auf die Jagd nach dem Auth-Key:

grep -Eo '(encryptKey|token|authKey|huamiAuthKey)[":= ]+[[:xdigit:]]{32}' XiaomiFit*.log | grep -oE '[[:xdigit:]]{32}'

Als Output erhalte ich den Key. Es ist immer die selbe Zahl – nicht wundern. Diese kommt in der Logfile mehrmals vor. Diese benötigen wir, wie schon oben erwähnt, für die Kopplung.

d2fd6d347c05bdc5aack19cacd3e1975
d2fd6d347c05bdc5aack19cacd3e1975
d2fd6d347c05bdc5aack19cacd3e1975
...

Kopplung des Bandes mit Gadgetbridge

Okay, kommen wir nun zum spannenden Teil. 😬

Wenn du Gadgetbridge öffnest siehst du rechts unten einen Plus-Button zum hinzufügen von Geräten. Wenn du ihn einmal drückst werden dir die verfügbaren Geräte angezeigt. Dein Band sollte auch auftauchen.

Wenn du es mit drücken asuwählst kommen ein paar Pop-Ups die du bestätigen solltest und dann die Abfrage nach dem Auth-Key. Lies erst noch kurz weiter!

Im besten Fall hast du dir den Key via Lieblingsmessanger auf dein Smarthphone geschickt ohne die lange Zahl-Buchstaben-Kombo tippen zu müssen. Tippen wird in die Hose gehen, versprochen, ich habe es für dich getestet.

Wichtig ist nun Folgendes. Du musst vor die extrahierte Zahl eine Null und ein x voranstellen. Das heiß du gibst wie in meinem Fall die folgende Kombo ein (natürlich mit deinem eigenen Key!)

0xd2fd6d347c05bdc5aack19cacd3e1975

Wenn die Kopplung funktioniert hat, kannst du der Mi Fitness App „Goodbey!“ sagen und dich Gadgetbridge, als deine neu Liebliengsapp für die lokale Analyse deiner durch das Band erhobenen Daten, widmen.

Viel Spaß damit!

🐧+⌚=🕊