Skip to content

README.md

Latest commit

 

History

History
52 lines (37 loc) · 1.77 KB

README.md

File metadata and controls

52 lines (37 loc) · 1.77 KB

Heart Rate Controller

Standalone Python GUI for simulating heart rate data and sending it to the Flask backend. Fully separate from the backend — uses only Python stdlib (tkinter, urllib). No pip install required.

Controls

Control Behavior
Current BPM Large readout, updates every 1 second when running
Start / Stop Toggle; when started, sends heart rate every 1 second
+5 / −5 Increase or decrease base BPM by 5
+10 / −10 Increase or decrease base BPM by 10
Stress Checkbox; when checked, adds a +40–50 BPM spike (decays when unchecked)

How to run

Two independent processes. Run in any order:

  1. Backend (optional; required to persist data):

    cd backend
.\.venv\Scripts\Activate.ps1   # Windows
flask --app app run --debug

    Backend runs at http://127.0.0.1:5000.

  2. Controller (standalone):

    cd controller
python app.py

    A native window opens. No browser or npx serve needed.

  3. Use Start, adjust BPM with +/- buttons, enable Stress for spikes, then Stop when done.

Syncing with the Flow app

To drive the app's displayed heartbeat with the controller:

  1. Start a focus session in the app first (Start Session) — the backend writes the session ID to a file.
  2. Start the controller and click Start. The controller reads the session from the file each tick (no HTTP polling).
  3. The app will show the controller's heart rate. Without the controller, the app uses mock HR.

If the backend is not running, the controller UI still updates but requests will fail. A status message shows success or error.

API

The controller sends POST http://127.0.0.1:39762/api/heart-rate with:

{ "session_id": "...", "bpm": 72 }