Skip to content
HomeBridge module for the DIY particulates sensor. See how to build your own
Branch: master
Clone or download
Latest commit 285b0e7 Jan 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Make air quality and temperature services independent of each other Aug 21, 2018
sample_data Add unit tests for DHT22 + BMP280 sensors Mar 13, 2018
test Add unit tests for DHT22 + BMP280 sensors Mar 13, 2018
.travis.yml add travis config Feb 6, 2018
LICENSE Initial commit Dec 18, 2017 Add documentation on the history persistence options Mar 18, 2018
screenshot.jpeg add screenshot Dec 20, 2017


Tavis CI build status

HomeBridge module for the DIY air particulates sensor from OpenData Stuttgart.

It can be used to see the status of your own sensor in HomeKit. You can also use it to see another sensor if its data is published to (see here).


  • See air quality (incl. particulates values for PM10 and PM2.5), temperature and humidity in HomeKit and the Home app
  • Get the data from a sensor on your local network
  • Get the data from public sensor on
  • Soon: See history for temperature, etc. using the Elgato Eve app


First follow the instructions for HomeBridge.

Install homebridge-airrohr using (sudo) npm install -g homebridge-airrohr.

Configure your AirRohr sensor in the homebridge settings file. See config.sample.json. All settings except update_interval_seconds (defaults to 120 seconds) and history (defaults to persisting to memory) are required.

See the documentation of the fakegato-history module for the list of supported options.

To run this project you have two options

Option A: The sensor & homebridge in your (home) network

To do this set json_data to


using the same local network as your sensor.

Note: If you use a HomeKit hub (like a Apple TV or a iPad) you can still access your data from outside your home. See Apple's documentation for details.

Don't set public_temperature_json_data or public_airquality_json_data in this scenario.

Option B: Use the API

This allows you to add any sensor not only your own. To get the same functionality as above you need to set two IDs/URLs:

  • Set public_temperature_json_data to the URL where to find the temperature data:<YOUR_TEMPERATURE_SENSOR_ID>/

  • Set public_airquality_json_data to the URL where to find the air particulates (PM10, PM25) data:<YOUR_AIRQUALITY_SENSOR_ID>/

Don't set json_data in this scenario.

Note: If you set json_data the public_… settings will be ignored.


homebridge-airrohr in apple home app

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.