How faraujop/glykos works
Glykos is an Android companion app for runners: it polls glucose from a LibreLinkUp follower account, decides when readings or alarms should be announced, and delivers them by Spanish voice, watch-forwarded notifications, or both. The app also configures credentials and output preferences and retains an in-memory session summary. README capabilities guide the workflow; sampled source confirms key service, output, settings, and session paths. Some UI wiring and unsampled implementation details are represented only where the README or source index supports them.
Main entry points: MonitorService.kt Foreground monitor · MainActivity.kt Android app UI · NotificationWatchOutput.kt Watch notification output · HomeViewModel.kt Home state
Components 20
App experience
- Android app UI
app/src/main/kotlin/com/glykos/app/MainActivity.kt - Home state
app/src/main/kotlin/com/glykos/app/HomeViewModel.kt - Session summary UI
app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt
Monitoring
- Foreground monitor
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Monitor controller
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt
Glucose domain
- Polling monitor
core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt - Announcement policy
core/domain/src/main/kotlin/com/glykos/core/domain/announce/AnnouncementPolicy.kt - Session recorder
core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt - Session summary logic
core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionSummary.kt - Notification formatter
core/domain/src/main/kotlin/com/glykos/core/domain/format/NotificationMessageFormatter.kt
Data and delivery
- Settings store
core/data/src/main/kotlin/com/glykos/core/data/settings/SettingsRepository.kt - Glucose source interface
core/data/src/main/kotlin/com/glykos/core/data/source/GlucoseSource.kt - LibreLinkUp source
core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt - Demo glucose source
core/data/src/main/kotlin/com/glykos/core/data/demo/DemoGlucoseSource.kt - Data bindings
core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt - Voice output
feature/output/src/main/kotlin/com/glykos/feature/output/VoiceOutput.kt - Watch notification output
feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt
Other components
- Runner
- LibreLinkUp cloud
- Garmin Connect and watch
Connections 25
- Runner → Android app UI: configures and starts
README.md - Android app UI → Home state: observes app state
app/src/main/kotlin/com/glykos/app/MainActivity.kt - Home state → Settings store: reads and saves settings
app/src/main/kotlin/com/glykos/app/HomeViewModel.kt - Home state → Monitor controller: starts and observes
app/src/main/kotlin/com/glykos/app/HomeViewModel.kt - Android app UI → Voice output: sends test announcements
app/src/main/kotlin/com/glykos/app/MainActivity.kt - Android app UI → Watch notification output: sends test announcements
app/src/main/kotlin/com/glykos/app/MainActivity.kt - Android app UI → Session summary UI: shows session summary
app/src/main/kotlin/com/glykos/app/MainActivity.kt - Session summary UI → Session summary logic: summarizes readings
app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt - Data bindings → LibreLinkUp source: binds implementation
core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt - Data bindings → Demo glucose source: binds implementation
core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt - LibreLinkUp source → Glucose source interface: implements
core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt - Demo glucose source → Glucose source interface: implements
- LibreLinkUp source → LibreLinkUp cloud: polls glucose
README.md - Foreground monitor → Settings store: observes configuration
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Foreground monitor → Glucose source interface: fetches readings
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Foreground monitor → Polling monitor: runs polling monitor
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Polling monitor → Announcement policy: decides announcements
core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt - Foreground monitor → Voice output: delivers announcements
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Foreground monitor → Watch notification output: delivers announcements
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Foreground monitor → Monitor controller: reports monitor state
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt - Monitor controller → Session recorder: records readings
feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt - Session recorder → Session summary logic: finishes session data
core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt - Voice output → Garmin Connect and watch: speaks through headphones
README.md - Watch notification output → Notification formatter: formats notification
feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt - Watch notification output → Garmin Connect and watch: forwards notification
README.md