Skip to main content

Setup Guide

Follow these steps to get SugarMon: FL running on your Stream Deck.

Important Warning

This plugin is not affiliated with Abbott or FreeStyle. It is intended for entertainment purposes only - NOT for medical purposes. Do not use this plugin to make medical decisions. The plugin is NOT a medical device and does not make your Stream Deck a medical device. Always follow the advice and instructions of your healthcare provider and device manufacturer.

Prerequisites​

You'll need:

  1. A Freestyle Libre continuous glucose monitor that is collecting data
  2. A LibreLinkUp account that is receiving shared glucose data (details on how to set this up are below)
  3. An Elgato Stream Deck (any model) with the Stream Deck software installed

LibreLinkUp Account Setup​

If you only use the standard Freestyle Libre app, you need to create a secondary account for the background sharing service. If you already have a LibreLinkUp account, you can skip to the Stream Deck Plugin Setup instructions.

Invite a Follower​

  1. Open the FreeStyle Libre app on your phone.
  2. Open the profile menu and go to Connected Apps.
  3. Tap on LibreLinkUp and select Manage.
  4. Tap Add Connection or Invite.
  5. Enter a different email address than the one you currently use for your Libre app (e.g., if your main is john@email.com, use john.streamdeck@email.com). Use a valid email address that you have access to; you will need to verify it later.
  6. Send the invitation.

Create the LibreLinkUp Account​

  1. Check the inbox of that second email address you just invited.
  2. On your phone, click the appropriate link in the invitation email to download the LibreLinkUp app.
  3. Follow the instructions in the LibreLinkUp app to create a new account with the email address you used for the invitation.
  4. Once your account is created and your email address is verified, accept the invitation that will appear in the LibreLinkUp app.
  5. You should now see your glucose readings in the LibreLinkUp app.

Stream Deck Plugin Setup​

Install the Plugin​

  1. Open the Elgato Stream Deck desktop application
  2. Navigate to the Stream Deck Marketplace
  3. Search for "SugarMon: FL" or "SugarMon: FL Pro"
  4. Click the Get or Add to Cart button to install or purchase the plugin

Add to Your Stream Deck​

  1. In the Stream Deck application, find SugarMon: FL or SugarMon: FL Pro in the action list on the right
  2. Drag the Glucose Viewer action onto any Key on your Stream Deck. With the Pro version the action can also be added to a Touch Strip or Dial on Stream Deck+

Configure Plugin​

  1. Click the key you just added to open the Property Inspector panel
  2. Enter your LibreLinkUp email and password
  3. Click Verify to confirm the plugin can connect to the LibreLinkUp service with your credentials. If working, you should see "✓ Verified" and the latest glucose reading from your sensor should appear. If you see an error message, please double-check your credentials and that your LibreLinkUp account is active and receiving data. If you still see an error message, please contact the developer for assistance.
  4. Select the Units to display: mg/dL or mmol/L
  5. (Optional) Enable the progress bar to show time until the next reading

Set Additional Options (Available in SugarMon: FL Pro)​

  • Update Interval: Set a custom polling interval in minutes (1 - 10 minutes)
  • In-Range Color: The color shown when glucose is within your target range
  • Low Color: The color shown when glucose is below range
  • High Color: The color shown when glucose is above range
  • Custom Range Thresholds: Set custom glucose thresholds for what counts as low and high
    • The Low Range Threshold is the glucose value below which readings will be considered "low" and colored with the Low Color
    • The High Range Threshold is the glucose value above which readings will be considered "high" and colored with the High Color
    • Readings between the Low and High Range Thresholds will be considered "in-range" and colored with the In-Range Color
    • If no custom thresholds are set, the plugin will use default thresholds based on typical target ranges (70 mg/dL and 180 mg/dL for mg/dL units, 3.9 mmol/L and 10 mmol/L for mmol/L units). If ranges are provided by the LibreLinkUp service, the plugin will use those instead, unless you have set custom thresholds.
  • Background Opacity: Adjust via the Property Inspector slider or the Stream Deck+ dial
Global vs Local Settings

In order to avoid being locked out of the LibreLinkUp service, requests from your Stream Deck to the service are rate-limited. This means that you can't have multiple instances of the plugin polling the service at the same time. To work around this, some settings are 'global' and apply to all instances of the plugin on your Stream Deck, while others are 'local' and apply only to the specific instance of the plugin.

Your account details and update interval are 'global' settings. Your Stream Deck will only poll the LibreLinkUp service once every 'update interval' minutes, regardless of how many instances of the plugin are on your Stream Deck.

Troubleshooting​

Having issues? Check out the FAQ for common problems and solutions.