PulseSensor.com Playground
Ready-to-use Arduino code for your PulseSensor. See your first pulse wave, calculate BPM, or make something respond to your heartbeat. 💓
Start here: Assemble your kit, then install PulseSensor Playground in Arduino Library Manager, open GettingStartedProject, then try PulseSensor_BPM once your waveform is steady.
- Commented examples help you get started and keep experimenting. 🤘
- Switch projects right in the Arduino IDE. 💻
- Share what you make with the community. 🐝
Choose the stabilizer ring for finger placement or the ear clip for earlobe placement. Follow the preparation steps before putting the sensor against your skin.
Ring assembly · Ear-clip assembly · All assembly steps in text
Everything needed for ring assembly is included in the current PulseSensor Kit: sensor, stabilizer ring, strap, clear face cover, and rear mounting dot.
Read the ring steps on GitHub · Full ring guide on PulseSensor.com
Try the pads, sides, or knuckles of your fingers on either hand. Place the covered sensing face against skin, not the nail. Use light, steady contact and keep your hand still. Try one spot at a time and compare the signal.
The ear clip, sensor, and clear face cover are included in the kit. A hot-glue gun and glue are required and are not included. Use a low-temperature gun with compatible, plain, non-toxic glue sticks. Keep glue off the sensing face and let all glue cool fully before handling or wearing.
Read the ear-clip steps on GitHub · Full ear-clip guide on PulseSensor.com
A compatible development board, USB data cable, and computer are not included in the kit. The wiring shown is for an Arduino UNO; use the correct analog pin and voltage for other boards. Click either instruction image to view it at full size.
Assembly guides © 2026 World Famous Electronics LLC · PulseSensor. Updated November 2026.
- United States: Buy the PulseSensor kit on Amazon.
- International: Buy from SparkFun or Adafruit.
- Education & Bulk: Request a bulk quote. 50-kit minimum, in increments of 25 kits.
Easy setup: prepare, connect, and get a steady signal
The current kit includes the TPU Stabilizer Ring, Velcro finger strap, ear clip, and transparent vinyl insulation dots. You'll also need a compatible development board, a USB data cable, and a computer.
Before skin contact, follow the ring or ear-clip assembly steps, including the clear front cover and the rear preparation for your chosen mount. The ring holds the sensor steady; it does not replace the preparation steps. The illustrated guides are also visible above.
For the Arduino Uno GettingStartedProject:
| PulseSensor wire | Arduino Uno connection |
|---|---|
| Purple — signal | A0 |
| Red — power | 5V |
| Black — ground | GND |
Using another board? Follow its example's analog pin and voltage instructions. PulseSensor needs an analog input (ADC); a 5V Uno wiring diagram does not apply to every board.
After preparation, position the sensor with the ring, strap, or ear clip. Rest your hand, keep the cable from pulling, and use light, steady contact. Load the Getting Started example below and look for a repeating waveform before moving on to BPM.
Install the library and see your first pulse wave 🤓
- Install Arduino IDE if you don't already have it.
- Open Tools → Manage Libraries…, search for PulseSensor Playground, and click Install or Update.
- Open File → Examples → PulseSensor Playground → GettingStartedProject.
- Select your board and USB port, then upload the sketch. For other boards, use the matching board-specific example.
- Open Tools → Serial Plotter and select 115200 baud for
GettingStartedProject. - Hold the prepared sensor gently against your fingertip. Give the signal 5–10 seconds to settle; look for a repeating pulse wave and the built-in LED blinking as the signal crosses the threshold.
Ready for BPM? Open PulseSensor_BPM and follow the BPM tutorial.
See your pulse in the browser with Signal Coach
Open Signal Coach for a live waveform and guidance on sensor placement in desktop Chrome or Edge.
Upload the Web Serial example, close Arduino Serial Monitor and Serial Plotter, select 50 samples/s, then click Connect. The website walks you through setup.
Want to run it locally or change the code? See the full source and home-build guide.
Tinker and experiment with popular projects 👩🏽💻👩🏻🔬
See your raw pulse wave in Serial Plotter and blink the built-in LED.
Calculate beats per minute (BPM) once you have a steady raw waveform.
Transform the heartbeat into a live "beep" with a speaker.
Make a servo motor pulse to your live heartbeat.
Use 2 or more Pulse Sensors on one Arduino.
Visualize the pulse waveform and BPM from your Arduino in Processing.
Explore pulse timing differences with two PulseSensors. This is an educational experiment, not a blood-pressure measurement.
Functions, board examples, troubleshooting, and support
- PulseSensor Playground function guide
- All example sketches
- Board-specific examples and library reference
Start with the raw waveform in GettingStartedProject:
- Flat signal? Check power, ground, the analog pin, and the selected board and port.
- Noisy signal? Rest your hand, ease the pressure, reduce strong ambient light, and reseat the prepared sensor in the ring or strap.
- Extra or missed beats? Get a steady waveform first, then adjust the threshold in your example. In
GettingStartedProject, it isThreshold; other examples may useTHRESHOLDorsetThreshold(). - Serial port busy? Close other serial tools before opening Serial Plotter or Signal Coach.
For setup help, email support@pulsesensor.com with your board, example name, wiring photo, and Serial Plotter screenshot. Report reproducible library bugs in PulseSensorPlayground Issues.
For educational and experimental use. PulseSensor is not a medical device.
PulseSensor.com® · World Famous Electronics LLC · MIT License