Your Rhythm Studio — Help & Reference

1. Quick Start Guide

New to Your Rhythm Studio? Here's how to record your first session in 5 steps:

1. Put on the Polar H10 chest strap — moisten the electrode contacts and position it just below your chest muscles.
2. Open the YourRhythm app — it auto-connects to your sensor and shows your live heart rate.
3. Select an activity — tap the Activity dropdown (e.g. Resting, Walking, Running).
4. Press START SESSION — the app begins recording ECG, heart rate, and detecting arrhythmias in real time.
5. Press STOP when done — choose your export scope (Full Data or Events Only). The session is saved and ready to sync to the dashboard.

2. Recording a Session

The Monitor tab is where you start, stop, and manage live recordings.

Starting a Session

1. Ensure the Polar H10 is connected (heart rate displayed on screen).
2. Tap the Activity dropdown to select your activity type (e.g. Resting, Walking, Running, Gym).
3. Press START SESSION. The ECG waveform and live metrics appear.
4. Optional: Tap Flag Event at any time to log a symptom or feeling at the current moment.

Stopping a Session

1. Press STOP SESSION. A confirmation dialog appears.
2. Choose your export scope:
   • Full Data — raw ECG + HR + all events (larger file, full analysis).
   • Events Only — just detected anomalies with ECG snippets (compact, fast to load).
3. Tap Confirm. The session is saved to the database and auto-exported.

Special Activity Modes

Certain activities trigger specialised measurement overlays automatically:

• HRV & RHR — starts a 60-second controlled measurement for resting HR and HRV. See Section 3.
• Cool Down — starts a 60-second heart rate recovery measurement. See Section 4.
• Meditation — opens the meditation duration and sound type picker. See Section 5.
• Sleeping — activates the sleep analysis pipeline (motion + HRV + respiratory rate).

3. Taking an HRV & RHR Measurement

Your morning HRV and resting heart rate are the most important baselines for tracking your cardiovascular health over time.

How to measure

1. Put on the chest strap and open the app first thing in the morning, before getting out of bed or having coffee.
2. Select the HRV & RHR activity from the Activity dropdown.
3. A 60-second overlay appears with a countdown timer. Stay still and breathe normally.
4. When the timer completes, your Resting HR and RMSSD (HRV) are saved automatically.
5. These values are embedded in every subsequent session export and displayed in the dashboard's Settings panel.

For the science behind HRV, RMSSD, and why morning measurements matter, see The Science → HRV & RHR Baselines.

4. Measuring Heart Rate Recovery (Cool Down)

Heart Rate Recovery (HRR) shows how quickly your heart returns to baseline after exertion — a key indicator of cardiovascular fitness.

How to measure

1. During or immediately after a hard effort (e.g. running, cycling), select the Cool Down activity from the Activity dropdown.
2. The app records your current heart rate as your peak HR.
3. A 60-second overlay appears with a countdown timer and live BPM display. Keep moving gently or stand still.
4. When the timer completes, your recovery HR is recorded and the HRR percentage is calculated automatically.
5. The result is saved in the session metadata and displayed in the dashboard's Spot Measurements card.

For the HRR formula and interpretation ranges, see The Science → Heart Rate Recovery.

5. Starting a Meditation Session

The Android app includes a guided meditation that uses your chest strap's accelerometer, heart rate, and beat-to-beat (RR) intervals to create a real-time audio feedback loop. The goal is to actively improve your HRV by guiding your breathing toward a resonance frequency of about 6 breaths per minute.

How to start

1. Open the Android app and select the Meditation activity from the Activity dropdown.
2. A duration picker appears with sound type chips. Choose a duration (5, 15, 30 minutes, or open-ended).
3. Tap a sound mode to select it:
   • Spatial Tone — fixed 5s in / 5s out breathing cycle with immersive stereo audio.
   • Breath-Driven — audio pacer follows your actual chest movement from the accelerometer.
   • HRV Coherence — a drone whose pitch shifts with your live HRV trend.
   • Heartbeat — a low-frequency pulse timed to your actual heartbeat.
