2021.12 (278)

Note: downgrading (back to 2021.11) from this release will require deleting your local actions, notification categories and watch complications.

Multi-Server

This is largely complete, but it could use extensive testing. Please report issues on GitHub, Discord or the Forums.

• Add additional servers in App Configuration. Switch to them there as well (eventually this will be easier).
• core-2021.10 is required for notification actions or attachments.
• Action, Watch Complication and the macOS Menu Bar title template require selecting a server to act against.
• When navigating to a my.home-assistant.io or homeassistant://navigate link, you'll be prompted which server to use.
• Adding an additional server may require updating some existing Shortcuts.app shortcuts to specify which server use.

Known issues

• Actions, scene actions, and notification categories defined in the HA configuration with duplicate identifiers across the multiple servers will fight each other; one server value will win.

Fixes

• Provides clearer error if mobile_app is not loaded during onboarding.
• Fix onboarding error 404 when URL has a trailing /.
• Improves the reliability of the "Local Push" status, which is now under the server rather than in Notifications.

---

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

2021.11.1 (266)

Fixes a crash during onboarding when setting up not using a manual address.

---

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

2021.11 (262)

macOS 12

• 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).
• 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.

Onboarding

• Simplifies and improves the steps necessary to set up the app.
• Adds support for internal/external URLs.
• Adds support for landscape, VoiceOver and Dynamic Type.
• Prompts for missing permissions on app startup in a simpler flow.

---

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

2021.11 (261)

macOS 12

• 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.

(This is what was made available in iOS 15 in the previous release.)

Onboarding Improvements

There's been a lot of changes to initial app setup; it could really use testing if you've got another device to test on, or want to onboard again.

• Supports internal/external URL at setup time.
• Handles device name already existing by prompting for a new choice.
• Adds landscape, VoiceOver and Dynamic Type.
• Many steps which previously could not be cancelled can now be cancelled.
• Improves the time it takes to get through onboarding by consolidating or removing steps.
• Simplifies permission granting after setting up the server to be a page per permission with a lot more details about what it gives you, and a more clear call to action on how to go forward.
• When a permission has never been prompted, the app will now ask on startup to confirm/deny the preference. For example, this should now begin prompting for focus permission if it's never been requested. This should also improve onboarding after clearing privacy settings.

---

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

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.