Home Assistant

Improve websocket connection performance

- Action widgets can now run in the background
- CarPlay Actions now display the same information as Apple Watch
- Fixed install issue on watchOS 8
- The watch app is now compatible with watchOS 8+
- The App loads resources more efficiently, reducing the load on your home assistant server back at home

- Now all Areas are visible in CarPlay;
- Fix the launch screen logo not showing up;
- Fix crash when creating automation for iOS Actions server-sided created;

- Home Assistant arrives at CarPlay;
- Bugfixes and performance improvements;
- Bulgarian Language added;

- Updated logo
- Bug fixes and improvements

- Fixes gesture to reveal sidebar on core-2023.4 or later.
- Fixes the 'speech' button not working in Assist.
- Fixes notifications with attachments being lost in Local Push under iOS 16.4 or later by working around a bug.

- New Shortcut action Assist, see documentation: https://home-assistant.io/docs/assist/apple/
- Allow commissioning Matter devices from the frontend
- Updates the login authentication screen to be a little more reliable
- Adds option to specify zoom level for map dynamic attachments

- Fixes device name resetting issues when Local Push is enabled. This should resolve the last of the issues.
- Fixes deleted servers not staying deleted.
- Fixes some cases where the app would use a lot of on-disk storage unnecessarily.

- Fix device name handling to use the correct one on iOS 16
- Add Firefox Focus/Klar as browsers for opening links
- Add option to open links in Private browser tab

- Adds periodic sensor updating while Local Push is connected
- Adds “Full Screen” setting, to hide the status bar in the frontend
- Improves error messages when secure connections fail when setting up a server
- Allows trusting otherwise-invalid TLS certificates when setting up a server
- Fixes non-frontend-based URLs (e.g. Frigate notifications) by opening them outside the frontend
- Updates Material Design Icons to 7.0.96.

- Fix overlapping zones with zone-only privacy level
- Fix importing audio for notifications failing if format is correct already
- Fix WebView reloading itself when server hostname contains uppercase
- Fix discovery of instances older than 0.110
- Fix many “invalid authentication” errors from happening
- Fix re-adding a just-deleted server saving incorrect information
- Add copy option when tapping version number

PRIVACY
- Control the locations sent to your servers. Choose from sending exact coordinates (the existing behavior), the name of the current zone (e.g. Home or Work), or not sending locations at all. This requires core-2022.2 or later.
- Choose whether sensors are sent to particular servers, either all on or all off.
- Begins removing libraries used by the app which talk to third-party servers.

MISC
- Reduces data use by the app by enabling compression on the app's WebSocket connection.

MULTIPLE SERVERS
- Add and manage additional servers in App Configuration.
- App features are multi-server aware. For example, notifications work on all servers.
- Swipe with three fingers left, right, or up to quickly switch between servers.

MISCELLANEOUS
- Changes how Shortcuts run on iOS 14 or later, hopefully improving reliability.
- Notification categories are now fully deprecated and support for them will be removed in iOS-2022.4. It's time to transition to in-notification actions. See the docs: https://companion.home-assistant.io/docs/notifications/actionable-notifications/
- Swipe left and right with two fingers to navigate forward and back in the frontend.

ONBOARDING IMPROVEMENTS
- Adds button to export logs when showing an onboarding error to aid in bug reporting.
- Fixes error message for the `mobile_app` component not being loaded.
- Fixes error 404 when server URL has a trailing `/`.
- Fixes connecting when the internal URL doesn’t work but the external does. The app will now use the external only for connecting.
- Fixes Cloud not being enabled by default during onboarding.
- Fixes 'timeout' errors during onboarding if only an internal URL is set in the server config.
- Fixes potentially confusing error when "Local Network" privacy permission was not granted.

BUG FIXES
- Improves the reliability of the "Local Push" status, which is now under the server rather than in Notifications.
- Fixes time sensitive notification interruption levels not working.
- Fixes avatar in settings showing a black line on some edges, depending on font sizes.
- Fixes AirPlay showing a different version of the frontend than what's on-screen

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