4. Press Start. The breathing pacer circle appears with a countdown timer.
5. During the session, tap the sound-type button at the top to switch modes at any time.
6. Press Stop when done, or Abort to cancel without saving.

For the science behind biofeedback and coherence training, see The Science → Biofeedback & Coherence.

6. Getting Sessions into the Dashboard

All sessions are loaded from one source that you choose in the Setup panel: Phone or This PC. The source you select is remembered for next time.

Phone Source

Use this when your recorded sessions are still on the YourRhythm phone app.

On the Phone App

1. Open YourRhythm — the Wi-Fi server starts automatically when the app launches.
2. Go to Settings — scroll to the WI-FI SYNC card.
3. Check the IP address — it will show something like http://192.168.1.120:8080
4. That's it! — you don't need to do anything else on the phone. Keep the app open.

On the Cardio Dashboard

1. Open the Setup panel in the left sidebar.
2. Select "Phone" as the session source.
3. Choose your YourRhythm-Data folder on this PC — this is where downloaded sessions will be saved.
4. Type the IP address shown on your phone and click Connect.
5. Click Download from Phone — the dashboard copies every session to your PC and removes it from the phone.
6. Open the Sessions panel — your sessions are loaded automatically.

PC Source

Use this when your sessions are already stored on your computer, for example after downloading them from the phone previously.

On the Cardio Dashboard

1. Open the Setup panel in the left sidebar.
2. Select "This PC" as the session source.
3. Choose your YourRhythm-Data folder — the folder must be named exactly YourRhythm-Data.
4. Click Load Sessions from PC, or simply open the Sessions panel — it loads automatically.

Understanding the CSV File

Each exported session contains multiple sections with all your recording data:

Section	Contains
[SECTION:METADATA]	Session info: date, duration, device, patient ID, Resting HR, Measured HRV, sample rate
[SECTION:EVENTS]	All detected cardiac events with timestamps, types, feelings, and RR intervals
[SECTION:EVENT_WINDOWS]	Compact ECG strips around each event (for quick review without full raw data)
[SECTION:RAW_ECG]	Full raw recording: ECG signal, BPM, RR intervals, accelerometer, event markers

Heart Rate Recovery in Exports

When you perform a Cool Down measurement on the phone, the result is embedded in the exported session metadata:

• Spot HRR (%) — Relative recovery: ((peak HR − recovery HR) / peak HR) × 100.
• Spot HRR Start BPM — The peak heart rate at the moment Cool Down was selected.
• Spot HRR Score — Composite score based on the raw BPM drop, age, fitness, and recovery velocity.

The dashboard reads these automatically and displays them in the Spot Measurements card.

Resting Heart Rate & HRV in Exports

When you perform an "HRV & RHR" measurement session on the phone, the resulting values are embedded in every subsequent export:

• Resting HR (bpm) — Your baseline resting heart rate, used for Karvonen zone calculations.
• Measured HRV (ms) — Your RMSSD value from the 60-second measurement protocol.

The Cardio Dashboard reads these automatically and displays them in the Settings panel under Physiology. The status indicators show:

Colour	RHR Meaning	HRV Meaning
Green	<60 bpm — Athletic	>50 ms — Excellent
Blue	60-72 bpm — Good	30-50 ms — Good
Amber	73-80 bpm — Average	20-30 ms — Fair
Red	>80 bpm — Elevated	<20 ms — Low

Troubleshooting

Problem	Cause	Solution
"Connection Failed"	Phone and PC not on same network	Check both are on the same Wi-Fi (not mobile data, not guest network)
"No Sessions Found"	No exported CSVs on phone	Record a session and export it first, or check Documents/YourRhythm-Data folder exists
"No Wi-Fi connection" on phone	Phone on mobile data only	Connect phone to Wi-Fi. The server needs a local network to work.
Phone IP keeps changing	Router assigns dynamic IPs	Use Quick Scan to find the new IP, or set a static IP on your phone/router
Scan finds nothing	Network blocks device-to-device traffic	Some corporate/guest Wi-Fi blocks this. Use your home network or USB instead.
USB: phone not showing files	Phone locked or USB mode wrong	Unlock phone. In the USB notification, select "File Transfer / MTP" (not just charging)
CSV loads but shows no data	File may be an older format	Re-export the session from the phone app to get the latest format

