This is a submission for the Presage SmartSpectra SDK Challenge
What I Built
Pause Pal is an Android break buddy for students, developers and anyone who works or studies at a screen.
You prop your phone up, start a short check-in (3, 5 or 10
minutes), and Pause Pal reads your own pulse and breathing through the front camera.
It learns your personal breathing baseline, and if your breathing stays well above that baseline it suggests a short break with a guided breathing circle.
Most break reminders are fixed timers that ignore how you actually are. Pause Pal listens to you instead of the clock, and it stays a wellness tool: it never diagnoses anything or compares you with a "normal" range.
What it lets people do:
- See live pulse, breathing rate, HRV, their own baseline, and chest and belly breathing waves.
- Get a gentle, mascot-led break suggestion based on their own baseline.
- Take a one-minute guided break: a breathing circle that follows their live breathing, a break tip, and a short tap-to-tick checklist (look away, stretch, sip water).
- Get on-screen (and optionally spoken) help when the camera can't see them properly.
- Pause and resume the camera mid-session without losing the check-in.
- Review a short summary (averages, sparklines, baseline, breaks taken). It is erased as soon as they leave the summary.
Demo
The video shows: the consent screen, choosing a check-in length, a live session with
changing pulse and breathing numbers and waves, the mascot reacting to my breathing,
the break sheet appearing when I breathe faster than my baseline, the circle following
me as I slow down, the before/after breathing numbers, and the summary.
Code
https://github.com/vrush1588/pausepal-smartspectra
The README has setup instructions (API key via PRESAGE_API_KEY in local.properties,
toolchain versions, physical device). Every SmartSpectra SDK call lives in
app/src/main/java/com/app/pausapal/presage/PresageSession.kt.
How It Responds to Human Signals
I integrated the SmartSpectra Android SDK (v3.4.0, com.presagetech:smartspectra) and use these live signals:
| Signal (SDK field) | How the app responds |
|---|---|
cardio.pulseRateList |
Live pulse card (SDK ~12 s average), session average and sparkline |
breathing.rateList |
Live breathing card, personal baseline, break suggestion, mascot mood, before/after numbers |
breathing.upperTraceList / lowerTraceList
|
Live chest and belly waves; the mascot and breathing circle move with them |
cardio.hrvList (RMSSD) |
HRV card (appears after ~60 s) and summary |
validationStatus |
On-screen and optional spoken framing guidance (face, framing, light, motion) |
processingStatus / error
|
"Starting" / "Measuring" status pill and plain error messages |
face.expressionList |
Optional expression card, off by default (opt-in on the consent screen) |
The flow, in real time:
- The first 30 seconds are a warm-up while the signal settles ("Warming up…").
- The app then averages breathing until 60 s (3-minute check-in) or 90 s (5 and 10-minute check-ins) to set your baseline, waiting for at least 3 readings.
- If breathing is more than 25% and at least 3 breaths/min above your baseline on two new readings in a row, a bottom sheet suggests a short break ("Suggested because your breathing has been above your own baseline for a little while").
- "Take a break" opens a 60-second reset: the breathing circle follows your own live breath wave, with a faint guide ring at a slower 4.5 s in / 4.5 s out rhythm to match. "Not now" or a break keeps things quiet for 2 minutes (3-min check-in) or 5 minutes.
- After the one-minute reset, the app shows breathing rate before and after (neutral numbers, no good or bad labels).
- If the camera is paused for more than 60 s, the old baseline is discarded and re-learned, and readings either side of a pause never count as "in a row".
Integration steps:
- At launch, switch the SDK's telemetry and image output off (
applyPrivacyDefaults()). - On "Start session", configure
SmartSpectraSdk.sharedwith the API key, front camera, preview surface and requested metrics (breathingMetrics + cardioMetrics, plusEXPRESSIONSonly if opted in), thensdk.start(). - Observe
sdk.metrics,processingStatus,validationStatusanderror(LiveData). Rate lists can be empty between updates, so the app keeps the last valid value and only accepts readings with a newer timestamp. - Buffer the latest 300 trace samples locally to draw the waves and drive the mascot and circle.
- Act on
validationStatusonly when the code changes and the problem persists ~2 s (ignored for the first 5 s, at most one spoken prompt per 10s).
Code locations:
-
PresageSession.kt:applyPrivacyDefaults(),bind(),start(),stop(),onMetrics() -
session/BreakCoach.kt:onBreathing()(baseline and break rule) -
session/FramingCoach.kt: validation-code handling and fixed prompts -
session/SessionViewModel.kt:onBreathing(),takeBreak(),endSession() -
ui/screens/BreakSheetOverlay.kt: break sheet andBreathingCircle()
Prize Categories
Best Thoughtful Real-World Use
The need: People who study, code or read at a screen forget to take breaks, and
fixed timers ignore how they actually are.
Who it's for: Students, developers and anyone learning or working at a screen.
Designed to be usable and responsible:
- Short 3 to 10 minute check-ins that suit a phone propped on a desk.
- Consent screen before the camera starts; optional features are separate switches, off by default.
- Plain-language framing help, with voice as an option.
- Compares you only with your own baseline, with no medical claims.
- Nothing saved, and no AI service.
Most Creative or Delightful Use
Inspiration: A break reminder that listens to you instead of the clock.
What's playful: Pause Pal, a small mascot drawn entirely in code that breathes with your
belly wave, gets "lively" when your breathing is above your own baseline and calm near it,
and waves when you finish a session. The breathing circle follows your own breathing
rather than a fixed loop.
Consent and Data Handling
Camera consent.
- A consent screen explains camera use before anything starts.
- The Continue button stays disabled until the user ticks "I agree to use my camera for this session".
- The camera turns on only after they choose a length and tap "Start session".
- A "Camera active" badge is always visible.
- The user can pause the camera or tap "Stop and see summary" at any time.
- The session stops automatically if the app goes to the background.
- Camera permission can be revoked anytime in Android settings.
- The app is for the person using their own phone and is never covert.
Video.
- Frames are analysed on the device by the SmartSpectra SDK.
- The app does not record, save or upload video or photos.
- SDK image output is disabled (
imageOutputEnabled = false). - The small camera preview is hidden by default.
Storage and retention.
- Nothing is written to disk, preferences, a database or cloud backup(
allowBackup=false, backup rules exclude everything). - Readings are held in memory only.
- They are erased as soon as the user leaves the summary (Start new session, back, or leaving the app).
- No vital values are logged.
Sharing.
- The app shares no data.
- There are no accounts, analytics or ads.
SDK network use and telemetry.
- The SmartSpectra SDK contacts Presage's servers to validate the API key and load models, so an internet connection is required.
- The SDK can send an aggregate diagnostics summary per session (SDK version, device and OS model, session outcome, performance and quality counts). Per Presage's documentation it contains no video, no measured values and no user identifiers. The SDK defaults this on, so Pause Pal switches it off at launch and only enables it if the user ticks the optional "anonymous SDK diagnostics" box on the consent screen.
- Details: https://presagetech.com/docs/smartspectra-sdk/telemetry-and-privacy
Optional features, all off by default.
- Facial expression analysis: separate opt-in on the consent screen; shows an on-device estimate only, with no conclusions drawn about emotion or health.
- Gentle vibration: a soft buzz when a break is suggested and light ticks on each guided inhale, only when switched on.
- Voice guidance: uses Android's built-in text-to-speech to speak fixed prompts (framing tips, "Breathe in", the break tip). It never reads out your numbers and receives no camera data. Only an offline English voice is used, so spoken text stays on the phone; if none is installed, the app says so and offers an "Install voice" button.
AI services.
- None. No AI or LLM service is used by this app.
- Break tips are fixed text.
What it is not.
- A wellness tool, not a medical device.
- It makes no diagnosis or treatment claims.
- It supports no medical decisions.
- It never monitors anyone without their consent.
Top comments (0)