2021.12.1: Fixes crash on iOS 12.

Small changes this month:

- 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.
- Fixes playback of animated GIF notification attachments.

Adds alerting for security issues that may apply to your Home Assistant. See https://www.home-assistant.io/blog/2021/01/14/security-bulletin/ for more information on the current security advisory.

COMPLICATIONS
- Add a "Placeholder" complication which is just the Home Assistant icon. This requires watchOS 7.
- Add the ability to hide complications' contents when Watch is locked.

MISCELLANEOUS
- Unified Server & Connection settings into 1 row in App Configuration.
- Add 'error' images for attachments that fail to download for some reason.
- Fix hanging occasionally when number of zones when exceeding maximums.
- Fix icons with 'hass:' prefix not working.
- Fix crash when Map notification is provided invalid latitude/longitude.
- Fix crash when signed out and performing some Shortcuts.
- Fix crash when connection URL contains invalid scheme.
- Fix crash when something on the frontend needs microphone permission.
- Minimum iOS version is now iOS 12.

MULTIPLE COMPLICATIONS
- Create multiple Complications per watch face and type. You can now fill up a face with as many Home Assistant Complications as you want!
- Shows previews when choosing Complications on Watch.
- Requires watchOS 7.

COMPLICATION UPDATING
- Improved the reliability of Complications updating.
- Updates now occur around :00, :15, :30, :45 of the hour, within a few minutes.
- Switching between faces now updates complications significantly faster.
- Improves syncing Complication settings from the iOS App to the Watch App.
- Adds basic template validation when tapping the ‘Preview’ button when editing; when a template is invalid, it is now more obvious on the Watch.
- Fixes many Complication types which would not work before, especially containing Rings and Gauges.
- Fixes incorrect icon sizes for many Complications’ images.

SHARE EXTENSION
- Adds a Share Extension which fires `mobile_app.share` when performed.
- Learn more about the contents at https://companion.home-assistant.io/docs/integrations/sharing

UPDATE SENSORS
- Adds an “Update Sensors” shortcut to Shortcuts.app.
- Use this when you’d like to trigger a sensor update, for example a Personal Automation when starting or ending charging, at certain times of day, when changing Wi-Fi, etc.

MISCELLANEOUS
- Adds support for 5G information in the connectivity sensors.
- Adds device info to lifecycle events.
- Adds support for HA 0.117 changes.
- Fixes server-defined Actions failing to execute via Widget.
- Fixes some cases where connection changes would not correctly update the frontend.
- Fixes incorrectly re-registering integration for some HTTP errors, resetting sensor names.
- Fixes handling of connection URLs which contain a trailing slash (/).
- Fixes internal/external not being considered different if only the port number changed.
- Fixes pathless notification attachment URLs causing future attachments to fail.
- Fixes crash when saving server-defined Actions (which are not able to be edited locally).
- Fixes crash when using Camera to upload a profile photo.
- Fixes some CodeMirror (which powers the code editor) issues in the frontend.
- Fixes example for notification category dictionary-based URLs.
- Fixes notification settings showing 'errors' instead of 'attempts' as the first row.
- Fixes 'Choose' and other Widget config text readability when editing them.
- Uses Zone name rather than its ID for enter/exit notifications.
- Reduced app size by about 10%.

iOS 14 & MODERN-NESS

- Support for iOS 14, especially around Local Network permissions.
- Add our first new Widget: Actions. These work similarly to the existing Today widget.
- Add multi-window support on iPadOS 13+.

HA 0.115 STUFF

- Add automatic syncing of Actions, defined in the configuration yaml.
- Add support for Tag configuration.
- Update Material Design Icons to v5.5.55.

ZONES

- Fix a case where entering a zone would inconsistently fail due to accuracy.
- Improve handling of passive zones, especially beacon zones.
- Fire events when entering and existing zones, for some automation cases.

BUG FIXES

