GluKaMon is not affiliated with, endorsed by, sponsored by, or supported by Abbot, Dexcom Inc., Medtronic, Hammerhead, SRAM LLC, Nightscout, or Gluroo

Getting Started

To begin using GluKaMon

  1. Set up either Dexcom sharing, Libre sharing, Nightscout, Gluroo, xDrip, or Juggluco and test to make sure it is working (details below)
  2. Install GluKaMon on your Hammerhead Karoo (details below)
  3. Open GluKaMon on your Hammerhead Karoo, and configure the CGM Account Settings and (optionally) the Display and Log settings (details below)
  4. Add GluKaMon Data Fields to a ride profile
  5. How to Add GluKaMon Data Fields
  6. Start a Ride. GluKaMon will automatically start

Start Sharing on Your Dexcom App
  • Open your Dexcom G6 or G7 app
  • Tap the “Share” icon on the home screen or go to Connections > Share
  • Tap “Add” or “Invite Followers”
  • Enter the name and email address of a person you want to share with (this can be yourself)
  • Send the invitation email
Set up the Follow App
  • Open the invitation email on your phone and tap to download the Dexcom Follow app
  • Open the Follow app and accept the invitation
  • Follow the instructions to begin receiving data
Test the Connection
  • Check the follower’s (which could be your own) device to see if the glucose graph is updating

Start Sharing on Your Libre App
  • Open the Navigation Menu. From any screen, tap the “three lines” icon in the upper left corner.
  • Tap Share or Connected Apps
  • Tap Connect or Manage in LibreLinkUp
  • Tap Add Connection
  • Enter Connection information. Enter name and e‐mail address of the person you want to share your glucose readings with (this can be yourself)
  • Tap Add
Set up the LibreLinkUp App

After installing LibreLinkUp app, follow the prompts to create an account and connect:

  • Tap Get Started Now on the Welcome screen
Test the Connection
  • Check the follower’s (which could be your own) device to see if the glucose graph is updating
  • Review and accept the End User License Agreement and Privacy Notice
  • Create an account. Enter your country / region of residence, name, email address and preferred password
  • Go to your email inbox to verify your account and complete setup
  • After you have set up your account, you will see a notification telling you that FreeStyle Libre app / compatible partner product user would like to share their glucose readings with you. Press Accept

Create an Authentication Token (or “Access Token”) for GluKaMon:

  • Click the settings panel (three horizontal bars on the top right) on your Nightscout web site and select Admin Tools
  • Click the “Add New Subject” button
  • Fill in the name of the subject (e.g. “GluKaMon Follower” or whatever you like)
  • Give that subject the role of “readable” (i.e. read-only access to your Nightscout data)
  • Click save; The token will be shown. Write it down, you will need to enter it into GluKaMon’s CGM Account Settings
  • Write down the URL for your Nightscout site, you will need to enter it into GluKaMon’s CGM Account Settings

  • Open the Gluroo mobile application on your smartphone
  • Navigate to the Settings menu
  • Look for the Gluroo Global Connect section to find your unique Nightscout URL and API secret token
  • Write down the URL and the Token, you will need to enter them into GluKaMon’s CGM Account Settings

  • Open xDrip on your phone and tap the top-left menu icon (three bars) to access Settings
  • Navigate to Inter-App Settings
  • Toggle on xDrip Web-Server
  • Check the box for Open Web Server to allow network connections outside of your device
  • Set up a password in the xDrip Web Service Secret. This must be 12 or more characters long (some versions of xDrip will not check this, so be sure to check yourself)

  • Open up Settings
  • Select Exchange Data
  • Select Web Server
  • Enter an API secret
  • Check the “active” box to turn on the web server
  • Save and then Close the settings

