EchoLocal
An open-source replacement for Alexa on supported Echo Dots and Echo Shows, with Home Assistant
Assist, music, intercom and Bluetooth proxying.
Uses the Echo's existing microphones, speaker and buttons. Shows also have dashboards, touchscreen
apps, cameras and video calls. Home Assistant discovers it through the ESPHome native API.
The screen examples below are Echo Show features; Echo Dot controls use its light ring, buttons,
Home Assistant and browser interface.
| Math clock | Matrix alarm panel |
|---|
| |
| Tessera in Material You | Photo wallpaper and clock placement |
|---|
| |
Interface gallery · Setup guide · Releases
Devices
| Device | Codename | OS | Status |
|---|
| Echo Dot (2nd gen) | biscuit | Fire OS 6.x | Supported |
| Echo (2nd gen) | radar | Fire OS 6.x | Experimental |
| Echo Show 5 (1st gen) | checkers | Fire OS 6.x | Supported |
| Echo Show 5 (2nd gen) | cronos | Fire OS 6.x | Supported |
| Echo Show 8 (1st gen) | crown | Fire OS 6.x | Supported |
| Echo Show 8 (2nd gen) | athena | Fire OS 7.x | Supported |
Additional devices supported by our sister project LANovo
| Device | Codename | OS | Status |
|---|
| Lenovo Smart Display 10 | blueberry | Android Things 8.x | Supported |
| Lenovo Smart Display 8 | amber | Android Things 8.x | Supported |
| Lenovo Smart Display 7 | ivy | Android Things 8.x | Supported |
| JBL Link View | opal | Android Things 8.x | Supported |
| Lenovo ThinkSmart View | penghu | Android 8.x | Supported |
Features
Every device
- Wake words on the device with microWakeWord and
openWakeWord. Two assistants, each with its own wake
word and Assist pipeline. "Stop" works without a wake word.
- Speaker: a Home Assistant
media_player for announcements, TTS and music, ducking under the
wake word. A Sendspin player for Music Assistant. Chromecast receiver (audio only on the Dot).
- White noise: two layers from white, pink, brown, rain, ocean, fan, fire, brook, cabin,
crickets and wind.
- Intercom: calls between devices on your network. Audio on the Dot, audio and video on the Shows.
Broadcasts to every device at once, and "call the kitchen" or "broadcast dinner is ready" by
voice with the EchoLocal integration, which also calls an Echo Show from a Home Assistant
dashboard. A home key keeps calls and broadcasts to your own devices.
- Timers and alerts, with custom tones for chimes, timers and wake sounds.
- Bluetooth proxy for Home Assistant, so the device extends your Bluetooth for integrations
like Bermuda. While the proxy is on, the device also
advertises an iBeacon with UUID
9c5fa6f1-91c4-4f56-bb9f-d92acfd9d40b, major 1, and a minor
from the last two bytes of its factory MAC, for tools like
BLE Positioning System.
- Light sensor, reported to Home Assistant.
- Updates from Home Assistant, stable or development channel, or any recent version by name to
roll back.
- A web page on every device over HTTPS: every setting with search, alarms, calls and
broadcasts, logs, and on an Echo Show live screen control with QR pairing and remote keyboard
input. Portable settings can be exported and imported. Behind it is an HTTP API for
scripts. The certificate is self-signed, or comes from Cert Warden
if you run one. See In a browser.
Echo Dot
LED ring. Twelve individually addressable segments, effects for ambient, motion, alerts and
room-reactive behavior, and a color per segment. The ring can follow the room's volume.
Buttons as Home Assistant events: press and hold on every button, and double and triple taps
on the action button.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
