Professional glucose monitoring for Hammerhead Karoo cycling computers
An Android application that fetches real-time blood glucose data from Nightscout servers and displays it as custom data fields on Hammerhead Karoo, Karoo 2, and Karoo 3 devices. Brought to you by Enhance-d Club.
This is an OPEN SOURCE application intended for informational and educational purposes ONLY.
- NOT for medical diagnosis, treatment, or decision-making
- NOT a replacement for professional medical advice
- NOT for emergency medical situations
- NOT for life-critical diabetes management decisions
- This software is provided "AS IS" without warranty of any kind
- The developers and contributors are not medical professionals
- Code is publicly available and may be modified by anyone
- No regulatory approval has been sought or obtained
- You assume all risks associated with using open source medical software
- You understand this is experimental open source software
- You will not use this app for medical treatment decisions
- You accept full responsibility for any consequences of use
- You will consult healthcare professionals for all medical advice
- You understand the limitations of open source medical tools
Always consult qualified healthcare professionals for medical decisions.
- Real-time glucose monitoring from Nightscout servers
- Multiple data fields for comprehensive glucose tracking
- Color-coded display based on glucose levels
- Direction indicators showing glucose trends
- Time tracking since last update
- Delta calculations for 5m and 15m changes
- Glu. mg - Blood glucose in mg/dL
- Glu. mmol - Blood glucose in mmol/L
- Time Since (s) - Seconds since last reading
- Time Since - Formatted time (h:m:s) since last reading
- Direction - Glucose trend with arrow indicators
- 15m Ξ mg - 15-minute glucose change in mg/dL
- 15m Ξ mmol - 15-minute glucose change in mmol/L
- 5m Ξ mg - 5-minute glucose change in mg/dL
- 5m Ξ mmol - 5-minute glucose change in mmol/L
- ββ "DoubleDown" - Rapidly falling
- β "SingleDown" - Falling
- β "FortyFiveDown" - Slowly falling
- β "Flat" - Stable
- β "FortyFiveUp" - Slowly rising
- β "SingleUp" - Rising
- ββ "DoubleUp" - Rapidly rising
- Active Nightscout website with glucose data
- Hammerhead Karoo, Karoo 2, or Karoo 3 device
- Active data connection (WiFi or cellular)
- USB debugging enabled on Karoo device
- Estimated usage: ~1MB per hour of ride time
- Data charges may apply depending on your cellular plan
- WiFi recommended when available
- Download the APK from the latest release
- Install the Hammerhead app on your phone:
- Available on Google Play Store or App Store
- Connect your Karoo device to the same WiFi network as your phone
- Open the Hammerhead app and sign in with your Hammerhead account
- Navigate to Device Settings in the app
- Select "Install APK" or "Transfer APK" option
- Upload the downloaded APK file to your Karoo device
- Follow the on-screen instructions to complete installation
- Download the APK from the latest release
- Enable USB debugging on your Karoo device:
- Go to Settings β About β Tap "Build Number" 7 times
- Go to Settings β Developer Options β Enable "USB Debugging"
- Connect via USB to your computer
- Install the APK:
adb install app-debug.apk
- Clone the repository:
git clone https://github.com/henryaspden/Enhance_d_Club_Glucose_Karoo.git cd Enhance_d_Club_Glucose_Karoo - Build the project:
./gradlew app:assembleDebug
- Install on device:
./gradlew app:installDebug
- First-time installation: You may need to enable "Install from Unknown Sources" in your Karoo's security settings
- App permissions: The app will request necessary permissions on first launch
- Medical disclaimer: You must accept the medical disclaimer before using the app
- Updates: For app updates, uninstall the previous version before installing the new one
- Launch the app from your Karoo's app drawer
- Accept the medical disclaimer (required on first launch)
- Configure your Nightscout URL:
- Format:
https://yoursubdomain.yourdomain.tld/api/v1/entries/sgv.json - Example:
https://mybloodglucose.herokuapp.com/api/v1/entries/sgv.json - Local:
http://127.0.0.1:17580/sgv.json(for local setups)
- Format:
- Configure API Token (optional):
- If your Nightscout server requires authentication
- Enter your API token in the Settings β API Token section
- The token will be stored securely and visible in the interface
- Use the toggle to hide the token for privacy if needed
Nightscout tokens are authentication credentials that allow secure access to your Nightscout site. They act like a "key" that grants specific permissions to access your glucose data.
You need a token if:
- Your Nightscout site is not publicly accessible (most common)
- Your site requires authentication to view data
- You want to restrict access to specific users
- Your site uses
AUTH_DEFAULT_ROLESset todenied
You don't need a token if:
- Your Nightscout site is publicly accessible
- Your site allows anonymous read access
- You're using local xDrip+ without authentication
To create authentication tokens for your Nightscout site, follow the official Nightscout documentation:
- Access Admin Tools: Click the settings panel (three horizontal bars) in your Nightscout website and select "Admin Tools"
- Create Token: Click "Add New Subject" and choose the appropriate role:
readable: Read-only access (recommended for this app)careportal: Can view and make treatment entriesadmin: Full access
- Copy Token: Use the generated token string for authentication
Note: If you change your API_SECRET, all tokens will change and need to be updated.
The app supports multiple Nightscout data sources:
- URL Format:
https://yournightscout.com/api/v1/entries/sgv.json - Use Case: Standard cloud-hosted Nightscout instances
- Requirements: Internet connection, valid Nightscout URL
- Authentication: Optional API token for secure access
- Example:
https://mybloodglucose.herokuapp.com/api/v1/entries/sgv.json
- URL Format:
http://[GATEWAY_IP]:17580/sgv.json - Use Case: xDrip+ or similar apps broadcasting glucose data
- Requirements: Phone hotspot enabled, xDrip+ configured for broadcast
- Auto-detection: App automatically detects gateway IP when connected to hotspot
- Example:
http://192.168.1.1:17580/sgv.json
- URL Format:
http://127.0.0.1:17580/sgv.json - Use Case: xDrip+ running locally on the Karoo device
- Requirements: xDrip+ installed and configured on Karoo
- Benefits: No internet required, direct local access
The app provides convenient quick-fill buttons for common setups:
- Local Web -
http://127.0.0.1:17580/sgv.json - Hotspot Device - Auto-detects gateway IP and sets
http://[GATEWAY_IP]:17580/sgv.json - Nightscout -
https://mynightscout.com/api/v1/entries/sgv.json
- Auto Refresh - Enable automatic data updates
- Notifications - Enable status notifications
- API Token - Optional authentication token for Nightscout servers
- Restart App - Apply configuration changes
- Open Karoo Settings on your device
- Navigate to Ride Profiles β Edit Profile
- Add Data Fields:
- Tap the "+" button to add a new field
- Search for "Enhance-d Club Glucose"
- Select your desired data field
- Position the fields where you want them on screen
- Save the profile
βββββββββββββββββββββββββββββββββββ
β Glu. mg Direction Time β
β 145 mg/dL β 00:02:15 β
β β
β 15m Ξ mg 5m Ξ mg Glu. mmolβ
β +12 mg/dL +5 mg/dL 8.1 mmolβ
βββββββββββββββββββββββββββββββββββ
App not appearing in Karoo data fields:
- Ensure the app is installed and running
- Check that the extension service is active
- Restart the Karoo device
No glucose data showing:
- Verify your Nightscout URL is correct
- Check your internet connection
- Ensure your Nightscout site has recent glucose data
- Check the app's "Last Updated" time
Data not updating:
- Verify auto-refresh is enabled
- Check your data connection
- Restart the app if needed
Connection errors:
- Verify your Nightscout site is accessible
- Check firewall settings
- Try using a different network
Hotspot connection issues:
- Ensure phone hotspot is enabled
- Check that xDrip+ is configured to broadcast glucose data
- Verify the Karoo is connected to the phone's hotspot
- Try manually entering the gateway IP if auto-detection fails
- App logs: Check Android logcat for detailed error messages
- Network status: Verify connectivity to your Nightscout server
- Data format: Ensure Nightscout returns valid JSON data
The app expects glucose data in the Nightscout format:
[
{
"_id": "689b739389c427000266181c",
"sgv": 154,
"direction": "FortyFiveDown",
"device": "AAPS-DexcomG6",
"mills": 1755018118000,
"units": "mg/dl"
}
]sgv- Glucose value in mg/dLdirection- Trend direction (see Direction Indicators above)mills- Timestamp in milliseconds
Glucose values are automatically color-coded:
- π’ Green (70-180 mg/dL): Normal range
- π Orange (>180 mg/dL): High glucose
- π΄ Red (<70 mg/dL): Low glucose
- Check GitHub releases for new versions
- Uninstall previous version before installing new one
- Your settings will be preserved
- Ensure your Nightscout site is up to date
- Check for any API changes that might affect the app
- Verify data is being uploaded to Nightscout correctly
We welcome contributions! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
- Android Studio 4.0+
- Android SDK 21+
- Karoo Ext library
- Nightscout test instance
- GitHub Issues: Report bugs and request features
- Documentation: Check this README and code comments
- Community: Join diabetes and cycling communities
- GitHub: Repository Issues
- Email: [email protected]
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- Enhance-d Club UK - Community support and inspiration for active living with type 1 diabetes
- CGM in the Cloud - Community-driven diabetes technology
- xDrip+ - Open source diabetes management
- Hammerhead - Karoo platform and extension framework
- Nightscout - Open source CGM data platform
Enhance-d Club UK is a not-for-profit community built by and for people living with type 1 diabetes who refuse to let it hold them back. From cyclists and runners to swimmers and weekend adventurers, we support each other to stay active, healthy, and connected.
- πͺ Empower people with type 1 diabetes to live active, fulfilling lives
- π΄ Create safe spaces to share experiences, challenges, and wins
- π€ Build community through meetups, events, and online support
- π Break down barriers to access, so everyone can enjoy the benefits of sport and activity
Your support helps us keep the community thriving β from hosting meetups, to creating resources, to backing initiatives that make active living with type 1 diabetes more accessible to all.
β Every coffee fuels community, connection, and action.
Together, we're proving that diabetes doesn't define limits.
- Updated version numbering
- Enhanced Nightscout API source documentation
- Improved hotspot detection and configuration
- Better error handling and user feedback
- Professional branding and medical disclaimers
- Initial release
- Basic glucose monitoring
- Multiple data fields
- Medical disclaimer
- Professional branding
- Custom data field layouts
- Advanced trend analysis
- Integration with other diabetes apps
- Enhanced error handling
- Additional Nightscout API source support
Remember: This app is for informational purposes only. Always consult healthcare professionals for medical decisions.
Brought to you by Enhance-d Club
