open-earable-python 0.0.3

DEPRECATED: renamed to open-wearable. Reader and utilities for multi-sensor OpenEarable recordings.

Open Earable Python

[!WARNING] open-earable-python is deprecated and has been renamed to open-wearable. Migrate now:

• Install: pip install open-wearable
• Update imports: from open_earable_python import ... -> from open_wearable import ...
• Deprecation timeline: this package receives only critical fixes until December 31, 2026.
• Migration guide: docs/migration-to-open-wearable.md

Python toolkit for parsing and analyzing multi-sensor OpenEarable recordings.

Installation

pip install open-wearable

Legacy package (deprecated):

pip install open-earable-python

For local development:

git clone https://github.com/OpenEarable/open-earable-python.git
cd open-earable-python
python -m venv .venv
source .venv/bin/activate
pip install -e .

Quick Example

from open_wearable import SensorDataset

dataset = SensorDataset("recording.oe")

# Combined time-indexed DataFrame of all parsed sensors
df = dataset.get_dataframe()

# Per-sensor views
imu_df = dataset.imu.df
ppg_red = dataset.ppg["ppg.red"]
audio_df = dataset.get_audio_dataframe()

Documentation

• Documentation index
• Getting started
• Data model and sensor channels
• API reference
• Migration to open-wearable

License

MIT. See LICENSE.