Folder Organization (Wi-Fi Downloads)

When sessions are downloaded via Wi-Fi, they can be automatically organized into folders:

• Flat — All files in one folder (simplest)
• Daily — Grouped by date (e.g., 2026-04-11/IPM-26.04.11.csv)
• Monthly — Grouped by month (e.g., 2026-04/IPM-26.04.11.csv)
• Yearly — Grouped by year (e.g., 2026/IPM-26.04.11.csv)
• Custom Pattern — Use variables to create your own structure

7. Reviewing a Session on the Dashboard

Once you've loaded a session into the Cardio Dashboard, here's how to explore and interpret the results:

Loading a Session

1. Open the Sessions panel in the left sidebar.
2. Click any session card to load it into the dashboard.
3. The Summary tab opens first, showing key metrics: duration, event counts, HR stats, HRV, and the rhythm diagnosis.

Navigating the ECG

• Switch to the Charts tab to see the full ECG waveform.
• Use the segment toolbar at the top to jump between 10-minute segments (00:00, 10:00, 20:00…).
• Click zoom in / zoom out to change the time scale. The chart auto-switches between envelope view (zoomed out) and individual samples (zoomed in).
• Use the Event Navigation Bar on the right side to jump to detected events (see Section 9).

Reading the Summary

• The Rhythm Diagnosis card shows the overall classification (e.g. Normal Sinus Rhythm, AFIB Possible).
• The Conditions Detected list shows each arrhythmia type found, with counts and first/last occurrence times.
• Tap a condition name to see a plain-language description of that arrhythmia.
• Tap an anomaly item to open the ECG Event Viewer with the waveform snapshot.

Using the Viz-Bar Toggles

The vertical button bar on the right side of the chart lets you toggle overlays:

• BPM — heart rate trace
• HRV — HRV (RMSSD) trend
• Events — vertical markers for detected arrhythmias
• Activity — coloured background bands for activity types
• Zone — coloured HR zone band
• Grid — ECG calibration grid

For the full list of dashboard controls, see Section 14: UI Controls Reference.

8. Reading the ECG Chart

Trace Colours by Rhythm

Colour	Label	Meaning
■	Normal	Normal sinus rhythm
■	AFIB	Atrial fibrillation — irregular R-R, absent P-waves
■	VT	Ventricular tachycardia
■	Ectopic	Premature beat (PVC or PAC) — wide or narrow, arrives early

Overview Envelope

When viewing a full session or a 10-minute segment at full zoom-out, the chart switches from individual samples to an envelope view — a shaded band showing the signal's min/max range per time bin. This preserves performance for long recordings while still showing overall signal quality and events.

The envelope automatically switches back to individual ECG samples when you zoom in to less than ~2 minutes of data.

9. Event Navigation

The Event Navigation Bar appears at the right side of the segment toolbar. Each button corresponds to a detected or user-marked event in the session.

• Click once — Jumps to the first occurrence and zooms in to ~10 seconds of ECG
• Click again — Cycles to the next occurrence of the same event type
• After the last occurrence it wraps back to the first

10. Activity Tracking

Activity labels are sourced from the activity column in your recording CSV. Common values include: resting, walking, running, exercise, sleeping, driving, cooldown.

Activity regions appear as labelled, coloured panels in the Activity bar at the bottom of the chart. Toggle with the Activity button in the viz-bar.

Activity context is also used internally by the HRV engine — periods labelled with vigorous exercise will be classified as Active in the HRV trend even if the accelerometer is quiet (e.g., cycling).

11. Heart Rate Zones

The dashboard and phone app divide your effort into 5 training zones based on your maximum heart rate. Toggle the Zone button in the viz-bar to show the coloured zone band beneath the ECG. Zone data is sourced from the zone column in your CSV.

Zone boundaries are calculated automatically from your age and resting HR using the Karvonen method, but can be manually adjusted in the phone app's Settings → Heart Rate Zones section.

For the full zone definitions, formula, and exercise physiology, see The Science → Training Zones.

