companion.home-assistant/docs/integrations/android-device-controls.md

title	id
Android Device Controls	android-device-controls

The Android app will automatically integrate with the smart home device controls feature on devices running Android 11 or newer that support it. All that is required is that you are able to login to the app and use it remotely.

To get started, open the device controls on your device. It will depend on the device manufacturer and Android version where you'll find them, some common places are: in the quick settings panel, in the notification drawer, or in the power menu. Tap on "Add Controls" and choose the Home Assistant app. All domains listed below will be available to get added to the device controls panel.

Tapping on a tile will either turn it on or off. Certain domains will also allow you to increase or decrease the range by sliding your finger back and forth on the tile.

The following domains are supported:

• automation On/Off
• button Press
• camera Snapshot image (only supported on Android 12 or newer)
• climate Temperature slider, cycle through modes
• cover Open/Close
• fan On/Off, speed slider
• input_boolean On/Off
• input_button Press
• input_number Number control slider
• light On/Off, Brightness control slider
• lock Lock/Unlock
• scene Turn on scene
• script Turn on script
• switch On/Off
• vacuum Start/Dock or On/Off depending on vacuum type

Use when locked

On Android 11, you can use added controls when your device is locked.

On Android 12, you cannot use added controls when your device is locked.

On Android 13 and later, you can control the use of added controls when your device is locked. First, make sure you've enabled the option to use device controls when locked in the system settings (Settings app > Display > Lock screen). Now you can use added controls when your device is locked! If you want to change the setting for specific controls or entities, open Home Assistant and go to Settings > Companion app > Manage device controls.

Use a dashboard instead of built-in controls

Starting with Android 14, on supported devices you can also show a Home Assistant dashboard instead of the built-in controls when using the device controls feature. Both modes have their own advantages: the built-in controls are easy to use, allow you to manage locked settings for each entity and control multiple servers side by side, while a dashboard supports all Home Assistant features and allows fully customizing the controls to suit your needs. The documentation above describes built-in controls.

To switch between modes, open the app and go to Settings > Companion app > Manage device controls and choose either 'Built-in' or 'Dashboard'. After selecting Dashboard, you can also enter the dashboard path to use (ex: /lovelace/default_view or /lovelace-dashboardname/viewname) to use a different dashboard than the default.

:::info When switching from built-in device controls to a dashboard: if you previously used built-in device controls, you may need to remove all controls before the dashboard will be shown. :::