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. Select the correct Region for your LibreLinkUp account:
   • US: United States
   • EU: Europe
   • DE: Germany
   • FR: France
   • JP: Japan
   • AP: Asia Pacific
   • AU: Australia
   • AE: Middle East
4. Select the Units to display: mg/dL or mmol/L

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
• 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, update interval, and region 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.