“Since when is eggnog a Christmas drink? Eggs are available all year ’round. I’ve been known to enjoy this poolside.” – Sheldon Cooper.
Ever since I’ve had a Blueriiot Blue Connect Plus for my swimming pool, I’ve been pulling the data into Home Assistant. Originally it was with an IFTTT interface – but that has long since been discontinued. A friend put me onto a GitHub repository where someone had reverse engineered the API and could query the status directly. I’ve since been using that inside a container that ran along side my Home Assistant instance.
Today I finally got around to moving the code out into a standalone add-on, so that anyone with a Blue Connect Plus can extract the data into Home Assistant.
Installation requires an additional repository to be added to Home Assistant. The repository URL is: https://github.com/MikeJMcGuire/HASSAddons. From there, the installation is pretty straight forward. You simply specify your Blueriiot username and password, and your MQTT details; and then the add-on will do the rest. The rest means creating 5 entities in Home Assistant – temperature (C/F), Orp, Ph, Salinity, and updating them every 30 minutes. The entities are registered and updated via MQTT.
Update (12/09/2022): It appears some devices report conductivity instead of salinity (salt pools measure salinity instead), which has been causing the add-on to fail to update Home Assistant as it believed it was missing data. This has been fixed in the September release.
~ Mike
Hopefully Helpful Hints // Mike J McGuire 
Hi Mike
Thanks so much for this – it makes the BlueConnect worthwhile !
Fantastic work as always (happy user of your Que container here)
Brilliant, thanks!
Nice to integrate but I get not information. Integration find my Blue connect but Qos is 0 always. I already have the entitities but no data on it.
Any feedback or any problem on it?
I could see that I have blue connect standard and not plus. Is this the reason?. I have premium suscription.
When trying to add the repository to Homeassistant I ghet a warning message stating this is not a valid repository. I had the integration installed before but now it is gone and I can not add it again
Hi there, can you confirm you have the right URL for the repository listed above?
Conductivity was not created, is it possible to add?
Hi there – do you mean the ORP value? There should be 4 sensors created, temp, ph, orp (conductivity), and salinity.
Howdy – added conductivity.
I’m trying to make this addon work but I get no data. The only thing that gets sent out is config at startup (to the topics ending in config) and then every 5 minutes I get a status-message to topic “hass-blueriiot/status”. The only information in this message is “online”. There is never any pool data (temp, pH, orp, salinity)being sent via MQTT.
Hi Carl – yep, I’ve been unable to test it with other types of device than my own. Happy to have a look if you’re able to be a tester for it.
Sure! What do you need?
Thanks Carl – much appreciated.
Hello,
I have HA in docker. How can install it?
Thanks
You could run the add-on as a container – you’d just need to copy the options.json file into a /data mount and make it available to the container. The options.json file is in the github repository for the add-on.
Hi,
Thanks for your great job.
May I ask you how many time data are refreshed ? Is it configurable ?
I see on Blueriiot website 20 measures per day which is not enough for automation I plan to do, ideally I need 4 measure per hour.
Best regards
Hi – I can’t control the frequency of updates coming from the pool unit. Once an hour is quite reasonable though given how long it takes to impact the temperature of a large body of water.
You are right, my interest is more in Orp to control the salt chlorinator to avoid Orp going to high, but I assume that an update every hour will be enough. Thanks for your answer and sorry for the late reply. I’ll keep you in touch when I will have some data about Orp evolution to let other people know.
any idea how to get this working if i have 2 devices?
31-01-2023 20:42:05.68 ASPNETCoreStartup.ConfigureServices()
31-01-2023 20:42:05.83 ASPNETCoreStartup.Configure()
31-01-2023 20:42:05.92 ASPNETCoreStartup.OnStarted()
31-01-2023 20:42:10.57 BlueRiiot.Run() [0x00000000]
31-01-2023 20:42:12.33 BlueRiiot.Run() [0x00000000] Multiple pools available.
31-01-2023 20:42:12.33 BlueRiiot.Run() [0x00000000] Pool “Pool” (f3f7fcaf-498d-454a-b23d-ce1c25ce5b44) found.
31-01-2023 20:42:12.33 BlueRiiot.Run() [0x00000000] Pool “Spa” (b5d6a0a8-a1db-463c-a5da-bc86c67a4cd9) found.
31-01-2023 20:42:15.48 MQTT.SendMessage() hass-blueriiot/status
Thanks Mike! Working great!
Mike,
I was finally able to get this but I do not get the entities, which should be the neames?
24-06-2023 12:23:07.25 ServiceCore.Start() Built: Mon 12/09/2022
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read BlueriiotUser
24-06-2023 12:23:07.31 BlueriiotUser: …
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read BlueriiotPassword
24-06-2023 12:23:07.31 BlueriiotPassword: *******
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read MQTTUser
24-06-2023 12:23:07.31 MQTTUser: …
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read MQTTPassword
24-06-2023 12:23:07.31 MQTTPassword: *******
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read MQTTBroker
24-06-2023 12:23:07.31 MQTTBroker: core-mosquitto
24-06-2023 12:23:07.31 Configuration.GetConfiguration() Read MQTTTLS
24-06-2023 12:23:07.31 MQTTTLS: True
24-06-2023 12:23:07.31 MQTT.StartMQTT()
24-06-2023 12:23:07.31 MQTT.StartMQTT() Host: core-mosquitto
24-06-2023 12:23:07.33 BlueRiiot.Start()
24-06-2023 12:23:07.36 ServiceCore.MQTTRegister()
24-06-2023 12:23:07.37 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_temperature/config
24-06-2023 12:23:07.38 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_ph/config
24-06-2023 12:23:07.38 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_orp/config
24-06-2023 12:23:07.38 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_salinity/config
24-06-2023 12:23:07.38 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_conductivity/config
24-06-2023 12:23:07.42 ASPNETCoreStartup.ConfigureServices()
24-06-2023 12:23:07.49 ASPNETCoreStartup.Configure()
24-06-2023 12:23:07.54 ASPNETCoreStartup.OnStarted()
24-06-2023 12:23:12.37 BlueRiiot.Run() [0x00000000]
24-06-2023 12:23:14.25 BlueRiiot.Run() [0x00000000] Pool “Playa” (….) found.
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/temperature
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/ph
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/orp
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/conductivity
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/temperature
24-06-2023 12:23:14.65 MQTT.SendMessage() sensor_pool/ph
24-06-2023 12:23:14.65 BlueRiiot.Run() [0x00000000] Current Latency: 40.4 minute(s)
24-06-2023 12:23:17.31 MQTT.SendMessage() hass-blueriiot/status
I was able finally to get it work, I had to disable TSL and remove the certificates 😦
Now I have an issue on the entities… it appears that the sensors do not have the `unit_of_measurement` defined as the history graph shows an on/off like instead of the graph of the measure. Can you fix it 🙂
I get the values but they are all different from the app.
On HomeAssistant I have a Temp of 24°C while on app I have 27.9°C
PH on HA 6.4 while on app is 7.6
I’m using the app NOT via bluetooth.
What it could be?
here is the weird thing:
Logbook
June 24, 2023
Pool pH changed to 6.4
6:45:33 PM – 26 minutes ago
Pool pH changed to 7.6
6:45:33 PM – 26 minutes ago
Pool pH changed to 6.4
6:15:33 PM – 1 hour ago
Pool pH changed to 7.6
6:15:33 PM – 1 hour ago
Pool pH changed to 6.4
5:45:33 PM – 1 hour ago
Pool pH changed to 7.6
the same happens for temperature, the correct value is read and immediately after a “default” value.
why is that?
7.6 is the pH from the app 🙂
Hi
What am I doning wrong, when I try to add the repository in HACS’s it says:
“The repository does not seem to be a integration, but an add-on repository. HACS does not manage add-ons”
Am I using the wrong ULR: https://github.com/MikeJMcGuire/HASSAddons ??
I would really love to get the Blue Connect into my HA 🙂
Thanks.
You add the repository to HA’s list of repositories – not HACS.
Thanks alot, I got it to work now
Awesome idea and I hope ?ll get it running one day. Sorry for the basic question, do I need the Wifi extention or the plus subscription or both?
I got no values in homeassistant and this error message
11-09-2023 15:09:33.15 BlueRiiot.Run() [0x00000000] Error (System.Net.Http.HttpRequestException): Unable to enumerate swimming pools. Response status code does not indicate success: 500 (Internal Server Error).
11-09-2023 15:09:37.58 MQTT.SendMessage() hass-blueriiot/status
Its designed for the plus subscription model.
Hi Mike,
I have the same error as Benjamin. Looking at the Blueriiot App it is telling me my Version is Blue Connect Plus. Do you mean that with your statement “Its designed for the plus subscription model”?
Thank
Peter
Yep.
Hi Mike,
great addon. I installed it, everything seems okay but i don’t see any sensors.
What am i doing wrong?
Hi Mike,
Same issue as Niederlasser
Hallo, ich habe seit heute meinen Blue Connect Go mit Premium und Wifi Extender,
aber ich bin zu doof, um mir Werte im Home Assistant anzeigen zu lassen. Ich hab schon alles probiert, aber ich glaube, das Addon verbindet nicht.
Kann mir bitte jemand helfen?
Danke
Hallo Stefan, hallo zusammen,
ich stehe wohl vor dem gleichen Problem, entweder stehe ich auch auf dem Schlauch oder es geht mit Blue Connect Go mit Premium wohl gar nicht. Habe einen Connect aber keine Daten bzw. kann ich keine anzeigen? Finde gerade auch nicht heraus was ich bei MGTT User und PWD eingeben kann. Evt. kann mir/uns jemand als Newbies helfen? Wäre klasse. Vielen Dank! LG Jobi
Hi
I got it to work with a blue connect Go, but it only updated when I asked for a measurement in the blue connect app.
I didn’t have premium so don’t know if that changes anything in that regards.
Hi
Thanks for pulling this add-on toghether. It’s working very well on my end.
One quick ask if possible: can you add a timestamp field for when the status was last updated?
Thanks
Hi Mike,
I installed your add-on, everything seems okay but i don’t see any sensors.
Can you help me?
Here below my log:
26-08-2024 19:37:36.04 MQTT.StartMQTT() Host: core-mosquitto 26-08-2024 19:37:36.10 BlueRiiot.Start() 26-08-2024 19:37:36.26 ServiceCore.MQTTRegister() 26-08-2024 19:37:36.30 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_temperature/config 26-08-2024 19:37:36.32 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_ph/config 26-08-2024 19:37:36.32 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_orp/config 26-08-2024 19:37:36.32 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_salinity/config 26-08-2024 19:37:36.32 MQTT.SendMessage() homeassistant/sensor/blueriiot/sensor_pool_conductivity/config 26-08-2024 19:37:36.41 ASPNETCoreStartup.ConfigureServices() 26-08-2024 19:37:36.58 ASPNETCoreStartup.Configure() 26-08-2024 19:37:36.72 ASPNETCoreStartup.OnStarted() 26-08-2024 19:37:41.27 BlueRiiot.Run() [0x00000000] 26-08-2024 19:37:44.21 BlueRiiot.Run() [0x00000000] Pool “HSHPool” (07cdff53-0f91-4864-bed1-98a8779f2e77) found. 26-08-2024 19:37:45.26 MQTT.SendMessage() sensor_pool/temperature 26-08-2024 19:37:45.26 MQTT.SendMessage() sensor_pool/ph 26-08-2024 19:37:45.26 MQTT.SendMessage() sensor_pool/orp 26-08-2024 19:37:45.26 MQTT.SendMessage() sensor_pool/conductivity 26-08-2024 19:37:45.26 BlueRiiot.Run() [0x00000000] Current Latency: 83.5 minute(s) 26-08-2024 19:37:46.04 MQTT.SendMessage() hass-blueriiot/status 26-08-2024 19:42:46.04 MQTT.SendMessage() hass-blueriiot/status
Thanks,
Paolo
Problem solved re-digiting the MQTTBroker name as “core-mosquitto”
Does this still work? I just added it, but I don’t really get any informations in the app… In the log files in find my pool.
Hi I have been using this for a while and its been great but now I cant seem to get any data from the sensors. I am getting updates in the app but in Home Assistant I get a ‘Error (System.Net.Http.HttpRequestException): Unable to enumerate swimming pools. Response status code does not indicate success: 500 (Internal Server Error).’ message and the sensor values are zero
I have just replaced the battery in the sensor unit so I dont know if that is related, and I have installed the add-on onto a new instance of HA but am getting the same error
Would you have any suggestions I could try
thanks for a great add-on
I have the same issue. I’ve changed battery either.
Hi. I think this error is because your login is incorrect. Double check that your username and password are the same as in the iphone/android app login. Not the Virtualpool.io login. I also had to turn TLS off for it to work for me
I was able to get it working again by logging out of the app and resetting the password. I logged in through the app and was then able to get this to connect
New Blueriiot user, I’ve got a Blue Connect Go with “Premium” activated on it.
Installed your application, provided username and password for both blueriiot and MQTT.
Immediately started getting the data into HA. Excellent!
Thank you very much for creating and sharing the application.
Awesome, glad to hear it!
Hello , can you help me on this on the app i can’t register the water volume.
any solution?
thx
Hello, I installed the add-on and it shows that data is coming in (see log), but I can’t find any entities where the values are stored. What am I doing wrong?
14-08-2025 10:55:31.28 BlueRiiot.Run() [0x00000000] Pool “Pool” (cb0acffd-dcd9-4fdc-9933-5acd25e3ba83) found.
14-08-2025 10:55:31.66 MQTT.SendMessage() sensor_pool/temperature
14-08-2025 10:55:31.66 MQTT.SendMessage() sensor_pool/ph
14-08-2025 10:55:31.66 MQTT.SendMessage() sensor_pool/salinity
14-08-2025 10:55:31.66 BlueRiiot.Run() [0x00000000] Current Latency: 40.5 minute(s)
14-08-2025 10:55:35.65 MQTT.SendMessage() hass-blueriiot/status
Looks like its picking up the pool data, but not getting it to MQTT perhaps. Can your MQTT server see the pool info coming in?
Good morning, how do I figure this out? I’m a bit of a beginner when it comes to MQTT.
Got it – mqtt User/Password problem.
Awesome
Good morning, how do I figure this out? I’m a bit of a beginner when it comes to MQTT.
Hi,
Thank you Mike for this awesome add-on that works like a charm. But – the statistics are only saved for the last 30 days (default setting for recorder) – and are not saved in “long term statistics”. Is there a solution for this (would like to see a graph for water temperature and so on for more than 30 days)?
Thx