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.

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 words, voiceprint, audio events, configuration
• Home Launcher — Optional Android desktop: multi-page workspace, widgets, icon packs, wallpaper, kiosk app filter (0.6.0+)
• Home Screen Widgets — 8 Android home screen widgets: Sensor, Music, Dark Mode, Restart, Service, Network, Title & Description
• Browser — HA dashboard overlay, WebView / GeckoView, Tampermonkey, sidebar, gestures, Dual Pages (0.6.4), WebView Health Steward (0.6.5-0.6.8)
• Screensaver — Dawn magazine screensaver, web/image screensaver, clock wallpaper, Smart AOD (0.6.3), timeout=0 and camera view (0.6.9)
• Floating Windows — Dream Clock, Vinyl Cover, Floating Subtitle, Weather Overlay, Quick Entity
• Notification Scenes — 90+ built-in scenes, scene library with banner styles and icon picker (0.6.9), 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
• Backup — Export/import settings and mods for device migration

Add these when you want extra capabilities.

• Sendspin — Music Assistant multi-room sync, Opus/PCM/FLAC, MA WebSocket console (0.6.8), sync delay calibration (0.6.9)
• Bluetooth — Presence detection, BLE proxy/gateway, Bermuda
• Voice Messages & Calls — LAN intercom, voice messages, live calls
• Music Playback — Media player entity, TTS, vinyl cover, synced lyrics, five-band EQ (0.6.5), karaoke lyrics (0.6.6)
• Camera — Snapshot/video, face detection, gender detection, screensaver layer camera view (0.6.9)
• Screen Control — Brightness sync, force orientation, display resolution
• Home Passcode — 4/6-digit passcode for Home or Settings, brute-force lockout, shuffled keypad (0.6.0+)
• Intent Launcher — Remote Android intent execution from HA
• ADB Commands — Broadcast actions, shell commands, provisioning scripts, kiosk setup, ADB Control Gate (0.7.3)
• Mod Store — Extension modules, install/enable/update/uninstall
• Ava Fleet — Multi-device management console: device wall, ADB host, scrcpy, settings editor, file/app management (0.6.1+)

New capabilities introduced in 0.7.3.

• Chorus Wake — Multi-device wake arbitration: one phrase, one best answer
• ESPHome Encryption — Noise NNpsk0 encrypted voice-satellite connections
• HA Direct Connection — Live entity-state streaming over WebSocket with ESPHome fallback
• Floating App Window — Apps open in a draggable, resizable window over the dashboard
• Camera Vision — Face/gesture/QR sensing hub mod with screensaver person wake

For power users. Tuning, permissions, troubleshooting.

• Permissions — Shizuku, Root, Device Admin, ADB permission grants
• Updates — In-app stable updater, HA Update entity, SHA-256 verification, Software Update Center with cover art (0.6.4-0.6.9)
• Privacy — Telemetry, Android overlay security model, how to opt out
• FAQ — Troubleshooting: connection, voice, display, brand-specific issues

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