You can access Home Assistant directly from your Wear OS watch, even when not connected to your phone using a WiFi or cellular connection on the watch or when using an iPhone.
The app does not support all Home Assistant features. Keep an eye out on this page as the app is enhanced with new features! Take a look at the Sensors!
The following list of domains are currently supported to toggle/execute once you log in and select them:
Users can go to Settings in the Wear OS app and set favorite entities which will appear at the top of the list. These entities will be present before the rest of the entities are loaded so that they can be executed immediately upon launching the app. If you delete an entity from your Home Assistant instance there is also a setting option to clear the favorites to remove the stale entity.
The favorites can also be managed from the phone app by going to App Configuration > Wear OS app > Manage Favorites. The phone app also allows you to drag and drop the entities to change the order in which they appear on the home screen.
If you only wish to display the favorite entities and nothing else from the Wear OS app you can do so by opening the app and navigating to Settings then selecting "Only Show Favorites" option. This will hide the areas and domains so you only see the favorites.
If any devices or entities have been added to areas in Home Assistant, these areas will be shown in the Wear OS app below the favorites. Tapping on an area will show all primary entities in that area. Any domains with primary entities not added to an area will be shown near the bottom of the list as 'More entities'. Configuration and diagnostic entities and hidden entities are only shown in 'All entities', at the bottom of the list.
Long pressing any entity opens the more details screen. This screen contains more information on the state and when the entity was last updated. The following options are given on the details screen, depending on what is supported for the entity:
fan: Speed control
light: Brightness control and Color temperature control
The settings screen can be found at the bottom of the home screen. This is where you will be able to add favorites on the watch as well as configuring tiles. You will also find options to enable haptic feedback and/or a toast confirmation to know when you selected an entity. These settings will reflect on the home screen and the shortcuts tile.
- The Shortcuts tile shows up to 7 shortcuts, which can be chosen from the settings section in the Wear OS app. You will be able to select the same set of entities you can access from the home screen.
- The Template tile shows a rendered template. The template can only be set from the android companion app. Note: it is not possible to scroll in a tile, the template should fit on the watch screen.
- The Assist tile allows you to send a voice transcription to the
conversationintegration to process. The results are then shown on the screen. This feature requires Home Assistant Core 2023.1 and also the
Styling the template tile
You may use HTML to format the text displayed. The following tags are currently supported:
- Adding a new line:
- Changing the text style:
- Changing the text size:
- Changing the color:
<font color='#03a9f4'>colored text</font>
- Using headers:
An entity state complication can be displayed on your watchface. The complication will display the current state of the selected entity. Depending on the watchface, the complication may also show the entity name and icon, and supports 'short text' and 'long text' (BETA) complication types.
When you add an entity to a watchface, you can select the entity to display. This only works when editing the watchface on the watch, not in the watch app on the phone. To change the selected entity, just change the complication and select the entity state complication again. The complications are updated automatically whenever the screen is turned on and roughly every 15 minutes. You can force a complication to update by tapping it on the watchface.
Tip: use a template sensor for full flexibility.
An Assist complication can be used to quickly interact with the Assist feature directly from the watchface.
Wear OS devices will relay notifications from any app on the connected device by default, meaning the notification needs to be sent to the connected device first before it reaches the wearable. The Wear OS app allows for notifications to be sent directly to the watch itself, skipping the connected device. Not all notification features supported by the connected device will be supported by the Wear OS app due to platform limitations.
Currently only the following parameters are supported.
notification_icon(Not all devices will show the icon)
tag(Support limited to replacing a notification only)
vibrationPattern(May need to set the vibration if your device does not vibrate by default, the pattern may not be respected based on the device)
- alias: 'Send Wearable Notification'
- service: notify.mobile_app_<your_device_id_here>
message: "Notification message"
title: "Notification title"
To speed up delivery of notifications you may need to use the first critical notification format listed in the docs. Alarm stream and TTS notifications are currently not supported in Wear OS.
The Wear OS app has basic support for notification commands. Unfortunately not all commands will be able to be supported in the app. The below list of commands are currently supported:
Text To Speech Notifications
The Wear OS app also has support for Text To Speech notifications. Please refer to the link above for the format to use as well as considerations on its usage.