Bluetooth for Home Assistant (built-in integration)

About

Bluetooth is a built-in Home Assistant integration that works locally with Bluetooth adapters and nearby devices. It is set up in the UI, with steps for choosing an adapter and a device. An options step offers a scanning mode, and the automatic setting is described as suited to most setups because it saves battery on Bluetooth devices while still picking up new devices and updates quickly. When an adapter has a problem, notices can appear in the Repairs section of Settings, covering cases such as missing permissions, a needed system power cycle, or a USB adapter that needs a manual power cycle. A diagnostics file can also be downloaded to attach to a bug report.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect

Device

Multiple adapters

Adapter

After setup

Scanning modeAuto is recommended for most setups. It saves battery on your Bluetooth devices while still catching new devices and updates quickly.

Texts from Home Assistant's source code, Apache License 2.0.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Bluetooth adapter requires additional permissions, Bluetooth adapter requires system power cycle, Bluetooth USB adapter requires manual power cycle