- Fix database error for duplicate notification categories.
- Fix crash deleting Actions, deletes Scene Action when Scene is deleted.
- Fix links containing %20 not opening in Chrome & Firefox.
- Fix exporting logs producing extra disk usage.
- Fix device name in events when overridden.
- Fix some cases where connection settings get lost or incorrectly adjusted.
- Fix not automatically enabling Cloud for External Access when setting up.
- Fix some issues with editing settings for Apple Watch Complications.

Want to try out an early release of the HA app for macOS? Keep your eyes peeled on the Home Assistant Blog! https://www.home-assistant.io/blog/

----

2020.6.2:
- Fixes crashing on Apple Watch Series 3.

2020.6.1:
- Fixes Home Assistant Shortcuts not working on iOS 14 when every parameter wasn't defined.

iOS 14 & MODERN-NESS

- Support for iOS 14, especially around Local Network permissions.
- Add our first new Widget: Actions. These work similarly to the existing Today widget.
- Add multi-window support on iPadOS 13+.

HA 0.115 STUFF

- Add automatic syncing of Actions, defined in the configuration yaml.
- Add support for Tag configuration.
- Update Material Design Icons to v5.5.55.

ZONES

- Fix a case where entering a zone would inconsistently fail due to accuracy.
- Improve handling of passive zones, especially beacon zones.
- Fire events when entering and existing zones, for some automation cases.

BUG FIXES

- Fix database error for duplicate notification categories.
- Fix crash deleting Actions, deletes Scene Action when Scene is deleted.
- Fix links containing %20 not opening in Chrome & Firefox.
- Fix exporting logs producing extra disk usage.
- Fix device name in events when overridden.
- Fix some cases where connection settings get lost or incorrectly adjusted.
- Fix not automatically enabling Cloud for External Access when setting up.
- Fix some issues with editing settings for Apple Watch Complications.

Want to try out an early release of the HA app for macOS? Keep your eyes peeled on the Home Assistant Blog! https://www.home-assistant.io/blog/

----

2020.6.1:
- Fixes Home Assistant Shortcuts not working on iOS 14 when every parameter wasn't defined.

NOTE: You will be signed out upon installing this release due to the team transfer. Learn more at https://companion.home-assistant.io/app/ios/about-the-move

ACTIONS
- Actions are now automatically created for Scenes.
- Actions can be added to Siri when editing. They’ll also show up as Siri suggestions.
- “Perform Action” is now a Shortcut in the Shortcuts app.
- Random colors when creating an Action will be more compatible with each other.

NFC TAGS
- You can now read and write NFC tags in the app’s settings.
- Tags written by the app will show a notification when you bring your device near them. Activating the notification will launch the app and fire an event.
- Tags will work on any device with Home Assistant installed which has hardware support to read them.

OTHER THINGS
- Added Dark Mode support for the frontend with HA 0.114+.
- Added automatic syncing of Push Notification Categories.
- Improved saving and editing of Actions, Push Categories, and Connection Settings.
- Reduced the app’s file size by nearly 50% (!) by compressing push sounds. There shouldn’t be any noticeable drop in quality.
- Added Czech, Ukrainian and Vietnamese localizations.
- Removed Robbie’s Patreon. Thanks again to all the backers for a great year!
- Removed Firebase Crashlytics in favor of Sentry.
- Removed Google Analytics
- Minimum versions now iOS 11.0 (down from 11.4) and watchOS 5 (down from 6). Shortcuts requires iOS 13.0 (down from 13.5), Today Widget requires iOS 12.4.

---

2020.5.1 and 2020.5.2 fix a few crashes discovered in 2020.5.

Small fixes in this build as followup from 2020.4:
- Fixes location updates entering/exiting smaller-than-100m zones.
- Fixes duplicate integrations happening when deleting and reinstalling the app.

Highlights

- Location tracking should now be more accurate and reliable.
- Sensor and location updates now retry sending during poor connectivity.
- Minimum iOS version is now 11.4, minimum watchOS version is 6.2

Improvements

