-
-
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.
- 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.
- 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.
- 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