Companion app for iOS 2023.12: Let’s go!

We have good news for those hoping for more features and faster development of the iOS Companion App! I, Bruno Pantaleão, have joined Nabu Casa as an iOS engineer (of course, also working on watchOS, iPadOS, and macOS apps), and am planning to continue the great work done by Robbie Trencheny, Zac West, and the community, giving the iOS app the attention that it deserves. So let’s talk about this month’s 2023.12 release of the app!

Apple Thread network credentials sharing

If you have HomePods or Apple TVs and you also have a Thread border router in Home Assistant, you may want to take advantage of Apple’s network to control devices in your home. You can now import your Apple Thread credentials into Home Assistant and then make Apple the preferred Thread network.

New watchOS App Icon

We updated the Apple Watch App Icon with the new Home Assistant logo.

Toggle all scenes for watchOS

Previously, you would have to disable scenes one by one to hide them on your Apple Watch. If you, like me, have a Philips Hue bridge, you would probably see several auto-generated scenes (like ‘Bathroom concentrate’ and ‘Bathroom Arctic aurora’ below :D ) that are not always relevant to see on your watch. We added a button to quickly toggle between all scenes now in the iOS companion app.

Keep up with “What’s new” in the App

We have added a What’s new? link in companion App settings so you can quickly access the latest App release notes.

Support for iOS 12, 13, and 14 in 2024.01

In the new year, we will do some housecleaning to make sure that the iOS Companion App is prepared for the future. To do so, we will stop supporting iOS 12, 13, and 14 in release 2024.01 of the Companion App. We know our users are repurposing older phones and tablets into dashboards and controls for their homes, which aligns with our focus on sustainability. It’s why we try to keep our apps running on older devices for as long as we can.

Currently, less than 1% of our users (according to the App Store analytics provided by users who gave permission to share their data with Apple) are still on these three iOS versions. Supporting them makes the codebase hard to maintain and blocks us from using newer iOS features. This change will make it easier for new contributors to feel comfortable contributing to the iOS codebase, which is also one of my goals. With a more modern codebase, we can give more attention to PRs and help other contributors have everything they need to feel comfortable submitting PRs.

This does not mean your iOS 12, 13, or 14 devices have become unusable. You can still access your Home Assistant using the browser if you have a device that can’t update past iOS 12, such as the 2014 iPhone 6 or iPad Mini 3. All other devices currently capable of running iOS 13 or 14 can be updated to iOS 15 or higher and use the new versions of the iOS Companion App.

On the roadmap

Wondering what we have on the roadmap for our Apple apps? We’re still working on it, but you can expect further developments to make Home Assistant on the Apple ecosystem more integrated, bringing shared features between iPhone, Apple Watch, iPad, and Mac - and I’m looking forward to getting my hands on Apple Vision Pro and seeing the possibilities it brings to the Open Home. We’re also planning on improvements to Siri shortcuts widgets and as many new sensors as possible. Another feature that is on our radar is Assist; in 2023, we completed the Year of the Voice. Android users benefitted from some extra functions compared to iOS users, and we want to make sure we catch up and bring these features to iPhones as well!

This is a companion discussion topic for the original entry at

more features and faster development of the iOS Companion App

Great update! Thank you, keep up the good work <3

1 Like

Great! This news is a nice Christmas gift

PS: don’t forget carplay :grin:


A very cool feature would be to have an option that prevents the App from rotating to landscape automatically.


My companion app and HA itself are both up to date. But I have a very different screen from what was shared with the update. My HA and Apple devices are on two different networks and it’s not clear how to get them together, how to take advantage of the new features claimed in the iOS app. Is there new doc coming to go with this new feature?

Can you double check which iOS App version you have installed? We are currently on a phased release (running for 7 days) of 2023.12

I forgot to mention that, it’s coming :smiley:


I’m on 2023.7 (2023.471).

It’s funny I looked for an update this morning and it said I was up to date. I just checked again and got 2023.12 (2023.499).

Great success! Thank you!

1 Like

How are you able to get them to be combined? I’m able to get the credentials from my Apple Products, but it still only shows my Silicon Labs as my preferred network and not the combination of all of them.

Thanks for the awesome work so far! When will we be able to see home assistant in apple carplay? Wondering about this for years now … thanks !!


Got 4 Apple border router, but on import credential I got the error message:
No preferred network found.

Companion Version 2023.12.4

What could be wrong?

Scroll down to the bottom of the list of apple border routers and there is a clickable link to set preferred network. Once that is your preferred network, you can click the three dots next to your HA border router and add it to the preferred network.

Mhh, sorry there is no link, screenshot from the bottom. Do I need a skyconnect stick?

my only ask is to include mTLS certificates, or optional user header key/value controllable pair so to add better Cloudflare WAF security for external access

1 Like

There’s something I wonder - why the iOS app is slower than running the UI in a browser? On Chrome and Safari page transitions are snappy, on the app there’s a bit of laggyness. Same experience on desktop as well. WebView can’t benefit from some kid of a hardware acceleration or something?

I’m also not seeing a thread list that looks like the screenshot. My Apple tbrs are separate and when I tap import credentials it gives me error 74.

You can use Siri Shortcut automations to do this currently and with an app. Personally, I always keep rotation lock on and just have an automation to turn it off and on when I open and close YouTube/Netflix.

I have exactly the same issue. :eyes: