Skip to main content

Setup Guide

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

Important Warning

This plugin is not affiliated with Dexcom. 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 Dexcom continuous glucose monitor that is collecting data and has the option in app to Share data with followers
  2. A Dexcom Share 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

Dexcom Share Account Setup​

If you only use the standard Dexcom app for your CGM, you need to create a secondary account for the background sharing service. If you already have an additional Dexcom account, you can skip to the Stream Deck Plugin Setup instructions.

Invite a Follower​

  1. Open the Dexcom app on your phone.
  2. Look for the Connections settings. Then tap Dexcom Share connection.
  3. Tap on Invite Follower.
  4. Enter a different email address than the one you currently use for your Dexcom 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.
  5. Send the invitation.

Create the Follower 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 Dexcom Follow app.
  3. Follow the instructions in the Dexcom Follow 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, you should be able to accept the invitation.
  5. You should now see your glucose readings in the Dexcom Follow 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: DC" or "SugarMon: DC 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: DC or SugarMon: DC 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 Dexcom Email and Password for your original Dexcom account (not the follower account). The follower account is necessary to set up, but the plugin requires the original account credentials to access the Dexcom Share service.
  3. Select your Geographic Region - US or OUS (Outside US) and preferred units (mg/dL or mmol/L).
  4. Click Verify to confirm the plugin can connect to the Dexcom Share service with your credentials. If working, you should see "✓ Verified" and the latest glucose reading from your sensor should appear soon. If you see an error message, please double-check your credentials and that your Dexcom account is active and sharing to a follower. If you still see an error message, please contact the developer for assistance.
  5. (Optional) Enable the progress bar to show time until the next reading

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

  • In-Range Color: The widget color shown when glucose is within your target range
  • Low Color: The widget color shown when glucose is below range
  • High Color: The widget 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 Dexcom Share service, the plugin will use those instead, unless you have set custom thresholds.
  • Background Color: Set the background color of the key or touch strip
  • 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 Dexcom Share 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 region are 'global' settings. Your Stream Deck will only poll the Dexcom Share service approximately once every 5 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.