Skip to content
BTHome for ESPHome

BTHome Scanner App

The BTHome Scanner is a companion Android app for discovering, monitoring, and debugging BTHome devices in real-time.

Features

Section titled “Features”
  • Device Discovery - Automatically scans for nearby BTHome v2 devices
  • Real-time Updates - See sensor values update as devices broadcast
  • Encryption Support - Decrypt encrypted BTHome devices with your encryption key
  • Signal Strength - Monitor Bluetooth signal quality for each device
  • Debug Info - Copy raw advertisement data for troubleshooting

Download

Section titled “Download”

Download the latest APK from the GitHub Releases page.

Usage

Section titled “Usage”

Scanning for Devices

Section titled “Scanning for Devices”
  1. Open the app and grant Bluetooth permissions when prompted
  2. The app will automatically start scanning for nearby BTHome devices
  3. Devices appear in a list with their name, MAC address, and signal strength

Viewing Sensor Data

Section titled “Viewing Sensor Data”

Tap on any BTHome device to see:

  • All sensor measurements (temperature, humidity, battery, etc.)
  • Signal strength (RSSI)
  • Last advertisement time
  • Encryption status

Adding Encryption Keys

Section titled “Adding Encryption Keys”

For encrypted BTHome devices:

  1. Tap on the encrypted device (shown with a lock icon)
  2. Enter the 32-character hex encryption key
  3. The app will decrypt and display sensor values

The encryption key is stored securely on your device for future use.

Debugging

Section titled “Debugging”

Long-press any device to copy the raw BLE advertisement data to clipboard. This is useful for:

  • Verifying your device is broadcasting correctly
  • Debugging encryption issues
  • Reporting bugs

Requirements

Section titled “Requirements”
  • Android 6.0 (Marshmallow) or higher
  • Bluetooth Low Energy (BLE) support
  • Location permission (required by Android for BLE scanning)

Building from Source

Section titled “Building from Source”

The app source code is in the flutter/ directory. To build:

Terminal window
cd flutter
flutter pub get
flutter build apk --release

The APK will be at build/app/outputs/flutter-apk/app-release.apk.