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.

3

I ended up using a Multirelay instead, and when changing the unit to external control, the integration doesn’t work.

4

Thanks so much for doing this! I am using it with the AprilAire E070W. It was discovered automatically. So far the target humidity changes work and the state updates are accurate. The reason I opted for the wifi version was so I could monitor it through HA and now I can!

5

Thanks for sharing, this is great! I set it up today and plan to use it for a few things. Monitoring on dashboard etc. and for peak rebate events from power company in case it is in the middle of a long run it will set back a few % until after the event. It worked great but did spit out an error at the end of the event (though it did actually take the command). I tested it manually after and it worked fine with no errors so maybe a fluke.

image
image1954×1473 265 KB