Actron Que and Home Assistant

Sheldon: “I’d love to, but I’m too busy falling back in love with Windows 98.”
Leonard: “Seriously? You haven’t used this desk in years. The second I want to get rid of it you’re up here working.”
Sheldon: “I can’t talk right now. I have several thousand updates to install.”

I’m very pleased to say that the add-on I created to enable the Actron Connect module to be accessed from Home Assistant has been getting quite a bit of use, not only by myself. However, Actron now have a new device available called the Actron Que. I’ve had a couple of queries now about having an add-on/integration for Que and Home Assistant, so I’ve decided to create a new add-on to interface between those systems.

I’m only just starting on it, so it will be in beta for a few weeks. I don’t have a Que at home, so am reliant on some kind souls temporarily giving me credentials to their Que system for a bit of testing. Please feel free to volunteer if you’d like to help.

I’ll update this page as the add-on progresses. At this stage, it looks like the add-on will simply be accessing the Que API on the cloud service, and registering an air conditioner entity with temperature, compressor state, fan speed, mode etc; a series of switches – one per zone; and potentially a series of temperature sensors – if you have a different temperature sensor per zone. As such, you’ll need to configure the add-on with the credentials for your Que account.

The add-on needs an MQTT broker to handle messaging to Home Assistant. The default configuration assumes you’re using the Mosquitto MQTT broker that comes with Home Assistant, but you could use any other product if you preferred – just ensure you have discovery enabled.

The add-on has been compiled for amd64, armhf, armv7, and i386, and tested on a Linux 64bit virtual machine, and a Raspberry Pi using a 32-bit Home Assistant image.


Add a new add-on repository to your Home Assistant deployment, and you should be able to access the compiled add-on.

Add On

The repository for the add-on is here: It should install fairly quickly, the add-on is about 200mb.


You need only configure a couple of settings to use it. If you leave the default MQTTBroker of ‘core-mosquitto,’ it will use the Mosquitto add-on of Home Assistant (core-mosquitto is the internal name of the Mosquitto add-on when hosted by Home Assistant). You could also put the IP address/host name of your broker if you host it elsewhere.

You will also need to specify:

  • Your Que username and password.

Development Update (22 Feb v0.17):

  1. Create authentication/token system – done.
  2. Retrieve current state of the AC – polling every X seconds, and display that data on a climate entity in Home Assistant – done.
  3. Retrieve current state of the zones – polling every X seconds, and display that data on switch entities in Home Assistant – done.
  4. Push changes from Home Assistant’s climate or zone switch entities back to the Que web service – done.
  5. Change from polling to an event based service – assuming the Que service provides an event feed, or HTTP long poll type capability so that the add-on reflects changes instantly without the constant polling – in progress.
  6. After submitting a change (i.e. on/off, temperature, zone), the add-on should pull new events from the cloud service at a much faster rate until the changes are acknowledged. This should shorten the time it takes to update HA – done.
  7. Provide an option for a per-zone climate entity in HA to enable the adjustment of the set temperature per zone – done.

The add-on has been compiled for all platforms and uploaded, so its available for testing. If you need to get in touch due to an issue with the add-on, leave a comment below and I’ll reach out.

Other notes:

  • It is currently polling for events/changes every 30 seconds, however this is now configurable. The add-on only asks for new events so its not downloading a full 20k status, but rather 600 or so bytes if there are no changes to report.
  • The add-on will now auto-discover the serial number of the Que unit, and auto-discover the zone count and zone names. If you were to add/remove a zone, simply restart the add-on to discover the zone changes.
  • You will need to set the PerZoneControls configuration option to true in order to see the per-zone climate entities.

~ Mike

