Readme

Guidance for using HeartTimer on Apple Watch and iPhone.

Heartimer is a wellness companion designed to help you get the most from your wellness activities without stress. It gently tracks elapsed time and heart rate, and lets you set simple presets so you can stay in a comfortable zone. There’s no pause/resume concept — sessions are intentionally simple: start and stop. Notifications are non‑intrusive with gentle vibrations and a subtle, privacy‑preserving alert.

Designed to support awareness — not to replace your judgment.

Metrics + Controls
Shows current time and heart rate with controls to Start, Stop (during a session) or Reset (when idle), and open Settings.
Concentric Indicators
Outer ring shows time laps against your time limit (if set). Inner ring shows progress toward your heart‑rate target with a marker dot.
Metrics Only
Large, uncluttered metrics plus min/max/average heart rate.
Chart
Heart rate over elapsed time, markers for events, and an optional target guideline.
Start
Begin a new session.
Stop
End the current session and finalize metrics.
Reset
Clear elapsed time and stats when idle.
Add Marker
Tap the pause icon to drop a timestamped marker (it does not pause the session).
Settings
Set a time limit, a heart‑rate target, alerts, and thermal warnings.
Time ring
Shows progress toward your time limit. After reaching the limit, the ring completes a lap and continues from the top.
Heart rate ring
Shows progress toward your heart‑rate target. A small white dot marks the current position.
HR exceeded marker
A short red arc near the top indicates you’re above the target.
Chart markers
Shown as vertical dashed lines aligned to when you placed them.
What are markers?
Lightweight timestamps you drop during a session to note moments like a pace change, a break, or how you felt.
How to add one?
Tap the pause icon (||) during a session. This adds a marker — it doesn’t pause the timer.
Where do they appear?
As vertical dashed lines on the Chart page, aligned to the elapsed time when you placed them.
Why use them?
They help you reflect on your session without micromanaging — just tap to mark the moment and keep moving.
Health access
Allow Health permissions so the app can read heart rate.
Gentle guidance
Use a moderate time limit and heart‑rate target to avoid overexertion.
Repeat alerts
Enable in Settings to get periodic reminders when exceeding presets.
Thermal warnings
Optionally enable warnings to avoid overheating the device during long sessions or in hot environments (e.g., Finnish sauna).
Suitable environments
Use Heartimer for gentle wellness activities like a whirlpool, hot tub, steam bath, or sauna. Always be mindful of heat exposure and hydration.
Safety first
If you feel unwell, stop immediately and cool down. Consult your physician if you have any health concerns.

HeartTimer is designed for general wellness use and is not a medical device. It is not intended to diagnose, treat, cure, or prevent any disease or medical condition. Measurements and notifications, including heart rate, time, and temperature-related data, may be inaccurate, delayed, or unavailable due to device and environmental limitations. HeartTimer does not guarantee the accuracy or timeliness of this information. Use HeartTimer as a supportive tool, not as a substitute for professional medical advice or monitoring. Activities involving heat or physical exertion may place additional strain on your body — always listen to how you feel and stop if needed. You are responsible for your own safety and well-being while using the app. If you have any concerns about your health, consult a qualified healthcare professional.

Back to HeartTimer