Introducing an Home assistant integration for Hydros

Bitflip · Mar 23, 2026

Hello,

I had an opportunity to work on an Home assistant integration for Hydros, it should be considered Beta at this point.
I was only able to test it with the devices I own (X4, MINOW, XP8, water level sensor, rope leak sensor, flow sensor).
I will improve it as time allow, for troubleshooting there is a button to capture a sample configuration and data, please anonymize and/or select subset prior to sharing it if needed.

You can help me test it by installing it: HACS > 3 dots at the top > Custom repositories:
Repository: GitHub - Bitf1ip/ha-hydros: DIY Home assistant custom integration for Hydros Aquarium controllers
Type: Integration

Please read the readme / use a your own risks / this is a DIY effort, I am not affiliated and this is not supported by Coralvue in anyway.

BrockSamson · Mar 27, 2026

This is very cool. I don't have the equipment to help test it but as a Home Assistant user I'm excited for this sort of project.

I hope one day Hydros gives us local APIs so that we can at least read sensors without the internet. Nothing you can do about this but Coralvue could.....

Bitflip · Mar 27, 2026

I think it could work locally with hydros' help, but I do understand why its not just a matter of opening an API with the current architecture.

Thanks for the interest, I'm still looking for someone to figure out if this work beyond just me :)

Cheers

n2585722 · Mar 27, 2026

BrockSamson said:
This is very cool. I don't have the equipment to help test it but as a Home Assistant user I'm excited for this sort of project.

I hope one day Hydros gives us local APIs so that we can at least read sensors without the internet. Nothing you can do about this but Coralvue could.....

You can use bluetooth to read the sensors without wifi or internet. There is also an emergency mode you can setup before needed and that will also get you in to check outputs and inputs if you are at the controllers location.

Dana Gray · Mar 30, 2026

This is awesome!! I'm been looking for either an HA integration or Grafana plugin of sorts for Hydros. I've got an X4 and an XP8. I'll check this out and get back to you. Great job!!

BrockSamson · Mar 31, 2026

n2585722 said:
You can use bluetooth to read the sensors without wifi or internet. There is also an emergency mode you can setup before needed and that will also get you in to check outputs and inputs if you are at the controllers location.

Do you know have any links to info or documentation on this?

n2585722 · Mar 31, 2026

BrockSamson said:
Do you know have any links to info or documentation on this?

Click on the left menu in the app and then click the bluetooth icon at the top of the menu to switch to bluetooth mode. It will not let you make any setting changes in that mode but you can set an output to either off, auto or on if you need to do that. Also I have a build thread on R2R you can get to by clicking on the My Tank Thread banner on one of my post. Go to page #10 post #192 for info on emergency mode.

johnacharles93 · Jul 7, 2026

Bitflip said:
Hello,

I had an opportunity to work on an Home assistant integration for Hydros, it should be considered Beta at this point.
I was only able to test it with the devices I own (X4, MINOW, XP8, water level sensor, rope leak sensor, flow sensor).
I will improve it as time allow, for troubleshooting there is a button to capture a sample configuration and data, please anonymize and/or select subset prior to sharing it if needed.

You can help me test it by installing it: HACS > 3 dots at the top > Custom repositories:
Repository: GitHub - Bitf1ip/ha-hydros: DIY Home assistant custom integration for Hydros Aquarium controllers
Type: Integration

Please read the readme / use a your own risks / this is a DIY effort, I am not affiliated and this is not supported by Coralvue in anyway.

First off, thank you for all the work you’ve put into this integration. I’ve been using it for a while and really appreciate what you’ve built.

I wanted to let you know that I’ve started maintaining a fork of your project while experimenting with a few new features. My primary goal has been to add optional control support for compatible Hydros outputs (switches, modes, and variable-speed pumps where supported) while preserving the original monitoring-first philosophy you’ve established.

I’ve made it a point to clearly credit your project in the release notes and README since this work is built directly on the foundation you created. My hope is simply to expand the capabilities for users who want them, while keeping remote control disabled by default and emphasizing that Home Assistant should never replace Hydros’ native safety mechanisms.

If you’re interested, I’d be happy to share the branch or open a discussion about the implementation. I also welcome any feedback or suggestions you might have. Thanks again for creating such a great integration for the Hydros community!

nbooks · Jul 8, 2026

Haven't been on here forever, but google landed me on this thread looking for some hydros config info.

thanks for this!

johnacharles93 · Jul 8, 2026

nbooks said:
Haven't been on here forever, but google landed me on this thread as I'm trying to run 100w of heaters on an xp8. Now with this integration I can hopefully just use a cheap shelly relay.

thanks for this!

Let me know if you run into any issues. I’d love to expand upon this.

nbooks · Jul 8, 2026

johnacharles93 said:
Let me know if you run into any issues. I’d love to expand upon this.

Sorry, just caught your post on the hydos fb page too lol.

Have to sit down and think it out more, but my goal is xp8 powering a shelly relay that then powers an outlet controlling an inkbird. Should keep some hydros redundancy for testing at least i think

johnacharles93 · Jul 8, 2026

nbooks said:
Sorry, just caught your post on the hydos fb page too lol.

Have to sit down and think it out more, but my goal is xp8 powering a shelly relay that then powers an outlet controlling an inkbird. Should keep some hydros redundancy for testing at least i think

No worries, I am here. Let me know what you want done, and I will see if it is possible. I plan on building this out even further just need other people's input. I have some cool ideas once the Kraken is released.