LibreLinkUp Mode¶

LibreLinkUp mode polls Abbott's LibreLinkUp sharing API for glucose readings from Libre 3 sensors. No third-party apps beyond the Libre 3 app needed — just your LibreLinkUp credentials.

Who Is This For?¶

• Libre 3 users — Libre 3 notifications don't contain glucose values, so LibreLinkUp is the way to get Libre 3 data into Strimma
• Users without xDrip+ or Juggluco — direct connection to Abbott's cloud
• Anyone sharing via LibreLinkUp who wants Strimma's alerts, graph, and Nightscout push

Prerequisites¶

Before setting up LibreLinkUp in Strimma, you need:

1. A Libre 3 sensor actively connected to the Libre 3 app, showing readings
2. LibreLinkUp sharing accepted at least once (see first-time setup below)

First-Time Setup¶

If you've never used LibreLinkUp before, you need to enable sharing once:

1. Open the Libre 3 app
2. Go to Menu > Connected Apps > LibreLinkUp > Manage
3. Tap Add Connection and enter the email address you want to use
4. Install the LibreLinkUp app from Google Play
5. Sign in to LibreLinkUp and accept the sharing invitation
6. Verify that readings appear in the LibreLinkUp app
7. You can uninstall the LibreLinkUp app afterwards — Strimma talks directly to Abbott's API

If you've already set up LibreLinkUp sharing previously, skip straight to configuring Strimma below.

Setup¶

1. Go to Settings > Data Source
2. Select LibreLinkUp
3. Enter your Email and Password
4. Strimma connects immediately and starts polling every 60 seconds

Optionally, configure Nightscout push below the credentials to forward readings to your Nightscout server.

How It Works¶

graph LR
    A[Libre 3 Sensor] -->|Bluetooth| B[Libre 3 App]
    B -->|Upload| C[Abbott Cloud]
    C -->|LibreLinkUp API| D[Strimma]
    D -->|Process & Store| E[Display, Alert, Push]

1. Your Libre 3 sensor sends readings to the Libre 3 app via Bluetooth
2. The Libre 3 app uploads readings to Abbott's cloud
3. Strimma polls the LibreLinkUp API every 60 seconds
4. New readings are validated (18–900 mg/dL), direction is computed locally, and readings are stored
5. Readings are displayed, alerts fire, and optionally pushed to Nightscout and Health Connect

Regional Support¶

LibreLinkUp uses regional API servers. When you log in, Strimma automatically detects your region and redirects to the correct server. Supported regions:

• EU (eu, eu2) — Europe
• US — United States
• DE — Germany
• FR — France
• AP — Asia Pacific
• AU — Australia
• CA — Canada
• JP — Japan

No manual configuration needed — region detection is transparent.

Connection Status¶

When connected and receiving data, no status text is shown — the reading's own timestamp indicates freshness. Status only appears when something is wrong:

• Connecting... — initial login in progress
• Connection lost Xm — last poll failed, showing how long ago

Token Refresh¶

LibreLinkUp auth tokens expire after approximately 60 minutes. Strimma automatically re-authenticates every 50 minutes to avoid interruptions. This is seamless — you won't notice it.

Nightscout Push¶

Unlike Nightscout Follower mode, LibreLinkUp mode supports pushing to Nightscout. This lets you:

• Share your Libre 3 data with caregivers via Nightscout
• Use Nightscout reports and analysis tools
• Feed data to downstream apps (Springa, watchfaces, etc.)

Configure the Nightscout push URL and API secret in Settings > Data Source below your LibreLinkUp credentials.

Timestamp Handling¶

Strimma uses the FactoryTimestamp field from the LibreLinkUp API, which is always in UTC with a consistent M/d/yyyy format across all regions. This avoids the date ambiguity problem that the regional Timestamp field has (where 3/5/2026 could mean March 5 or May 3 depending on region). Both 12-hour (AM/PM) and 24-hour time variants are supported.

Troubleshooting¶