2021.10 (247)

iOS 15

• Supports time-sensitive notification interruption level. See the docs.
• Adds binary_sensor.focus which reports on your device's focus state (aka do-not-disturb). This updates immediately in the background. You’ll need to enable permission in App Configuration > Sensors.
• Dynamic notification actions can now have icons using SF Symbols; for example, sfsymbols:bell. See the docs.
• Allows frontend microphone/camera access when the app has permission, rather than prompting each time.

(macOS 12 versions of these same features will be available at a later date.)

Widget Updates

• New “Open Page” widget to quickly open your "Lights" dashboard, History, Developer Tools, etc.
• Increases the number of actions in most “Perform Action” widgets by 2x.
• Fixes crashes and other errant behavior when opening from a widget repeatedly.

Miscellaneous

• Confirms local notifications with core 2021.10 or later, which eliminates potential missed notifications by falling back to non-local push.
• Upgrades MaterialDesignIcons to 6.1.95.
• Fixes a rare crash when sensors update and doing other network requests.
• Reduces the verbosity of Shortcut results. For example, instead of "called service light.turn_on" it is now "done.”

Mac

• Adds support for dynamic notification actions and content on macOS 11+.

---

TestFlight (iOS) • App Store (iOS, macOS) • iOS 12+, macOS 10.15+

2021.10 (246)

🖥 &📱Both Platforms

• Updated the appearance of the "Open Page" widget dramatically.
• Updated the appearance of the "Perform Action" widget less dramatically (it has a small gradient in the background).
• When a renamed-by-MDI icon is received for display in the App, the app will now transparently switch to the new name.

---

TestFlight (iOS) • App Store (iOS, macOS) • iOS 12+, macOS 10.15+

2021.10 (243)

🖥 &📱Both Platforms

Adds a new Widget: "Open Page" which can jump to a frontend page.

• For example, quickly open your "Lights" dashboard, History, etc.
• This is the first Widget to perform network calls, which required work to make them resilient: you should never run into a case where the links to pages fail to show up (as long as other Widgets on the system work) as long as it worked in the past.
• Creating, deleting or editing a Dashboard should (after 24 hours or launching the app) automatically update the Widget display, too.
• Please report any instances of the above 2 things not being true.

Increases the maximum number of actions the Perform Action Widget can handle:

• small (1, previously 1) [Apple limitation]
• medium (8, previously 4)
• large (16, previously 8)
• extra large (32) [new on iPadOS 15]

This also fixes some crashes & bugs with tapping an action in a Widget, leaving the app, tapping another, etc.

---

TestFlight (iOS) • App Store (iOS, macOS) • iOS 12+, macOS 10.15+

2021.10 (238)

🖥 &📱Both Platforms

• Confirmable local notifications in core-2021.10 (beta later this week). This eliminates potential missed notifications by falling back to non-local push.
• Fixes a rare crash when sensors update and doing other network requests.
• Reduces the verbosity of Shortcut results. For example, instead of "called service light.turn_on" it is now "done."

📱 iOS 15

• Icons in dynamic notification actions using SF Symbols; for example, sfsymbols:bell. See the documentation.
• Allows frontend microphone/camera permission when the app has permission without prompting.
• Adds focus permission to the onboarding screen and fixes a few visual and behavioral problems in permission granting.

---

TestFlight (iOS) • App Store (iOS, macOS) • iOS 12+, macOS 10.15+

2021.10 (230)

📱 iOS 15

Adds support for time-sensitive notification interruption level. See the docs: https://companion.home-assistant.io/docs/notifications/notifications-basic/#interruption-level

Adds binary_sensor.focus which reports on your device's focus state (aka do-not-disturb).

• This updates immediately, even in the background.
• For now, must manually enable the permission for this in App Configuration > Sensors

You can install the iOS beta from TestFlight.

🖥 &📱Both Platforms

• Upgrades MaterialDesignIcons to 6.1.95.

🖥 Mac-specific

• Adds support for dynamic notification actions and content on macOS 11+.

