-
-
Notifications
You must be signed in to change notification settings - Fork 13
Home
knoop7 edited this page Jun 22, 2026
·
14 revisions
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 the full range of Android 5-16 ecosystems.
This wiki is organized into three layers: Core, Optional Modules, and Advanced/Experimental. Start with Core, add Optional Modules as needed, dive into Advanced only when you want to tune or troubleshoot.
The foundation. Every Ava install uses these. Get these working first.
| Page | What it covers |
|---|---|
| Quick Start | Install, connect to HA, first voice test |
| System Requirements | Supported devices, Android 5-16, languages |
| Voice Control | Wake words (microWakeWord / vsWakeWord), dual wake, voiceprint, AEC/AGC/NS, audio profiles, mic gain, mute, continuous conversation, stop words, wake visual feedback |
| Browser | HA dashboard overlay, System WebView / GeckoView engine pack, dark mode sync, Tampermonkey, sidebar, gestures, sync URL, clear cache, browser commands |
| Screensaver | Xiaomi Wallpaper, web/image screensaver, clock wallpaper, dual pane, dark overlay, background pause, proximity wake, turn off in dark |
| Floating Windows | Dream Clock, Simple Clock, Vinyl Cover, Floating Subtitle, Weather Overlay, Light Switch Overlay, Quick Entity Panel, Global Overlay Back Control |
| Notification Scenes | 70+ built-in scenes, custom scene JSON, sensor placeholders, timer/alarm, stop alarm button |
| Quick Entity | 6-slot Stream Deck panel, HA real-time slot switching, tap behavior, doorbell/room-aware/security automations |
| Sensors | Light, magnetic, ambient noise, battery, proximity, diagnostic (WiFi/IP/storage/memory/uptime), kill app, reboot |
Add these when you want extra capabilities. Not required for core voice satellite use.
| Page | What it covers |
|---|---|
| Sendspin | Music Assistant multi-room sync, Opus/PCM/FLAC, sync offset, low memory mode, device volume sync |
| Bluetooth | Presence detection, BLE proxy/gateway, scan mode/power, capability tier (Full/Balanced/Compatibility), Bermuda, low-end BLE notes |
| Voice Messages & Calls | LAN intercom, voice messages, message board, live calls, delivery delay, NSD discovery |
| Music Playback | Media player entity, TTS, vinyl cover, HA media player binding |
| Camera | Snapshot/video, face detection, gender detection, camera selection, orientation, image size |
| Screen Control | Brightness sync, keep screen on, force orientation, display resolution/scale, auto unlock, screen power controls |
| Intent Launcher | Remote Android intent execution from HA, open apps / system settings |
| Mod Store | Extension modules, Meta Portal Support mod, provision.sh, install/enable/update/uninstall |
For power users. Tuning, elevated permissions, diagnostics. Skip unless you need them.
| Page | What it covers |
|---|---|
| Permissions | Shizuku, Root, Device Admin, ADB permission grants, GeckoView engine ADB, Meta Portal provision.sh |
| FAQ | Connection, voice, display, permission, performance, brand-specific (MIUI/EMUI/ColorOS/OriginOS/One UI), GeckoView, Sendspin, Quick Entity, Mod Store troubleshooting |
- GitHub: https://github.com/knoop7/Ava
- Original Project: https://github.com/brownard/Ava
- Home Assistant: https://www.home-assistant.io/
- ESPHome: https://esphome.io/
- Music Assistant: https://music-assistant.io/
- Shizuku: https://github.com/RikkaApps/Shizuku
- Ava Mods: https://github.com/knoop7/ava-mods
Last Updated: 2026-06-22