A GNOME Shell extension that seamlessly integrates with Dexcom Share to display real-time blood glucose levels in your GNOME top panel.
- Real-time Monitoring: Display current glucose levels directly in your GNOME top panel
- Visual Indicators:
- Dynamic trend arrows showing glucose direction
- Delta values indicating glucose changes
- Elapsed time since last reading
- Color-coded display based on glucose ranges
- Smart Settings:
- Customizable glucose thresholds
- Visual alerts
- Support for both mg/dL and mmol/L units
- Customizable Display:
- One-click manual refresh
- Configurable update intervals
- Toggle delta values, trend arrows, and time display
- Adjustable icon position
- Visit GNOME Extensions
- Search for "Dexcom Blood Glucose Monitor"
- Click "Install"
- Clone this repository:
git clone https://github.com/faymaz/dexcom
- Copy to GNOME extensions directory:
cp -r dexcom ~/.local/share/gnome-shell/extensions/dexcom@faymaz.github.com - Restart GNOME Shell:
- For X11 sessions: Press Alt+F2, type 'r', press Enter
- For Wayland sessions: Log out and log back in
- Enable the extension:
- Using GNOME Extensions app
- Or via command line:
gnome-extensions enable dexcom@faymaz.github.com
-
Access Settings:
- Click the extension icon in the top panel and select "Open Settings"
- Or open GNOME Extensions app and click settings on "Dexcom Blood Glucose Monitor"
-
Available Settings:
- 👤 Account:
- Dexcom Share username and password
- Region (US or Non-US)
- Unit preference (mg/dL or mmol/L)
- Update interval (60-600 seconds)
- 📊 Thresholds:
- Customize glucose threshold values
- Set color schemes for different ranges
- 🎨 Display:
- Toggle delta values
- Toggle trend arrows
- Toggle elapsed time
- Configure icon visibility and position
- 👤 Account:
- Your Dexcom Share credentials are required for operation
- Credentials are stored securely using GNOME's GSettings
- All data is fetched directly from Dexcom servers using HTTPS
- No third-party data collection or transmission
- Open source code available for security review
- GNOME Shell 45, 46, and 47
- Requires active Dexcom Share account with sharing enabled
- Works with both US and Non-US Dexcom servers
- Internet connection required
Check GNOME Shell logs for detailed error messages:
journalctl /usr/bin/gnome-shell -f -o catCommon issues:
- 🔑 Authentication errors: Verify your Dexcom Share credentials
- 📡 No data: Ensure Dexcom Share is enabled in your Dexcom app
- 🌐 Connection issues: Check your internet connection
This project is licensed under the GNU General Public License v3.0.
This software is not affiliated with Dexcom, Inc. The extension is provided "as is" without warranty of any kind. Do not make medical decisions based on this extension. Always verify glucose values using your official Dexcom receiver or app.
- 🐛 Report issues: GitHub Issues
- 💡 Feature requests welcome
- 🤝 Contributions welcome through pull requests