Note that macOS 12 support (for the iOS 15 features above) will come later this year, as Apple makes it difficult to do builds for both iOS 15 and macOS 12 at this time.

This is a beta for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.

2021.8 (216)

🖥 &📱Both Platforms

• Prevents loading the WebView when launching the app in the background. This should reduce bandwidth, memory and battery usage of e.g. location updates which launch the app.
• Notifications can now change badge values when sending a command like clear_notification.
• Fixes a case where local push would get stuck not alerting.
• Fixes some incorrect location update cases that happen in future versions of iOS.
• Fixes error messages when initially connecting to a server fails for some reason.

📱iOS-specific

• Fixes playback of animated GIF notification attachments.

🖥 Mac-specific

• Fixes a crash when changing the active sensor's idle time setting; allows sub-minute idle time values.

This is a stable for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.

2021.8 (212)

🖥 &📱Both Platforms

• For Local Push, badges can now be changed when sending a command like clear_notification. For remote, this is already live.
• Improves error messages when connecting to a server fails for certain reasons.
• Fixes incorrect location updates when just the longitude value is incorrectly 0.0. This appears to be an iOS 15 bug.

🖥 Mac-specific

• Fixes a crash when changing the active sensor's idle time setting; allows sub-minute idle time values.

This is a beta for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.

2021.8 (208)

All feature requests have been moved to Discussions. Vote on your favorite, add new ones; it should be a lot easier now.

🖥 &📱Both Platforms

• Prevents loading the WebView when launching the app in the background. This should reduce bandwidth, memory and battery usage of e.g. location updates which launch the app.
• Possibly fix phantom local push subscription not alerting -- there may be some cases where the server thinks Local Push is connected, but the local connection got confused.

📱iOS-specific

• Fixes playback of animated GIF notification attachments.

🖥 Mac-specific

This is a beta for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.

2021.7 (202)

Local Push

Receive push notifications without going through the internet, directly from your HA server and without affecting rate limits. You can read more about this in the documentation.

iOS

• Requires core version 2021.6 or later and iOS 14.0 or later. This uses a little-known iOS feature introduced in iOS 14 to allow notifications during times of low or no internet connectivity, for example on cruises or in an RV.
• Specify internal SSIDs in Connection Settings for Local Push to be enabled on. This is restricted to working on your local network.
• View the current Local Push status in App Configuration > Notifications.
• You can disable Local Push under the Internal connection settings. You may need to restart your device after upgrading if it is stuck on Disabled.

Mac

• Requires core version 2021.6 or later.
• Works whenever the app is running. When the app is not running, push notifications will delivered as they were before.
• View the current Local Push status in App Configuration > Notifications.

Miscellaneous

• Badge will now reset to 0 automatically when opening. You can turn this off in App Configuration > Notifications.
• Fixes a crash when a port larger than the maximum (65535) or a hostname beginning with a colon (:) is specified as a connection URL.
• Fixes incorrectly reloading often the webview if connection URL uses a default port (80 for http, 443 for https) and specifies it in the URL.
• Fix incorrectly entering a sub-100m zone whose regions intersect another nearby zone.
• Fixes the sizing of several watch complication images.
• Fixes an issue where the app would get banned when outside the local network after setting up the app via trusted_networks. In December, HA started rejecting connections in this scenario, which the app didn't realize wasn't retryable, so it would retry and get itself banned. This will now log you out instead.

🖥 Mac-specific

This is a stable release for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.

2021.7 (200)

🖥 &📱Both Platforms

• Badge will now reset to 0 automatically when opening. You can turn this off in App Configuration > Notifications.

📱iOS-specific

• Fix incorrectly entering a <100m zone whose regions intersect a nearby zone.

Known issues with Local Push:

• Local Push status will be "Disabled" (after upgrade until the app is restarted at least once.
• The recently-introduced update_complications command does not work.

🖥 Mac-specific

This is a beta for macOS Catalina (10.15) or later. You can also install from the Mac App Store or disable beta updates in Preferences to stay on stable releases.