- Reduced file size of the app by about 30%.
- “Geocoded Location” sensor can now use Zones as a geocode source.
- Storage Sensor now more accurately reflects the system % available.
- Improvements to how long logs are kept, reducing disk space usage.
- Allows `camera`-category notifications to show thumbnails without attachments.
- Event Log now allows you to search for entries.

Bug Fixes

- Fixes not respecting "Open Links In" setting for notification URLs.
- Fixes a few rough edges when editing actions in the app.
- Fixes a few rough edges when editing Shortcuts in the Shortcuts app.
- Fixes battery icon in a few situations using the wrong icon.
- Fixes dismissing a notification while the app is running causing the notification to fire.

We shipped 2020.3 with a few major issues:

- Critical Alerts entitlement didn't exist, silently disabling Critical Alerts for new and existing users
- Viewing cameras in Notification Previews broke due to an authentication issue
- Onboarding for new users broke for those using older versions of Home Assistant Core

All of these have been fixed in this version.

We apologize for these issues and are working to ensure that they don't happen again. Thanks as always for using Home Assistant!

- Camera Notifications now play HLS videos when supported. Requires HA 0.112+.
- Actionable Notifications can now have per-action URLs to open.
- Relative URLs (like `/lovelace-tacos/0`) now work in Notifications.
- Added Pride-themed alternate App Icons.
- Added "Storage" sensor, showing available disk space.
- Added example Service Calls and Triggers to Notification Categories & Actions.
- Added "Device Name" setting in App Configuration > General.
- Added "Open Links In" setting in App Configuration > General.
- Updated "Last Updated" sensor to have values of "Launch" or "Periodic" instead of "Initial".
- Updated the "In-Development Updating" work to cover all Location management, which may improve accuracy.
- Updated the Sensors list to show the last-sent versions.
- Updated the icons of floors ascended/descended sensors.
- Fixed a hard-to-see input cursor when typing manual server addresses during onboarding.
- Fixed another case where reconnecting was slow or got stuck.
- Fixed importing notification settings causing visual duplicates.
- Fixed some issues with timing out when connecting to older servers.
- Fixed handling non-hex theme colors, now the full gamut of CSS is supported.
- Fixed pull-to-refresh not refreshing the current page but instead loading the main dashboard.
- Fixed the background color when opening Settings.

