Skip to content
KNOOP edited this page Jun 26, 2026 · 14 revisions

Ava Wiki

Welcome to the Ava Pro documentation center.

Ava Pro is an Android voice assistant app based on the ESPHome protocol, turning your Android device into a smart voice satellite for Home Assistant. Compatible with Android 5-16.

Whether setting up a first voice satellite or fine-tuning a multi-device smart home, everything needed is right here.


Core

The foundation. Every Ava install uses these.

  • Quick Start — Install, connect to HA, first voice test
  • System Requirements — Supported devices, Android 5-16, languages
  • Voice Control — Wake word engines (microWakeWord + vsWakeWord), custom wake word import, voiceprint recognition, audio event detection, audio processing, continuous conversation
  • Browser — HA dashboard overlay, WebView / GeckoView, Tampermonkey, sidebar, gestures
  • Screensaver — Xiaomi Wallpaper, web/image screensaver, clock wallpaper, proximity wake
  • Floating Windows — Dream Clock, Vinyl Cover, Floating Subtitle, Weather Overlay, Quick Entity
  • Notification Scenes — 70+ built-in scenes, custom scene JSON, timer/alarm
  • Quick Entity — 6-slot Stream Deck panel, HA real-time slot switching
  • Sensors — Light, magnetic, ambient noise, battery, proximity, diagnostics

Optional Modules

Add these when you want extra capabilities.

  • Sendspin — Music Assistant multi-room sync, Opus/PCM/FLAC
  • Bluetooth — Presence detection, BLE proxy/gateway, Bermuda
  • Voice Messages & Calls — LAN intercom, voice messages, live calls
  • Music Playback — Media player entity, TTS, vinyl cover
  • Camera — Snapshot/video, face detection, gender detection
  • Screen Control — Brightness sync, force orientation, display resolution
  • Intent Launcher — Remote Android intent execution from HA
  • ADB Commands — Broadcast actions, shell commands, provisioning scripts, kiosk setup
  • Mod Store — Extension modules, install/enable/update/uninstall

Advanced

For power users. Tuning, permissions, troubleshooting.

  • Permissions — Shizuku, Root, Device Admin, ADB permission grants
  • Privacy — Telemetry, Android overlay security model, how to opt out
  • FAQ — Troubleshooting: connection, voice, display, brand-specific issues

Links

GitHub | Original Project | Home Assistant | ESPHome | Music Assistant | Shizuku | Ava Mods

Clone this wiki locally