

The event data consists of a JSON-formatted dictionary of attributes relating to the action. When an action button is pressed a ios.action_fired event is fired on Home Assistant's event bus. When multiple servers are connected to the app there is no need to specify the server value in configuration.yaml, the app will automatically detect the origin of the action when imported. It should sync automatically, but you can also pull-to-refresh to sync. The following is an example entry.Ĭolors should be in hex format and icons should be from the mdi set.Īfter saving these changes you will need to restart Home Assistant and then, in the Companion App, go to the Actions section of the Companion App section of Configuration. This requires at least Home Assistant 0.115 and version 2020.6. You can define actions in your Home Assistant configuration.yaml. Icon Color: the color of the icon on the action's button.įor the three color fields, the color is selected by tapping the color-picker circle in each field.Icon: an icon to display to the left of the text on the action's button.Background Color: the color of the button created for the action.Text Color: the color of the text defined above.It is best to keep this relatively short as there is limited space on each action's button. Text: the descriptive text shown on the phone and watch.Server: if you have multiple Home Assistant servers connected, select the server the action should be sent to.Name: the name of the action, this will be returned in the Home Assistant event fired by the app.

Each action has required fields depending on your device: You can create actions either from within the app itself or in your Home Assistant configuration.yaml Creating Actions in the App Īctions are created from the Actions section of Companion App in Configuration page within the companion App for iOS. Actions is a generic system that allows you to easily integrate the Home Assistant automations system into multiple areas of iOS and Apple Watch.