12. Interpreting Your Results

Here's a plain-language guide to the terms you'll see in your session reports. For the full technical detail, see The Science page.

Common Arrhythmia Terms

Term	What it means	Should I worry?
Normal Sinus Rhythm	Your heart is beating in a normal, regular pattern.	No — this is the expected result.
PVC (Premature Ventricular Contraction)	A beat starts early from the ventricles instead of the sinus node. It looks wide and bizarre on the ECG.	Occasional PVCs are common and usually benign. Frequent PVCs (>10% of beats) should be discussed with a doctor.
PAC (Premature Atrial Contraction)	A beat starts early from the atria. It looks normal in shape but arrives too soon.	Similar to PVCs — occasional PACs are common and usually harmless.
AFIB (Atrial Fibrillation)	The atria quiver instead of contracting normally. Detected when 5 or more consecutive heartbeats have irregular R-R intervals with no alternating pattern — distinguishing it from isolated ectopic beats (1–3 irregular) or bigeminy (alternating pattern).	AFIB is a significant finding. If detected, consult your doctor for a formal evaluation.
Bigeminy	Every normal beat is followed by a premature beat (e.g. N-PVC-N-PVC pattern).	Can be bothersome but is usually benign. If persistent or symptomatic, seek medical advice.
Trigeminy	Every two normal beats are followed by a premature beat (e.g. N-N-PVC pattern).	Similar to bigeminy — usually benign but worth monitoring.
VT (Ventricular Tachycardia)	A rapid, wide-complex rhythm originating in the ventricles. A medical emergency if sustained.	Seek immediate medical attention if sustained (>30 seconds).
Pause	A gap between beats longer than expected, often following a premature beat (compensatory pause).	Usually benign in the context of ectopic beats. Isolated pauses >3 seconds should be evaluated.
Apnea	A detected pause in breathing during sleep, inferred from HRV and heart rate patterns.	If frequent, consider a sleep study evaluation.
NOISE / ARTIFACT	The signal was too noisy to classify — caused by movement, poor contact, or interference.	Not a cardiac event. Try adjusting the strap or reducing movement.

13. Exporting from Dashboard

The Cardio Dashboard provides two export options in the Export sidebar panel for clinical reporting and basic data export.

Export as PDF (Clinical Report)

Generates a structured clinical report as a PDF document with three sections:

• Section 1: Session Information — Session name, date, duration, sample rate, number of events, patient ID
• Section 2: Clinical Findings Summary — Narrative summary from the dashboard Session Summary panel, showing detected arrhythmias and rhythm analysis
• Section 3: ECG Event Segments — ECG waveform strips (±5 seconds) around each detected event, with event type, timestamp, and RR interval

Export Raw CSV Data

Downloads basic session metadata as a simple CSV file. Contains:

• Session name
• Date
• Duration (minutes)
• Sample rate (Hz)
• Patient ID (if available)
• Device (if available)
• Start time (if available)

Append to Trends Log

Available in the Trends tab, this option appends the current session's key metrics to a trends CSV file for longitudinal tracking. Includes:

• Session identity (ID, date, duration)
• Heart rate statistics (min, max, average, range)
• HRV metrics (RMSSD, SDNN, PNN50, SD1, SD2)
• Rhythm event counts (Ectopic, AFIB, VT, Pause, Bigeminy, etc.)
• Zone minutes (Z1-Z5)
• Sleep metrics (if available)
• Respiratory rate (if available)

14. UI Controls Reference

The interactive controls in the dashboard are grouped below. The list is generated from uiControls.json.

15. Phone App UI Reference

The interactive controls in the Your Rhythm Monitor Android app are grouped by screen below. The list is generated from phoneUiControls.json.

16. Contact

For questions, support, or feedback, please contact us at: YourRhythm101@gmail.com

Visit our website at YourRhythm.co.uk

Troubleshooting

If you're experiencing issues, you can download your error logs to help us diagnose the problem:

Download Error Logs

Logs are stored locally in your browser and include the last 10 sessions. Sensitive data (file paths, IPs, emails) is automatically redacted.