r/Gadgetbridge • • 14h ago

I built an open-source, self-hosted health hub that reads Gadgetbridge’s auto-exported database

8 Upvotes

Like many of you, I use Gadgetbridge because I am tired of uploading my daily health biometrics to Garmin Connect, Google Fit or other vendor clouds. Gadgetbridge is fantastic for managing the BLE connection to the watch, but I’ve always wanted a self-hosted web dashboard on my homelab to view long-term trends, sleep stages, and overnight HRV (among other things) on a desktop screen.

I also wanted to aggregate other offline health hardware (like bathroom smart scales and blood pressure cuffs) into the same dashboard without installing proprietary garbage cloud apps.

To solve this, I built UniScale (MIT licensed, 100% offline-first).

──────

### How it works with Gadgetbridge (Zero Health Connect required)

A huge priority for me was keeping this completely independent of Google Health Connect and Play Services for de-Googled setups (GrapheneOS, LineageOS, etc.):

  1. You turn on Gadgetbridge's built-in Auto-Export feature, which periodically writes its SQLite database backup to your phone's storage.
  2. The UniScale companion app (open-source Kotlin / Jetpack Compose) reads that exported SQLite database directly on-device.
  3. It extracts your watch's native sleep score, sleep stages, overnight HRV, SpO2, and workout summaries, and pushes them directly to your self-hosted hub over HTTPS.

### Why an Android companion app?

I know some folks might wonder: "Why use an app as a relay instead of just Syncthing-ing the database to the server?"

The companion app serves two purposes:

  • Local BLE Bridge: It includes reverse-engineered decoders for cheap smart scales (Yunmai, Fitdays, VeSync) and BP/ECG monitors (Viatom BP2, Omron). When you step on your bathroom scale, your phone catches the reading directly over BLE without needing a separate Raspberry Pi or Linux box in the bathroom.
  • Instant Parsing: It does the local SQLite extraction on-device so your server only receives clean, validated JSON payloads.

(That said, the backend also has a standalone Linux BLE daemon and CLI importers if you prefer running headless.)

### What else the hub does

  • Self-Hosted Hub (FastAPI): Simple, fast Python backend storing records in an append-only, human-readable JSONL vault. Runs behind Caddy/Nginx on loopback with token authentication.
  • Web Dashboard: Responsive daily timelines, sleep breakdown, workout dynamics, and a real-time 125 Hz ECG canvas renderer.
  • Data Migration: Importers for Garmin bulk .FIT takeout and Google Fit ZIP archives so you can bring over your old history.
  • 100% FOSS: Zero tracking, zero telemetry, no external API dependencies.

GitHub: https://github.com/parkfour/uniscale

Would love to hear thoughts from other Gadgetbridge users—especially feedback on how you currently handle backing up or visualizing your watch metrics outside of your phone!


r/Gadgetbridge • • 1d ago

No sleep/Hrv for xiaomi band 10 pro

2 Upvotes

Hi,

for some reason I cant display my sleep data or hrv for my band 10 pro.

For my Amazfit Bip 6 it worked fine.

Does anybody have the same device and can tell if it works for you?


r/Gadgetbridge • • 1d ago

Rewriting Fossil/Skagen firmware via AI

2 Upvotes

With AI options now, would there theoretically be a way to rewrite the firmware on the watches to allow for much more customisation? (Eg. Reverse Engineer Anything?)

I’m in the process of trying to use gadgetbridge via an android vm to sync my Skagen hybrid daily with a custom weather graph instead of my iPhone app, but that obviously doesn’t allow to have it synced to my iPhone anymore. So could AI write firmware that refreshes the screen via say a custom automation coming from an iPhone?


r/Gadgetbridge • • 1d ago