This build:
- Fix beta/release environment check
- Update strings
- Add space between sensor value and unit (#662)
- Fix Notifications Help Link (#658)
- Sensor Settings: fix icon loading (#657)
- Sensor Settings: Periodic Update (#655)
- Retry "Unable to connect" frontend error automatically (#654)
- Reconnect WebView on a warm start if it failed to load (#653)
- Append User-Agent rather than resetting it (#632)

Last build:
- Handle and persist theme color (#647)
- Notifications: Camera Aspect Ratio (#650)
- Run tests on pull requests (#636)
- Update sensors and other information on warm-launch (#648)
- Settings Permissions: Add Background Refresh (#646)
- Fix another JavaScript alert issue on iPad (#642)
- Don't re-register when update has a network error (#641)
- Sensors in Settings (#640)
- New One Shot Location Logic (#623)
- Today Widget: Empty Handling (#639)
- Version bump to 2020.2 (1)
- State Restoration: Save Last Page (#637)
- Fix SwiftLint errors and a handful of others (#635)
- Today Widget: Dynamic Height (#633)
- Update strings (#634)
- Add SwiftLint Github Action
- Fix JavaScript alerts on iPad (#631)
- Make Reset also trigger onboarding (#630)
- Always register for remote notifications (#629)
- Page Zoom setting (#628)
- Wrap several API operations in background tasks (#627)

- Fix misleading location warning on pull to refresh
- Fix SSID storage
- Fix URLs that end in a slash, causing http://localhost//auth/token
- Fix shortcut action name
- Fix FCM disabling
- Use app-header-background-color
- Add more custom icons
- Updated icons and added new ones
- Update icons to fix chimney
- Fix battery icon logic
- Use app's user agent for web view requests
- Fix webview insets
- Fix links to docs
- Fix minor misspellings
- Fix sensor registration infinite loop
- Fix deleting notification categories when reordering
- Fix editing a just-created notification category or action
- Fix building MDI
- Improve state restoration of location
- Validate manually-entered URL strings
- Fix crash on discovery from 0.110
- Don't send device_id when updating registration
- Handle logouts and invalidated tokens
- Fix opening notification settings deeplink
- Fix more doc URLs
- Add location and notification permission statuses/fallback buttons to settings
- Update localizations

Welcome to Home Assistant Companion version 2019.1, also known as 2.0! It's been a very long time coming but it's finally here. Here's some of the new features in this release:

- Brand new push notification engine, powered by Firebase, for even more complex notifications than ever before, including critical notifications and much much more
- Siri Shortcuts: Now, you can interact with your Home Assistant via Siri and the Shortcuts app
- Apple Watch: Control your home via the Apple Watch app and monitor its status with Complications
- Widget: Quickly trigger actions at home via a widget. Also available via home screen icon
- Nabu Casa Cloud support: Cloudhooks and remote UI are here so you can (optionally) never open a port in your router again
- New connection engine: now you can have internal and external URLs for total customizability

There's plenty more new features and improvements to discover instead. Check the forums and the new documentation for more information.

Thanks for using Home Assistant Companion!

This is a minor bugfix release to 1.5.0.

- Fixes the annoying permissions popup
- Reverts removal of iBeacon exits
- Fixes a problem when calling the URL handler without a action
- Allows saving pictures from the webview to your photo library
- Adds support for confirm/alert/textInput dialogs in the webView. This will unlock the full functionality of the UI, allowing things like deleting tokens and managing configuration.

2.0 is now in beta, check the forums for the invite link!

We're back! With a BIG update which is leading to a even BIGGER update! The major highlights of this update are:

- Drastically improved location accuracy and timeliness
- Support for the new authentication API introduced in 0.69
- Rewrite of internal functions to be less buggy and generally better

See below for the full change log.

To those of you anxiously waiting for it, this is NOT the much vaunted iOS 12 release, that will be arriving in the next few weeks, so keep pulling to refresh that updates screen. So that means you'll just need to wait a little bit longer for Siri Shortcuts, Apple Watch Complications and the Today Widget. It'll be well worth the wait, promise :).

As always, we greatly appreciate a good review, they keep us going!

New Features:
- New Auth API support
- Event logging

Improvements:
- Major internal overhaul of API, classes, division of duties and more
- Refactored Location
- Removed SwiftLocation in favor of a custom implementation
- Now using Core Motion to determine motion type during location updates. This might be removed later
- Store zones in Realm for easier access
- iBeacon support improved

Bug fixes:
- Modified device_tracker.see to be compliant with schema
- Webview fixes
- General UI fixes like making sure buttons at bottom are always there and ordered properly
- Support basic authentication on the UI only
- Catch more errors
- The app should be disconnecting less, if at all

Misc:
- Updated translation strings

Another week, another new Home Assistant for iOS build!

- More localization support! We now support Chinese (Traditional and Simplified), Dutch and Spanish. Minor updates were also made to the existing German translation.
- Add support for granular control of location update triggers (in Settings->Location)
- Support customization of notification display options (see online docs for this, but allows you to specify badge/alert/sound or any combination of the three for each notification)
- Add ability to send URL in push notification which opens upon tap
- Add confirmation dialogs when opening a homeassistant:// URL
- Re-enable Fabric so I can start tracking crashes again
- Improve notification permission check
- Fix text input notifications so they actually work again
- Lots of other localization work
- Bug fixes

Please submit a rating if you haven't already, it's my fuel that keeps me going!

Summer is over, school is back in session, that means it's well past time for a big Home Assistant for iOS update! We are back on track and working on pumping out new features and squashing bugs once more. Apologies for the lull there in the summer.

Here's what's new in this version:

- iPhone X compatibility (IMHO HA looks super slick on it)
- Default camera category attachment content-type to JPEG
- Status bar color changes with frontend theme color
- Support landscape orientation
- Improved permission dialogs
- Improve API communication with Home Assistant
- Change chat support link from Gitter to Discord
- Add the version string to the about page
- Our first translation: German!
- Improve location management
- Swift 4
- Removed a bunch of stale code and dependencies
- Removed native UI. It's web view only from here on out since Home Assistant adds new components/platforms too frequently for native UI to keep up
- Lots of web view improvements around sizing/layout and logic
- Status bar improvements for landscape and sizing issues

Don't forget to leave an updated review as iOS 11 resets reviews with every new version. Thanks!

This change log may be shorter than the last one, but it actually has more overall fixes, I just didn't want to bore you all!
Still loving those reviews, keep them coming!

New Features:
- Add a reset badge to 0 button
- Allow users to specify UUID/Major/Minor, UUID/Major or just UUID for iBeacons

Improvements:
- Set status bar to white on main screen
- Add error message display to camera notification
- Add error message display to map notification
- iBeacons monitoring is correctly resumed after termination
- If a discovered instance is selected and requires a password the password field is required
- If a discovered instance does not require a password the field is hidden at first set up

Bug fixes:
- Fix a ton of crashes and bugs
- Only start monitoring beacons if device has the right hardware
- Refactor the API client to improve layout and more importantly, to remove a lot of crashes/bugs
- Reset the web view when credentials change

New Features:

- Add a reset function to clear out credentials and device ID, resetting the app to its fresh state
- Add background fetch so battery updates even more frequently than before
- Add a new notification for background fetch
- Initial iBeacon support. Requires 0.43.0 or higher to use. Check the Location documentation for details on configuration.
- Add location update via background fetch notification
- Camera notification content extension supports play/pause controls
- Map is no longer a static image which makes it look much better
- Map supports multiple pins. Look for updated docs in the next day or two describing how to do this
- Map supports customization of features via the push payload

Fixes:

- Notification actions didn't work if activationMode was set to background and app had been terminated
- Significant Location Updates correctly send a notification (if you have that enabled)
- Significant Location Updates didn't work after app termination
- Fix weblinks so they open in external browser
- General Settings is now correctly hidden if you don't have Chrome installed and shown if you do
- Open in Chrome preference was continually being overwritten at app launch
- Send location during background fetch only if location is enabled, otherwise just update device state (i.e. battery)
- Web view contents aren't cut off at the bottom anymore

Misc:

- Disable entity picture downloading for now, should speed up startup and most operations
- Continue localization work. German is coming up this week, French shortly thereafter!
- Changed to a new icon
- Add a space to the display name so notifications look better at the expense of a truncated homescreen name
- Status bar is now Home Assistant blue
- Set color of toolbar items to Home Assistant blue
- Remove old dependencies to cut down app size

Thanks for all the great feedback thus far, please keep it coming! Feel free to leave a review with your thoughts about the app so far too :).

New features and improvements:
- Enable zone tracking by default (no more track_ios required!)
- Allow enable/disable of location-related notifications (check the Location Settings screen)
- Rename push token to push ID and remove from identify payload to cut down confusion
- Prepend base URL if attachment URL begins with /api/ (No need to prepend your base URL to notification attachments)
- Whenever we update location let's identify too so battery gets updated (battery stats should update much more frequently)

Bug fixes:
- Remove some force unwraps which may have been causing crashing bugs around notification and location setup
- Don't force unwrap base URL in connect step (was also possibly causing crashes around notification/location)
- Quote the password in the userscript (Should fix auto login problems)
- Make app version number a string instead of an int since semver can't be coerced to an int like 1.0 could (This is the long term version of the fix implemented in 0.42.4)

- Fix a crashing bug when attempting to enable location or notification permissions.
- Move the Device ID into Keychain so it survives across reinstalls/restores
- Make the device identify itself to your Home Assistant instance after every push registration to support server migration
- Hide unnecessary settings and buttons before initial connection
- Fix issues with row visibility on settings
- Auto login to web interface after initial setup
- Other general fixes