AprilAire Dehumidifiers Integration for Home Assistant via HACS

Share your Projects! Custom Integrations
1

[Custom Integration] AprilAire Dehumidifiers Integration for Home Assistant via HACS

Hi all,

I wanted to share a custom Home Assistant integration I just published for AprilAire cloud-connected dehumidifiers:

I built this for myself because I have an AprilAire E100W and wanted it in Home Assistant, but after a lot of searching I couldn’t find an existing integration for AprilAire cloud dehumidifiers anywhere on GitHub or the wider internet.

The weird/fun part is that the aprilaire.io API used by the dehumidifiers seems to be undocumented, but I ended up reverse engineering the Android APK to figure out the routes and WebSocket behavior. Once I got into it, I was kind of surprised by how full-featured the API actually is.

At this point it is working in my own Home Assistant instance with my AprilAire E100W, so I cleaned it up and published it in the hope that other AprilAire owners can try it and help confirm support across more models.

What it currently supports

  • Home Assistant config-entry setup
  • HACS custom repository install
  • AprilAire cloud accounts on aprilaire.io
  • supported dehumidifiers with internal %RH humidity setpoint control
  • automatic device discovery
  • multiple devices on one account
  • WebSocket-first updates
  • target humidity control
  • on/off control
  • diagnostics and standard Home Assistant integration behavior

What it does not support

  • aprilairestat.com
  • thermostats
  • devices using drynessSetpoint
  • unsupported control profiles

Install

The easiest path is through HACS as a custom repository:

  1. Open HACS
  2. Add https://github.com/billda/ha-aprilaire-cloud as a custom repository of type Integration
  3. Install AprilAire Cloud
  4. Restart Home Assistant
  5. Add the integration from Settings > Devices & services

There is also a one-click HACS link in the README.

Looking for testers

I would really appreciate reports from anyone with:

  • AprilAire models other than the E100W
  • multiple devices on one account
  • different firmware revisions

If you try it, please let me know:

  • what model you have
  • whether it was discovered automatically
  • whether target humidity changes work
  • whether state updates stay in sync

PRs and contributions are very welcome on Github! Be nice, this is my first custom HA integration and my first open source project :slight_smile:

(This project is unofficial and not affiliated with AprilAire)

2

Thanks for sharing. I just got an E100W today and I will let you know how it goes.