whatisgithub

What is vital-signs-monitor?

cristi200134/vital-signs-monitor — explained in plain English

Analysis updated 2026-05-18

16C++Audience · researcherComplexity · 4/5LicenseSetup · hard

In one sentence

A student built ESP32 device that measures heart rhythm, blood oxygen, temperature, and breathing as a portable, non certified patient monitor prototype.

Mindmap

mindmap
  root((vital signs monitor))
    What it does
      ECG heart rate
      Blood oxygen and respiration
      Temperature sensing
      Local display and web view
    Tech stack
      ESP32
      C++ FreeRTOS
      MAX30102 sensor
      AD8232 sensor
    Use cases
      Biomedical engineering education
      DIY health monitoring prototype
      Research into vital sign algorithms
    Audience
      Students
      Researchers
      Hardware hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a low cost, working prototype of a four parameter patient monitor for a school project.

USE CASE 2

Study how heartbeat detection algorithms are validated against a real medical database.

USE CASE 3

Learn how to run multiple sensor reading tasks at once on an ESP32 using FreeRTOS.

USE CASE 4

Use the included schematics, parts list, and 3D printable case to replicate the hardware.

What is it built with?

C++ESP32FreeRTOSMATLABPlatformIO

How does it compare?

cristi200134/vital-signs-monitoradobe-creative/cs6-extendedamitrajput-dev/sonybridge
Stars161616
LanguageC++C++C++
Setup difficultyhardmoderatemoderate
Complexity4/52/53/5
Audienceresearchergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires assembling specific electronic components and sensors, plus flashing firmware to an ESP32, this is a hardware build, not just software.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This project is a portable medical monitoring device built from scratch as a biomedical engineering bachelor's thesis project. It measures four vital signs at once, heart rhythm, blood oxygen level, body temperature, and breathing rate, reproducing the core functions of a hospital patient monitor using affordable, accessible electronic parts. It is a working proof of concept the author built and tested, not a certified medical device that could be used for real patient care. The device runs on an ESP32 microcontroller, a small dual core chip that runs the whole system. Heart activity is picked up with a chest sensor and turned into a heartbeat reading using a well known heartbeat detection method, which the author tested against a large public database of real heart recordings and found to correctly identify almost 99 percent of heartbeats. Blood oxygen and breathing rate come from a single optical sensor placed against the skin, temperature comes from a separate digital sensor, and all the readings are shown on a small screen built into the device as well as on a webpage you can open over the device's own WiFi signal. It also has a three level alarm system with lights and a buzzer, and it saves session data with timestamps onto a memory card. Everything, including the circuit design, a parts list with costs, and a 3D printable case, is included in the repository alongside the author's thesis document. The software is written in C++ using FreeRTOS, a system that lets several tasks run at once across the chip's two processor cores, so that things like reading sensors and updating the display do not interfere with each other. The project is aimed at students, hobbyists, or researchers interested in medical device engineering rather than people looking for a certified clinical product. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how the heartbeat detection algorithm in this project works and how it was validated.
Prompt 2
Help me understand the wiring and sensor setup needed to build this vital signs monitor.
Prompt 3
Show me how the FreeRTOS tasks are organized across the ESP32's two cores in this firmware.
Prompt 4
Walk me through the parts list and estimated cost for building this device myself.

Frequently asked questions

What is vital-signs-monitor?

A student built ESP32 device that measures heart rhythm, blood oxygen, temperature, and breathing as a portable, non certified patient monitor prototype.

What language is vital-signs-monitor written in?

Mainly C++. The stack also includes C++, ESP32, FreeRTOS.

What license does vital-signs-monitor use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is vital-signs-monitor to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is vital-signs-monitor for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.