Package selection guidance compiled from public package information, community data, and project usage.
The heart_bpm package enables users to record individual blood pressure readings using only their smartphone's camera. By analyzing subtle changes in facial color from the camera feed, it estimates heart rate and provides a non-invasive way to monitor cardiovascular health. Designed for simplicity and accessibility, it integrates seamlessly into health-focused applications on Android, iOS, and Web platforms. The package leverages computer vision techniques to detect pulse variations in real time, offering a convenient tool for personal wellness tracking without additional hardware.
Use cases
Personal heart rate monitoring
Non-invasive blood pressure estimation
Fitness and wellness apps
Remote health checkups
Daily health tracking
Key features
Camera-based pulse detection
Real-time heart rate analysis
Cross-platform support (Android, iOS, Web)
Simple integration with Flutter
Lightweight and efficient processing
Suitable for
Health app developers
Fitness enthusiasts
Telehealth applications
Mobile health research
Individuals tracking cardiovascular health
Considerations
Accuracy may vary based on lighting and skin tone
Requires stable camera input
Not a medical-grade diagnostic tool
Limited to heart rate, not direct blood pressure
User cooperation needed for reliable results
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
heart_bpm
Widget to measure heart rate in beats per minute using the camera of smartphone.
Working principle
Covering the camera lens with the fingertip enables the camera to
measure the subtle changes in skin tone. These are proportional to
the changes in the blood flow through the arteries just below the
skin of the fingertip. This is in-turn correlated to the heart beats.
Hence, the variations in the skin tone can be approximated to the
instances of heart beats. Measuring the time differences between
the peaks provides Beats per Minute.
These values are not stable and hence, an exponential moving average
filter
is implemented. The smoothing factor α, can be controlled by the
user from the calling widget.
Implementation
To access the camera, the module utilizes the
camera package. Hence, the
requirements to use this package have the same requirements.
Android
Minimum android SDK version: 21
Change the minimum Android sdk version to 21 (or higher) in your
android/app/build.gradle file.
minSdkVersion 21
iOS
iOS 10.0 of higher is needed to use the camera plugin. If compiling
for any version lower than 10.0 make sure to check the iOS version
before using the camera plugin. For example, using the
device_info plugin.
Add two rows to the file ios/Runner/Info.plist:
one with the key Privacy - Camera Usage Description and a usage
description.
and one with the key Privacy - Microphone Usage Description and a
usage description.
Or in text format add the key:
<key>NSCameraUsageDescription</key><string>Heart BPM plugin would like to use camera to measure your heart rate.</string><key>NSMicrophoneUsageDescription</key><string>Can I use the mic please?</string>
The microphone key is required though the feature is not being used
and no audio is enabled in the implementation.
Getting Started
The module can be used simply by accessing it as a widget.
Import the module:
import'package:heart_bpm/heart_bpm.dart';
Access the widget as simply as:
/// list to store raw values inList<SensorValue> data = [];
/// variable to store measured BPM valueint bpmValue;
@overrideWidgetbuild(BuildContext context) {
returnScaffold(
appBar: AppBar(
title: Text('Heart BPM Demo'),
),
body: Column(
children: [
isBPMEnabled ? HeartBPMDialog(
context: context,
onRawData: (value) {
setState(() {
// add raw data points to the list// with a maximum length of 100if (data.length == 100)
data.removeAt(0);
data.add(value);
});
},
onBPM: (value) => setState(() {
bpmValue = value;
}),
)
: SizedBox(),
Center(
child: ElevatedButton.icon(
icon: Icon(Icons.favorite_rounded),
label: Text(isBPMEnabled
? "Stop measurement" : "Measure BPM"),
onPressed: () => setState(() =>
isBPMEnabled = !isBPMEnabled
),
),
),
],
),
);