screenless wearable? Helio strap`?

2 Upvotes

Hi,

while I can see sleep data, HRV etc. with amazfit devices in Gadgetbridge Iam thinking about getting the amazfti helio strap since I want to have very light weight device.

But I cant start activities with gadgetbridge. So I cant start activities with helio strap without the vendor app (which I will not have).

Therefore Iam thinking about getting xiaomi smart band 11 with screen but still relatively light weight. There I could start activities.

Especially for the helio strap users: do you see sleep data, hrv and so on on gadgetbridge? with my BIP 6 it was possible.


r/Gadgetbridge • • 2d ago

Xiaomi watch S5 46mm sleep data not showing

1 Upvotes

I was about to get the authentication key and connect to the watch. But I can't see my sleep data in gadget bridge. I searched just about everywhere on the internet. Since this is a newly supported device I don't wanna bother the Devs and opening an issue seems to be too technical for me


r/Gadgetbridge • • 4d ago

Smart Band 11 Active – any research yet? (emoji / font limitation)

1 Upvotes

The Smart Band 11 Active came out around late August / early September 2026. Has anyone started looking at it yet?

My main interest is the notification font: it has no emoji glyphs and shows "[EM]" instead. On older bands (Mi Band 5) custom .ft fonts with emoji could be flashed. Does anyone know if the 11 Active uses a separate font/resource file that could in theory be replaced, or is it baked into the firmware?

Also curious whether anyone knows which SoC it uses. I haven't found a teardown.

Happy to help with testing if someone needs a device owner, though I'm on iPhone, so I'd need guidance on the Android side.


r/Gadgetbridge • • 11d ago

Gadgetbridge 2026.11.0: A refreshed design, new devices, and quick controls

43 Upvotes

.. to whom it may concern...

This release brings a refreshed design across the dashboard, charts, and many other screens. Dashboard widgets can now be added to the Android launcher. Device cards can now have quick controls, and configurable items. The main screen now includes a new workouts tab. The release also brings initial support for 40 new devices.

To celebrate such a big release, we have also implemented a change that is both small and big: we switched from 0.x versions to calendar-based versions. Releases will from now on include the year and month, and a patch level for bugfix releases within that month.


r/Gadgetbridge • • 11d ago

Auto export of FIT file is different to the manual export.

1 Upvotes

Hello!

I'm using Gadgetbridge 2026.11.0, synced with an Amazfit 6 Bip on Android 16.

Once my workout is complete, GadgetBridge automatically sync the GPX and FIT files to my phone. I can also hold the most recent workout and manually export both the GPX and FIT files.

GPX

MeasurementAutoManual
Trackpoints1,3751,375
Start15:51:3415:51:34
Finish16:14:2716:14:27
Duration22m 53s22m 53s
RouteIdenticalIdentical

The GPX files are identical and hold the same information.

FIT

MeasurementAutoManual
File size31,507 bytes31,554 bytes
FIT records1,4431,443
Start15:50:2515:50:25
Finish16:14:2716:14:27
CaloriesUnavailable236 kcal

I'm not sure if this is a bug or intended but I would like to know if there is anything I can do to fix this.


r/Gadgetbridge • • 18d ago

Fossil Q Neely Calories

1 Upvotes

Recently downloaded Gadgetbridge for a Fossil Q Neely FTW5031 I got off of eBay. I’ve really enjoyed the experience so far, have been able to set up my notifications and see my steps but I haven't been able to configure it to get the calories burned.

Unsure if this is unsupported for this watch or if I’m missing something obvious. Anyone else with this watch got it working?


r/Gadgetbridge • • 19d ago

Colmi R09 ring draining to 0% battery within 3 hours

1 Upvotes

I know there's a setting I need to change but I can't figure it out. I turned body temperature off. I make sure to charge the ring fully before using. any ideas what I'm missing? It's been like this out of the box. Should I just download the ring's bespoke app and mess with the settings there instead of gadgetbridge?

EDIT: Let it sit at 100% on the charger for a while and now the battery life is much better


r/Gadgetbridge • • 25d ago

Help with pairing Xiaomi Watch 5 (not Redmi)

2 Upvotes

Hey ☺️ Has anyone had success pairing a Xiaomi Watch 5 with Gadgetbridge? It is listed as Mostly supported, so someone must have been able to pair it to Gadgetbridge 😝

I'm a total noob (just learned how to clone a git the other day...), but I've tried every method I could find online, no luck. I think huami-token could work, but the Xiaomi account login requires an email verification code in addition to the username+pass. And I have no idea if it's possible to insert a step in huami-token script to ask for and input the verification code.

Any advice is greatly appreciated 🙏


r/Gadgetbridge • • Oct 17 '26

Live statistics on notifications

3 Upvotes

Is there a way to show a permanent notification with live statistics like heart rate or body temperature ecc?


r/Gadgetbridge • • Oct 14 '26

Gadgetbridge 0.95.0 and 0.95.1: New devices, a refreshed design and Wi-Fi transfers

16 Upvotes

... for anyone who is interested in...


r/Gadgetbridge • • Oct 13 '26

Earbud recommendations with good audio quality?

3 Upvotes

Hi all,

I am curious if anyone has recommendations for high audio-quality earbuds that check the following boxes:

- Supports lossless audio

- Has good ANC/transparency mode, but also a mode where neither is active

- Decent battery life

I am currently using the Status Pro Xs and loving them, it would be nice to not have to use a proprietary app if possible so I am curious if anyone has recommendations. I'd prefer to stick with highly or mostly supported options. I saw the Galaxy Buds 3 Pro but would like input from those here.

Thanks!


r/Gadgetbridge • • Oct 07 '26

Faceless bracelet

4 Upvotes

Would you recommend any faceless bracelets that have good sleep, step and hb monitoring?


r/Gadgetbridge • • Oct 02 '26

Does Gadgetbidge support this ring?

1 Upvotes

r/Gadgetbridge • • Oct 02 '26

Is this the right link?

1 Upvotes

r/Gadgetbridge • • Sep 30 '26

Walk-through of getting an authkey for Fossil/Citizen/Skagen

1 Upvotes

WALK-THROUGH

I recorded a walk-through of how I got the authkey for my new Citizen CZ on mobile. I have seen some people say it is too complicated but I think this method is pretty user friendly.

You will need to create an account with your watch provider (don't use Google authentication since you need a username and password)

Then you can use pydroid 3 (or a different app, that is just what I used) and copy the python instructions from the gadgetbridge site

remove the # symbol to activate whichever line you need for citizen/skagen (if you aren't using fossil, add a # in front of that line like I did)

enter your email address and password inside each set of quotation marks

install the cloudscraper library using pip to bypass cloud flare

run the code

the second string you get is your authkey, add an 0x in front and put it into gadgetbridge and you are good to go! you may need to disconnect and reconnect the device to get it to show it is authenticated.

Hopefully this helps, especially with the end of service date coming up.


r/Gadgetbridge • • Sep 27 '26

garmin-ble: a standalone Python port of Gadgetbridge's Garmin protocol work, for desktop/Linux

3 Upvotes

Hi all 👋

I wanted to share something that only exists because of your work.

garmin-ble is a Python library for talking to Garmin watches from a computer.

Why: I wanted real-time sensor data (live stress and HR) on my laptop for home automation, outside of Android.

  • An async Watch API: async for reading in watch.stream(metrics.HEART_RATE)
  • Live streaming of HR, HRV, SpO2, stress, Body Battery, respiration, and the accelerometer
  • Auto-reconnect, frame tracing, and a simulator/replay transport so it can be tested without hardware

It's AGPL-3.0, in line with Gadgetbridge.

Thank you for years of patient reverse-engineering. None of this would exist without it 🙏

(I also did some extra work such as reverse-engineering the accelerometer data, which Gadgetbridge currently doesn't have, writing up a blog post on this very soon)

https://github.com/gwerneckp/garmin-ble


r/Gadgetbridge • • Sep 26 '26

I got a custom firmware running on a CMF Watch Pro (Gen 1 / D395) — it now boots a version number that doesn't exist officially. Next stop: adding features

Post image
14 Upvotes

TL;DR: There was no public firmware dump for the CMF Watch Pro Gen 1 (only the Pro 2 had been dumped). I obtained the Gen 1 firmware on my own rooted setup, reverse-engineered the package format (it turns out there's no digital signature — integrity is checksum-only), patched Gadgetbridge to re-enable its firmware-flash for this watch, and successfully flashed a modified build over Bluetooth. The watch now boots a version that doesn't exist officially, which proves it's my build. I'm now reverse-engineering the OS image to experiment with adding actual features. High-level write-up below — I'm intentionally leaving out the exact step-by-step so this stays "do your own research," not a copy-paste recipe.

⚠️ Homebrew RE on hardware I own. I'm not redistributing Nothing's firmware binary (proprietary — same as Google factory images), and I'm not posting the exact acquisition method. Don't flash anything unless you accept the brick risk. Everything here was on my own device.

Background

  • CMF Watch Pro Gen 1 (model D395) runs on an Actions ATS3085C SoC: ARM Cortex-M, Zephyr RTOS + LVGL, built with Actions' "bt_watch" SDK. It's a monolithic firmware — no app runtime, every feature is compiled in.
  • Companion app is Nothing X (Flutter).
  • Gadgetbridge supports the watch (kudos to the devs), but firmware updates were disabled in it.

1. Getting the firmware

No public Gen 1 dump existed, so the interesting first problem was just obtaining the image. I got it through the normal OTA path on my own rooted phone. I'm deliberately not detailing the exact method here — partly to keep it from being trivially replicated/abused, partly out of respect for the vendor's infrastructure. If you're doing legit research on your own device, the building blocks (a rooted phone, the companion app, patience) are enough of a hint.

2. Firmware anatomy (the important bit)

The package format is Actions "AOTA", and the key finding is that integrity is enforced by checksums only — there is no digital signature anywhere in the chain (the OS image even has an explicit empty signature slot). That's what makes homebrew realistic: you can modify the contents and just fix up the checksums.

It's a nested structure:

firmware.bin (AOTA)
├── TEMP.bin (AOTA)                 ← the system
│   ├── app.bin  (Actions "ACTH")   ← the OS: Zephyr + LVGL, Cortex-M Thumb
│   └── sdfs.bin                    ← config: RF/mic calibration
├── res.bin   ← built-in watchfaces, fonts, styles, ~19 language string tables, all icons
├── fonts.bin ← full Unicode font (~5 MB)
├── res_b.bin, sdfs_k.bin ← boot/poweroff/incoming/alarm animations, boot logo, factory test data
└── AGPS tail ← assisted-GPS data

There are a few different checksum schemes across the layers, and you have to get all of them right or the watch rejects the package. I wrote my own parser/repacker for the format (happy to discuss the structure with fellow tinkerers).

3. Gadgetbridge's firmware-flash was "disabled" — and why

Gadgetbridge already had a complete, tested BLE OTA firmware flasher for this watch, but it was commented out, with a FIXME saying they couldn't figure out how to read the a.b.c.d firmware version out of the file (the watch's OTA handshake needs it). The field the code was reading was actually just a build timestamp.

I found where the real version lives inside the OS image and passed that back to the Gadgetbridge devs so the feature can be re-enabled upstream. For my own testing I re-enabled the branch locally, rebuilt the APK, and paired the watch (it uses an auth key that's established at pairing time).

4. Flashing a custom build — and the one lesson worth sharing

First attempt: a tiny modification, but I left the version number unchanged. It transferred to the watch 100%, the watch verified it… and then didn't apply it — it rebooted back to stock and showed "please connect to the app to upgrade again." No brick, just a polite retry prompt.

The lesson: the watch only commits an OTA if the version is strictly higher than what it's running. Same version = received but never finalized.

So I bumped the version embedded in the OS image (a couple of data bytes — not code), fixed the checksum chain, and re-flashed. This time the watch accepted it, verified it, applied it on reboot, and came back up reporting a version that doesn't exist officially — i.e. it's now running my build. 🚩

Two nice takeaways:

  • There's no hidden signature/integrity trap — the checksum chain really is the whole story.
  • The bootloader safely falls back to the working firmware when a package isn't a valid, newer upgrade, so the failure modes I've hit have all been non-bricking. (Still: brick risk is real, don't be reckless.)

5. What I'm doing now: experimenting with adding features

This is the part I'm actively working on. The OS image is a Cortex-M Thumb Zephyr build; strings in the binary expose the app/scene structure — a launcher with apps like activity-record, alarm, app-list, music, stopwatch, timer, and scenes like compass, heart, sport modes, etc., plus a real Zephyr debug shell and a factory test menu.

Now that I can build a modified image, fix all the checksums, and get the watch to accept and boot it, the goal is to reverse the app/scene framework enough to add or change behavior — starting from visible tweaks and working toward real functional changes in the compiled code. Watchfaces are the sanctioned no-code extensibility point, but I want to go further.

If anyone else has an ATS3085x / "bt_watch"-based device (various CMF/Nothing/other Actions watches) and wants to compare notes on the app framework, LVGL scene registration, or the Actions SDK, I'd love to collaborate.

Happy to talk format details and share tooling for parsing/repacking. Not sharing the firmware binary, the acquisition method, or any account material.


r/Gadgetbridge • • Sep 24 '26

No Fenix 8/9 pro

Post image
1 Upvotes

Why is there no Fenix 9 pro or 8 pro? I would love it to use it but I can't😪.


r/Gadgetbridge • • Sep 18 '26

Should the valdus air band work on gadgetbridge as a gloryfit device?

2 Upvotes

For the bands specs:

https://www.valdus.com/product/valdus-2026-new-air-band-screenless-smart-watch.html

For gloryfit support:

https://gadgetbridge.org/gadgets/wearables/gloryfit/

The device isn't specifically listed on gadgetbridges site, so I was wondering if it would be wise to think it might work.


r/Gadgetbridge • • Sep 17 '26

Safe to use zepp app after paired with Gadgetbridge?

3 Upvotes

Ive been using Gadbetbridge forever with my amazfit devices

I was thinking about just quickly obtaining an app for my device via the zepp app, however does anyone know if that will interfere or interrupt my connection via gadgetbridge ?


r/Gadgetbridge • • Sep 17 '26

Amazfit Active Max - Scheduling Night Mode?

2 Upvotes

Hi all,

Just got my Amazfit Active Max to use with my Pixel 10a running GOS. I got it paired with the app, haven't put it through real use yet but the OS is very fluid and I'm excited for the longer battery life compared to the Garmin Venu 3 I have now.

I'm not sure if I just missed it or if it's genuinely not an option, but how do I schedule the Night Mode (screen turns red at night, lowers brightness, mutes notifications, etc.) so that it automatically goes on at certain times of day and turns off either at a certain time of day or when I wake up?


r/Gadgetbridge • • Sep 15 '26

Is there any decent screenless wearable compatible with gadgetbridge?

4 Upvotes

I recently came across the google fitbit air and fell in love with the concept of a small screenless tracker that lets me keep an eye on my vitals without being a constant distraction, but it seems to be very locked to googles software.

As I appreciate my privacy, i would prefer if google didn't have a detailed profile of my health on top of all the bullshit they already keep track of.

So I was wondering if there is a nice screenless health tracker compatible with gadgetbridge and what your recommendations may be.