Installing GluKaMon on Your Hammerhead Karoo

  1. This method is not an option for the Karoo 1 or Karoo 2
    • Uninstall any prior releases of GluKaMon: On the Home screen, click on the “Extensions” button. Scroll down to find any instances of GluKaMon. Press and hold the icon for GluKaMon. Tap on the Delete Icon or press Button D. You will see a confirmation screen saying “Are you sure you want to Delete”. Tap on the Delete Icon or press Button D. GluKaMon will now be deleted from your Karoo
  2. If it is not already installed, install the Hammerhead app on your phone. The Hammerhead app is available on Google Play Store or App Store
  3. Connect your Karoo to the same WiFi network as your phone
  4. Open the Hammerhead app on your phone and sign in with your SRAM account
  5. On your phone browser, open this page (https://glukamon.com/setup/)
  6. Long-press on the download link at the top of this page (or HERE)
  7. Select the Hammerhead Companion App from the share menu on your phone
  8. You will see a Transferring screen in your Companion app and an Install screen will appear on your Karoo
  9. Click ‘Install’ on the Karoo to finish installing the app

  1. Uninstall any prior releases of GluKaMon: On the Home screen, click on the “Extensions” button. Scroll down to find any instances of GluKaMonPress and hold the icon for GluKaMon. Tap on the Delete Icon or press Button D. You will see a confirmation screen saying “Are you sure you want to Delete”.Tap on the Delete Icon or press Button D. GluKaMon will now be deleted from your Karoo
  2. Create a folder/directory that you want to use for sideloaded apps, e.g. C:\KarooApps for Windows or Documents/KarooApps for Macs
  3. Download the latest release of the GluKaMon.apk into this folder using the download button at the top of this page
  4. Enable USB debugging on your Karoo:
    • Go to Settings → About → Tap “Build Number” 7 times
    • Go to Settings → Developer Options → Enable “USB Debugging”
  5. Connect the Karoo to your computer with a USB cable
  6. Once you have connected the Karoo to your computer, the Karoo may display a message “Allow USB debugging?” If so, confirm that

  1. Download the Android SDK Platform Tools ZIP file for Windows. Currently this is available at https://developer.android.com/tools/releases/platform-tools
  2. Extract the contents of this ZIP file into the folder you created for sideloaded apps
  3. Open File Explorer and browse to where you extracted the contents of this ZIP file
  4. Right-click an empty area of the File Explorer window and choose Open in Terminal. If you have an older version of Windows without Windows Terminal, you need to hold Shift on the keyboard while right-clicking, then choose Open PowerShell window here
  5. In the PowerShell/Terminal window, enter the following command
    • ./adb devices
  6. If everything was successful, you should now see your Karoo’s serial number in the command prompt/Terminal window
  7. Install the APK: In the PowerShell/Terminal window enter the following command
    • ./adb install GluKaMon.apk
  8. You should see the following messages, which indicate that GluKaMon has been installed
    • Performing Streamed Install
    • Success

  1. Download the Android SDK Platform Tools ZIP file for macOS. Currently this is available at https://developer.android.com/tools/releases/platform-tools
  2. Extract the ZIP file into the folder you created for sideloaded apps
  3. Open Terminal
  4. To browse to the folder you extracted ADB into, enter the following command (assuming you created the folder KarooApps in your Documents folder):
    • cd Documents/KarooApps
  5. In the Terminal window, enter the following command
    • ./adb devices
  6. If everything was successful, you should now see your Karoo’s serial number in the command prompt/Terminal window
  7. Install the APK: In the Terminal window enter the following command
    • ./adb install GluKaMon.apk
  8. You should see the following messages, which indicate that GluKaMon has been installed
    • Performing Streamed Install
    • Success

The GluKaMon Settings Menu

Once you have GluKaMon installed, you will need to configure it. Some settings are optional and will use default values, others must be entered before riding with GluKaMon. You should be connected to the internet for the settings menu to work with Dexcom, Libre, Nightscout, or Gluroo, since GluKaMon will connect to their CGM servers to validate your username and password. To use xDrip or Juggluco you need to be on the same WiFi network (e.g. your phone’s WiFi hotspot) as your xDrip or Juggluco server

  1. On the Home screen of your Karoo, click on “Extensions”
  2. Scroll down till you see “GluKaMon.” Select it
  3. The GluKaMon Settings page will indicate “Account Connected” if your CGM account has already been authenticated with your CGM provider and saved. Unless you have changed your account, there is no need to authenticate again
  4. The GluKaMon Settings menu has two sub-menus, one for “CGM Account Settings” and one for “Display and Log Settings”

The “CGM Account Settings” must be entered to use GluKaMon. Select it

  • The GluKaMon CGM Account Settings page will indicate “Account Connected” if your CGM account has already been authenticated with your CGM provider and saved. Unless you have changed your account, there is no need to authenticate again
  • You have a choice of CGM Systems to connect to. Currently GluKaMon directly supports Dexcom Share, Libre Linkup, Nightscout (including Gluroo), and xDrip/Juggluco
    • Dexcom Share: Enter your Username, Password, and Region (US, Japan, or Other). Enter your Dexcom username and password (NOT the username/password of a “follower”) and the region that you are in
    • LibreLinkup: Enter the email of the LibreLinkup account (the follower), Password, First Name, Last Name, and Region if you know it (if you do not, leave it on Auto-detect and GluKaMon will automatically discover the appropriate Libre server region)
    • Nightscout (including Gluroo): You will be prompted for your Nightscout URL and Token. The Nightscout URL is the web site of your Nightscout server, and you do not need to enter the https:// prefix or a port number, just enter the name of the server (e.g. MyNightScoutServer.
      10be.de
      or 8675309.ns.gluroo.com). The Token is the read-only (“readable”) Authentication Token (or “Access Token”) you created on your Nightscout site or the API secret token provided by Gluroo (you can also enter you Nightscout master “API secret”/password instead of a Token)
    • xDrip/Juggluco: You will have a choice of WiFi or Local/Loopback.
      • If you run xDrip+ or Juggluco on your phone and want to connect using a WiFi hotspot select WiFi and enter the URL / IP address of your phone’s WiFi hotspot. You do not need to enter the https:// prefix or a port number
      • The easiest way to find the IP address of your WiFi hotspot is to use the Find server button (new in version 1.1 of GluKaMon.) Click it, and it will look for an xDrip / Juggluco server on the WiFi network your Karoo is connected to, then fills in the address it finds Be sure to do this with your Karoo connected to your hotspot (use the WiFi setting on your Karoo) and not your home WiFi
      • If you have sideloaded xDrip+ onto your Karoo, just select Local/Loopback and GluKaMon will connect to the local xDrip+ running on your Karoo
  • Please read the disclaimer and accept by checking the “I accept” box
  • Once you are done, press the “Authenticate and save” button. GluKaMon will attempt to connect to your CGM servers, authenticate your credentials, start a session, and retrieve at least one glucose value. It will not display this value, it is only used to validate that communication is working before you go out for a ride
    • If GluKaMon is able to do these successfully, you will see messages indicating that you have been authenticated, logged in, and your account information saved (with Dexcom this is a 3 step process, with Libre it is a 2 step process, and with Nightscout / Gluroo, xDrip+ and Juggluco it is just one step, so the messages will reflect that.) If GluKaMon is not able to authenticate, login, or get a sample glucose reading, you will see an error message. Check your credentials for any typos and try again
    • It may take a few seconds for GluKaMon to find and authenticate with your CGM server, especially with Libre where there are multiple regional servers and it is not always clear which one is correct. GluKaMon will make a best guess at the right server region based on what you enter, your location / timezone, and language, and will then try other servers in order from most to least likely. This can take several seconds, and if you have made a typo entering your credentials it will take longer while GluKaMon searches (unsuccessfully) for a server that will accept your credentials
    • If you simply exit the menu (instead of pressing the “Authenticate and save” button) GluKaMon will prompt you to confirm that you really want to exit anyway, or if you want to continue. Press the buttons as appropriate

