Dextop is a Python-based Windows desktop widget which displays real-time Dexcom glucose readings using the Dexcom Share service API provided by pydexcom.

The app is a personal project, which was motivated by a need to keep an eye on my glucose levels while working, without having to constantly check the phone application. The project is still work in progress.

• Always-on-top, unobstructing widget
• Real-time Dexcom glucose readings
• Graphical settings interface
• Position and size customisation and configurability

• Python 3.12
• pip 24.1.1
• Windows operating system

1. Clone the repository:

 git clone https://github.com/pFornagiel/dextop.git
 cd dextop

2. Run the venv_setup batch script from the project`s root folder to create a virtual environment and install dependencies:

scripts/venv_setup.bat

3. Activate the virtual environment:

  .venv\Scripts\activate

4. Run Dextop.py file

Nuitka is the package of choice for the project, when it comes to compiling python files to an independent executable. I have provided a batch script to further simplify this process.

1. Clone the repository:

 git clone https://github.com/pFornagiel/dextop.git
 cd dextop

2. Run the venv_setup batch script from the project`s root folder to create a virtual environment and install dependencies:

scripts/venv_setup.bat

3. Run the nuitka_compile batch script from the project`s root folder to compile the project into an executable file

scripts/nuitka_compile.bat

4. Dextop.dist directory will be created, where an executable Dextop.exe file can be used to launch the application.

The Releases tab provides the windows installer download link. The installer itself was created using InstallForge and, as said above, it installs an exact build of the project as available in the repository. The installer provides step-by-step instructions and installs the compiled build in user's directory of choice.

Additionally, at the end of installation, a powershell script which creates a shorcut of Dextop.exe at startup directory is run. The procedure allows for running the app at startup. This behaviour can be disabled by deleting the shortcut from startup directory or disabling it using Task Manager in Startup Apps tab.

Note, that running the installer may trigger Windows protected your PC window. It is a standard windows security measure, which is triggered when unknown executable is run. In order to proceed with the installation, click the More Info button and choose Run anyway option.

The pydexcom's repository gives detailed instructions about the user-end usage of Dexcom Share API and I highly encourage to read it through.

A quick summary and step-by-step instructions:

1. Download the Dexcom G7 / G6 / G5 / G4 / One+ mobile app and enable the Share service.

2. In the application, log in using your Dexcom Account credentials, not the Dexcom Share follower's or manager's.

3. Make sure to toggle the Europe checkbox in the app settings, if you happen to use the application outside of America. Note, that Password not valid! error may be caused by this option, if the user happens to be using the app in the wrong region.

To access Dexcom readings, the app needs to be provided an internet connection. After logging in, the widget can be configured using a tray icon associated with it (an icon in the bottom-right corner of the taskbar). By right clicking the icon, a set of options will be shown:

• Size, allows for choosing one of available sizes for the widget.
• Draggable, allows for moving the widget around the screen. When the option is disactivated, the widget is semitransparent, uninteractable and click-trough. After toggling On the option, the widget stops being transparent and can be dragged around using the mouse. Position the widget on the screen while Draggable option is On and when you are satisfied, toggle it Off to save its new location.
• Reset Position, resets widget's position to default (bottom-right corner of the screen).
• Settings, opens Settings window, where user credentials and other options can be set.
• Close, closes the applicaiton.

The app makes use of %appdata%/dextop directory, which stores the following files:

• settings.ini configuration file
• logs of encountered errors

I am utilizing the Dexcom Share API solely for personal use and do not have any affiliation with Dexcom, Inc. This application is not endorsed, sponsored, or managed by Dexcom, and I do not take any responsibility for the accuracy or performance of the data provided through the API. Furthermore, I do not profit from, or claim ownership of, any Dexcom-related content or services. All trademarks, logos, and brand names belong to their respective owners.