🩸 Blood sugar monitoring made easy: Project CGM glucose data

Projection in Glucose mode

Living with diabetes means keeping a constant eye on your glucose levels. Frixos projects your near-real-time CGM readings onto your ceiling or wall, so you can check your number with a glance when you wake up, go to sleep, or walk past, without picking up a phone.

Frixos works with Dexcom (through Dexcom Share), FreeStyle Libre (through LibreLinkUp) and any Nightscout-compatible server, including Gluroo and Juggluco. This guide is written for firmware 73 (version 2.80). Your clock updates itself, so it is almost certainly on it already: check System → Firmware version on the clock’s web page.

What you’ll see

Out of the box, Frixos shows a coloured drop and a trend arrow next to the time. You can also switch the big digits to your glucose number, alternate between time and glucose, or plot the last few hours on a graph.

Time with a glucose icon

Frixos projection showing the time with a glucose drop icon and trend arrow

The drop changes colour with your latest reading:

  • Green drop Green: in range, between your low and high thresholds
  • Purple drop Purple: high, above your high threshold
  • Red drop Red: low, below your low threshold
  • Gray drop Gray: the last reading is older than your validity window, so don’t rely on it

Next to it, an arrow shows which way your glucose is moving. (Colours are those of the default theme; a custom theme can draw its own icons.)

Your glucose number on the big digits

Frixos projection showing the glucose reading on the main digits

The main digit display can show your latest reading instead of the time, in mg/dL or mmol/L, with the same coloured icon and trend arrow.

You choose what the digits show with the Display Schedule: add a CGM (glucose) slot next to the Time slot and give each a duration, for example 20 seconds of time, then 10 seconds of glucose. Slots cycle in order. A single CGM slot shows glucose all the time.

A graph of the last few hours

Add a Graph to your screen and plot [CGM:glucose]. You set the time span, the scale and an optional low/high band: readings inside the band are drawn in the line colour, readings outside it in the warning colour. When the integration starts, Frixos backfills the recent history from your CGM service, so the graph isn’t empty for the first hours.

The quickest start is the Diabetic preset on the Layout tab: it puts the time, the glucose icon, the trend and a glucose graph on one screen. Adjust it from there and press Apply.

Set it up

Open your clock’s web page (http://frixos.local, or the name you gave it, on the same network) and go to Integrations → Glucose Monitoring.

Frixos web page, Integrations tab: Glucose Monitoring with device type, credentials, region, unit and high/low thresholds
Integrations → Glucose Monitoring on firmware 73.
  • Device Type: Dexcom, FreeStyle Libre or Nightscout. One source can be active at a time.
  • Username / Password (Dexcom and Libre) or Nightscout URL and secret: see the sections below.
  • Region (Dexcom and Libre): the server your account lives on.
  • Display unit: mg/dL or mmol/L, for the number on screen.
  • High / Low: your thresholds for the colours. These are always entered in mg/dL (1–400), even if you display mmol/L. To convert, multiply mmol/L by 18: 10.0 mmol/L is 180 mg/dL, 3.9 mmol/L is 70 mg/dL. Low must be below High.
  • Advanced → Refresh: how often Frixos asks for a new reading, 1–60 minutes. CGMs report every 1 to 5 minutes, so there’s little point going below that.
  • Advanced → Validity: if the newest reading is older than this many minutes, the icon turns gray. It uses the time of the measurement itself, not the time Frixos last checked, so a sensor that stopped sending can’t fool you.

Press Save and give it a minute or two. The status next to Glucose Monitoring changes from Configured — no data yet to Active once the first reading arrives.

Dexcom

Frixos reads your data through the Dexcom Share service.

  1. In the Dexcom app, turn on Share and invite at least one follower. Share stays inactive until it has a follower.
  2. On the clock, choose Dexcom and enter your own Dexcom username (email, phone number or account name) and password: the account paired with the sensor, not a follower’s account.
  3. Pick the region: US, Japan, or Rest of World (Europe, Australia and everywhere else).

FreeStyle Libre

Frixos reads your data the way a LibreLinkUp follower does, so you first share your data with a LibreLinkUp account:

  1. In your Libre app, go to Connected Apps and tap Manage next to LibreLinkUp.
  2. Tap Add connection and invite the email address you want Frixos to use. A separate address just for the clock works well.
  3. Install the LibreLinkUp app, sign in or sign up with that address, and accept the invitation. Accept any terms the app asks you to accept, too.
  4. On the clock, choose FreeStyle Libre, enter the LibreLinkUp email and password, and pick your region. If your account lives on a different regional server, Frixos follows the redirect by itself.

Nightscout, Gluroo and Juggluco

Choose Nightscout and enter the URL of any Nightscout-compatible server:

  • Nightscout (hosted or on your own network): enter your site URL and put your API_SECRET in the password field. Frixos hashes it and sends it in the request header.
  • Gluroo: use the Nightscout-compatible URL from Menu → Settings → Gluroo Global Connect Nightscout. Gluroo puts its token in the URL itself.
  • Juggluco: turn on its web server (left menu → Settings → Exchange data → Web server) and enter that address.

Put glucose on your screen

Everything you see on the projection is arranged on the Layout tab. Drag items from the palette onto the 128 × 128 canvas, or start from a preset.

Frixos layout editor: presets, save to device, the 128x128 canvas and the palette
The Layout tab: presets at the top, the canvas, and the palette with Glucose Level and Glucose Trend.
  • Glucose Level: the coloured drop.
  • Glucose Trend: the arrow.
  • Digit Display → Display Schedule: add a CGM (glucose) slot to show the number on the big digits.
  • Graph: plot [CGM:glucose] with a low/high band.
  • Scrolling Message or a Text line: mix glucose tokens with anything else.

The glucose tokens:

  • [CGM:glucose]: the reading with change and time, for example 157 mg/dl (+3 @ 12:01)
  • [CGM:reading]: just the number, for example 157
  • [CGM:time]: when it was measured, for example 12:01pm

You can combine them with weather, Home Assistant or stock tokens in the same line, for example BG [CGM:reading] · Out [temp]. Press Apply to send the layout to the clock. The ? button next to the palette explains every item.

Privacy

Your credentials are stored on the clock itself and are only sent to the service you chose (Dexcom, Abbott’s LibreLinkUp or your Nightscout server). Dexcom and LibreLinkUp are always reached over HTTPS. Nothing passes through our servers.

Troubleshooting

Start with System → System Logs and System → Integration Status on the clock’s web page. Frixos writes a clear message there for each kind of problem.

  • Wrong credentials: check the username and password, and that the region matches your account. For Dexcom, use the sensor owner’s account, not a follower’s.
  • Libre: accept terms in the LibreLinkUp app: Abbott sometimes asks for new terms to be accepted. Open the LibreLinkUp app with the clock’s account, accept, and the clock logs in on its next try.
  • Libre: account locked: too many failed logins. Wait for the lock to expire before trying again. After a rejected login, Frixos pauses instead of retrying, so a typo can’t get the account locked, and a short network hiccup doesn’t trigger a new login either.
  • Libre: app version too old: the service now expects a newer client. This needs a firmware update on our side; write to us and we’ll get one out.
  • Gray icon: the newest reading is older than your validity window. Check that the sensor is active and that the CGM app on your phone is uploading.
  • Gaps in the graph: if a history download fails partway, Frixos discards the partial data rather than drawing an incomplete curve, and fills it in on the next successful fetch.

Still stuck? Use System → Diagnostics → Send email to send us the clock’s status and logs, or contact support.