The “Display and Log Settings” are optional, but you should review them to understand how GluKaMon will operate. Selecting “Display and Log Settings” will allow you to specify:

  • The units you wish GluKaMon to display: Either mg/dL or mmol/L
  • Your Glucose Zone ranges (Very Low Zone, Low Zone, Target Zone, High Zone, Very High Zone): Each range has a lower bound and an upper bound, and is used to determine what color to display your glucose readings (e.g. if a glucose reading is in the Target Zone it will be displayed in green) and to determine the thresholds for generating Messages (which occur when your glucose readings cross from one zone into another.) Glucose zones can’t overlap and must have a minimum of 2 mg/dl range, or .1mmol/L (i.e. an upper bound and a lower bound). GluKaMon will automatically adjust adjacent ranges up or down for you (e.g. if you enter “60” as an upper bound for the “Very Low” zone the lower bound of the “Low” range will automatically be set to 61. This will ripple through the ranges of needed to ensure zones don’t overlap and meet the minimum sizes. If you set a zone higher than the maximum value (400mg/dl or 22.2 mmol/L) it will automatically be reduced to fit, and changes will ripple down as needed, and vice versa if you try to set a zone too low
  • Visual Messages: Specify which Glucose Zone(s) you want Visual Messages to be generated in (i.e. popups visually telling you what Glucose Zone you are in, when your glucose moves from one zone to another)
  • Audio Messages: Specify which Glucose Zone(s) you want Audio Messages to be generated in (i.e. tones on the Karoo speaker when your glucose moves from one zone to another)
  • Graph Scale: Set whether you want the graph Data Fields to display the full range of possible glucose readings (helpful if your glucose has large swings) or a narrower range (easier to see smaller movements in your glucose.)  The choices for Graph Scale are short, medium, and tall, which correspond to:
Graph Scalemg/dLmmol/L
Short40–2002–11
Medium40–3002–18
Tall40–4002–22
DynamicAutomatically scales to fit the actual range Automatically scales to fit the actual range
  • Graph Timeframe: Select whether you want the graph data fields to display readings for the last 30, 60, or 180 minutes
  • Rainbow Scale: Set whether you want the rainbow data fields to display the full range of possible glucose readings or a narrower range. The choices for Rainbow Scale are narrow, standard, and wide, which correspond to the short, medium, and tall ranges for the graph scale.
  • Color
    • In 3-color mode GluKaMon uses red, yellow, and green for the text on data fields with a dark background, darker variations of red, yellow, and green on a light background (to ensure visibility), and the same red, yellow, and green colors for the background of “color” tiles (which use black for the text, for visibility on color backgrounds)
    • In Full Color mode GluKaMon uses a range of reds, yellows, and greens to indicate where in range your glucose values are (e.g. if your glucose values are at the high end of your target zone, the text or background of the data fields showing your readings will be a more yellow tint of green)
    • 3 color (red/yellow/green) has the advantage of being immediately recognizable (but not giving any indication where in the zone your glucose value sits) while Full Color has the advantage of showing you where in the zone your glucose value sits, but is not as immediately obvious
  • FIT File Recording: Record glucose readings to the FIT file for your rides. (A FIT file is a file designed to store and share data from fitness, sports, and health devices, storing time-series data points such as heart rate, power, cadence, etc.) By adding glucose readings, you can analyze your ride using applications such as Intervals.icu. (GluKaMon is not affiliated with, endorsed by, sponsored by, or supported by Intervals.icu.) If Record To FIT is enabled, glucose readings will be written to the ride FIT file as part of ride telemetry. Recordings are for ride analysis only and cannot be relied on for medical decisions. All therapeutic decisions, including medication dosing, must be based on your CGM system or blood glucose meter in accordance with their instructions. If your rides are uploaded to third-party services such as Intervals.icu or others, this data may become visible outside your device. This includes third-party services such as Strava, Ride with GPS, Suunto, Nolio, Sentiero, Trainer Road, Training Peaks, Xert, Intervals.icu, etc., which synchronize with FIT files, even though they may not provide any visualization or analysis of blood glucose. At this time only Intervals.icu provides visualization of your glucose levels
    • FIT file recording only takes place during a ride (i.e. from when you start a ride in the Ride app until you end the ride)
  • Polling Interval: With the exception of Freestyle Libre 3 sensors, most CGMs provide readings every 5 minutes. Libre sensors provide data approximately every minute. GluKaMon can be set to poll at 1 minute intervals, 5 minute intervals, or to dynamically adjust.
    • 1 minute polling: While 1 minute polling will provide you with more timely updates, note that it consumes more of your Karoo’s resources and battery, uses more communications bandwidth, the 1 minute readings are not necessarily more indicative than 5 minute readings, and Libre readings are not consistently available at 1 minute intervals.
    • If GluKaMon is set for dynamic polling, it will start with 1 minute polling, and if it detects that readings are only consistently available every 5 minutes, it will automatically adjust polling to 5 minutes for the duration. If it later detects that 1 minute results are available, it will switch back to 1 minute polling.
    • If actual polling is at 5 minutes (either set that way or dynamically determined) any 1 minute data fields will display the “1m” indicator in the upper left of the data field in italics (“1m“) to indicate that it is not actually receiving data every minute.

Display and Log Settings are automatically saved as you edit (since these settings are all local to GluKaMon there is no need to validate them.) So there is no equivalent button to the CGM Account Settings’ “Authenticate and Save” button

If you don’t edit the Display and Log settings, default values will be used. If an error causes settings to be lost or corrupted, default values will be used (i.e. GluKaMon will continue operating while you ride, with default values.) You can change settings at any time, including mid-ride, and GluKaMon will detect and use your new settings within seconds (although we don’t recommend that you change settings while riding!)

GluKaMon automatically checks your standard Karoo settings and behaves appropriately. This includes:

  • Your location setting, to ensure appropriate number formatting (i.e. commas or periods to show decimal points vs. thousands)
  • Your settings for language and supports English, German, Spanish, French, Italian, Portuguese, Simplified Chinese, Traditional Chinese, Korean, and Japanese. Abbreviated labels including the units labels (e.g. mg/dL) and age of glucose readings (“⏱Xm”) are always in “mg/dL,” “mmol/L,” and “m” to save space
  • Data Fields with a single value are aligned based on your settings. Data Fields with 2 values across are always displayed with those values spread across the Data Field for readability
  • Light and Dark mode
  • GluKaMon automatically checks your settings even while you ride, so if you change your screen from dark mode to light mode mid-ride for example, GluKaMon will automatically adjust

If you find GluKaMon useful, please support me with a contribution. GluKaMon is free, contributions are optional and always appreciated