/hass-blueair

BlueAir sensor integration for HomeAssistant

Primary LanguagePython

hacs_badge

Blueair Filter Integration for Home Assistant

A simple BlueAir sensor and fan integration for HomeAssistant.

The basic sensor integration uses a modified unofficial BlueAir client by @thedjinn gather information from the sensors and control the fan with @spikeyGG's implementation on BlueAir filters

Installation

Recommended

  • Install with HACS.

Manual

  • Copy custom_components/blueair to your HomeAssistant base config directory (the place where configuration.yaml lives)

Configuration

The integration is configured through the Home Assistant UI. No need to edit yaml files today.

  • Configuration -> Devices and Services -> Add Integration
  • Search BlueAir, and enter your username and password

Compatibility

A note on compatibility and testing, I only have 280i filters. The API response from Blueair is different for other series of filters, and these differences may break the integration. Several people have contributed patches to make this integration work with other BlueAir models, and I'm really grateful for that help.

I'm relatively confident we are correctly supporting

✔️ Classic 280i

✔️ Classic 605

Other classic, and classic i models should be similar enough that I would expect them to work (Classic 480i, Classic 505 etc.).

If you have a filter from the Protect, Dust Magnet or Blue product lines (I'm not even sure if these are all connected devices) and are willing to share API responses and help up build support for these products please feel free to open an Issue :)

HASS BlueAir Device