Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
95 lines (56 sloc) 2.31 KB


PyPI version

Python package for getting sensor values from an Ambient Air Sensor such as offered by Rehau.

About VOC sensors

VOC (Volatile Organic Compounds) potentially contribute to long-term health issues when exposed to them over a long time period [1]. The sensor outputs numerical values typically in the 450-2000 range. According to the internet [2]:

  • 450-1000 Good air quality
  • 1000-1500 Medium air quality
  • 1500- Bad air quality, consider opening a window for fresh air.

Getting Started

This section will introduce you to airsensor-py and how to install and use it for fun and profit.


Make sure that python 3 + pip is installed.


This package is published on pip from time to time.

pip install airsensor-py

To get the most recent version, clone this repository and install locally.

git clone
cd airsensor-py
pip install -r requirements.txt
pip install -e .


You can either use this package as a library in your code or using the bundled CLI. You'll have to run it as root or set up a udev rule to grant r/w access to the device to the user. For more instructions on that, see here.


from airsensor.core import AirSensor
airsensor = AirSensor()
voc = airsensor.get_voc()

> 450


$ airsensor-py

> 450


$ airsensor-py --json
> {"timestamp": "2017-05-05 10:30:05", "voc": 450}

Built With


This project is licensed under the MIT License - see the LICENSE.txt file for details


Want to add a feature or report a bug? Open an issue or a pull request for me!


  • A C implementation was done by Rodric Yates which I used to see how the interaction with the device works.