Skip to main content

A graphical user interface for feature extraction from heart- and breathing biosignals.

Project description


GH Actions codecov DOI PyPI version JOSS

General Information

biopeaks is a straightforward graphical user interface for feature extraction from electrocardiogram (ECG), photoplethysmogram (PPG) and breathing biosignals. It processes these biosignals semi-automatically with sensible defaults and offers the following functionality:

  • processes files in the open biosignal formats EDF, OpenSignals (Bitalino) as well as plain text files (.txt, .csv, .tsv)
  • interactive biosignal visualization
  • biosignal segmentation
  • benchmarked, automatic extrema detection (R-peaks in ECG, systolic peaks in PPG, exhalation troughs and inhalation peaks in breathing signals) with signal-specific, sensible defaults
  • automatic state-of-the-art artifact correction for ECG and PPG extrema
  • manual editing of extrema
  • extraction of instantaneous features: (heart- or breathing-) rate and period, as well as breathing amplitude
  • .csv export of extrema and instantaneous features for further analysis (e.g., heart rate variability)
  • automatic analysis of multiple files (batch processing)



biopeaks can be installed from PyPI:

pip install biopeaks

Alternatively, on Windows, download biopeaks.exe and run it. Running the executable does not require a Python installation.

You can find more details on the installation here.


Have a look at the user guide to get started with biopeaks.

Contributors welcome!

Improvements or additions to the repository (documentation, tests, code) are welcome and encouraged. Spotted a typo in the documentation? Caught a bug in the code? Ideas for improving the documentation, increase test coverage, or adding features to the GUI? Get started with the contributor guide.


Please refer to the biopeaks paper in The Journal of Open Source Software.


Have a look at the changelog to get an overview of what has changed throughout the versions of biopeaks.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

biopeaks-1.4.4.tar.gz (17.5 MB view hashes)

Uploaded Source

Built Distribution

biopeaks-1.4.4-py3-none-any.whl (17.7 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page