33 thoughts on “Actron Que and Home Assistant

  1. Hi Mike,

    This is great news, happy to assist in anyway I can with testing.
    I have actron que with wireless temp sensors in each zone.

    I currently have my system functioning to a degree in node-red, I just can’t get my head around the switch node and having multiple zones setup at once plus I haven’t had the time….

  2. Just want to advertise the hell out of this Mike. You’ve done an awesome job with this and it’s been rock steady and reliable for me for the last few weeks. It’s so good Actron should officially support this as it makes the Que even better now it interacts with modern smart homes.

    Next step is per zone temperature controls but respect your time especially as you don’t have a Que yourself!

    Thanks again for all you’ve done.

    1. Much appreciated Shane. Last few weeks have been a little hectic at work! I got most of the way there with the per zone climate controls, but need to do some more testing before release. Will try get that out today.

  3. Looking on Github these all seem to be for I’m not sure how familiar you are with vanilla Home Assistant and was curious if you had any appetite for making this into a customer component for Home Assistant as I’d love to by able to control my Actron QUE in HA

    1. Howdy, the github repo has a docker compose yaml file – you should be able to run the container anywhere. The only requirements really are for the options.json file to appear in a /data directory inside the container (included in the yaml fie), and for the container to connect to the MQTT used by HA. So you can run it quite happily outside of Let me know how you go.

  4. This works fantastic, 100% better than using the terrible app !
    If you are looking for some testers, I’ll happily assist.

  5. Nice work! I just installed Home Automation on my workstation, MQTT and your add-on. It seems to be working – I can see new client connectted as hass-actronque in the MQTT logs, and various messages in the QUE log like “MQTT.SendMessage() hass-actronque/status”. But I cannot figure out how to display and/or control the actual device – mostly because it’s the first time I’ve used Home Automation. What should I do next?

    1. It’s all pretty automatic.

      When you setup the MQTT integration, you need to enable autodiscovery. Then the climate device that the add-on registers in MQTT will appear in HA to be controlled.

      Did you see in the logs for the add-on, when it starts, that it successfully authenticated to Que and discovered your AC?

  6. Wow

    Firstly Thank you for your hard work in creating this.. I love my Que AC but cant stand thier damn App…

    This is fantastic, i was completely unaware of this Home Assistant world 24hrs ago .. so after researching and installing hassio, MQTT and now your Q add on im having a ball.. All my lights and so are not setup and Your add on is working great.

    goodbye crappy Actron app/cloud 🙂

    Now to look into changing the UI.. im sure theres a way.. Newbie here..

    Thank again

  7. I started again, it does look like it’s working. Under Logbook I can see a bunch of events associated with “Entities” which are clearly from my QUE (Study Air Conditioner changed to heat). They also appear under Configuration / Entities.

    I suspect I just don’t know how to use Home Assistant yet but I don’t see a way of adding them to a dashboard.

    1. I’ve figured it out thanks! Also there’s a lot of other information available on the master controller such as outside temperature, compressor speed, zone damper %. Do you plan on adding this or it not available via the cloud?

  8. HI Mike
    Thanks for your fantastic work !
    I’m using it with Homekit and it’s working really well.
    The only issue is that restarting hass seems to lose all the Homekit customisations (so which room each zone is in, and some of the naming). Do you have any idea how to make this persist across restarts ?

    1. Hi Graeme, thanks for the feedback!

      That’s interesting about homekit. The add-on simple registers entities with HA. HA then makes the appropriate entities available to homekit with the homekit integration. I’ve only ever seen the issue once with apple/homekit forgetting the customisations, and it was a good year ago after a HA version upgrade – I’ve never seen it since. Any homekit customisation for any entity should be persisted. All I could suggest is turning on the homekit logging (the ha documentation for the integration will have that info) – and see if the homekit logging is reporting any integration issues.

      1. Thanks Mike

        I’ll take a look at HomeKit logging.

        From some googling it seems like I may need to add a delay in HA before firing up the HomeKit component, in order for your integration to fire up first.
        It appears that if HomeKit fires up before entities are registered, it will clear the bridge and then re initialise everything as they are added

        I notice that in HA, the fan controls are exposed, but in HomeKit, the only modes are Off, Heat, Cool and Auto; is this a HomeKit limitation ?

        Thanks again for your hard work – its a fantastic plugin and so much reliable than Actron’s app !

  9. Yep good point – the integration needs that automation in place to start. I’m pretty sure the integration doco on the HA website has the configuration of that as well.

    Yeah the homekit climate object doesn’t have a fan speed option unfortunately. I’ve actually myself started using the HA mobile app more than the apple one for many of those reasons.

      1. No, it isn’t necessary. The add-on immediately registers the entities via MQTT upon startup – i.e. it’s not waiting to hear from the air conditioner. Once HA has connected to MQTT – it will refresh those entities. Putting a 10 second delay onto the HomeKit start will be more than sufficient.

  10. This is awesome and works well in my 4 zone setup! Thanks heaps!!

    Is it possible to create an automation within home assistant to turn a specific zone on when the temp drops below a certain value? i.e, if a specific zone drops below 17c then turn on heating for that zone with a set temp of 19c? Or if the temp goes above 29c then turn on cool for that zone with a set temp of 25c?

    I have a computer room with DAS and a NAS setup, I’m wanting to keep it somewhat temp controlled without turning on the rest of the house specifically when I’m not home.

    1. Hi James. You could create an automation in HA to run based on time, or events. You could have it react to the event of the temperature sensor changing, or every hour for example. You could then call HA services to take action, i.e. turn on ac, change zone, set temp etc. There’s lots of examples of the automations, and help available in the forums – someone will have definitely created the automation to which you’re referring before. Have a look on the developer tools tab of HA – you can see the services and the entities you’d need to use in your automation.

  11. Hi
    I am not tech hence my query
    I have an actron que and my aim is to try and have a homekit integration. I have a device called as HOOBS based on homebridge which has enabled a few products to be integrated.
    However it looks like HA is different from homebridge.
    For the uninitiated how painful will the HA set up be ?

    1. HA setup is generally pretty straight forward and quick – and there is significant community support/guides/forums available.

      They generally start with a Rasperry Pi device for hosting.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s