techo5 README

The project's README from github.com/HuskerMinion/techo5. As one markdown file: README.md.

TECHO5

Your Echo Show 5, rebuilt. Linux inside, Home Assistant in charge, no Amazon cloud.

Latest release Alpine Linux No Android No Alexa Home Assistant MIT license Buy Me a Coffee

What's new · Built on EchoLocal · Why · Screenshots · Stock vs TECHO5 · Install · Under the hood · Credits · TECHO5 Dot · TECHO5 Spot


TECHO5 (Tech Echo 5) is open firmware for the Amazon Echo Show 5. It replaces Android and Alexa with a small Alpine Linux image and one Go daemon, turning the Show into a fast, private Home Assistant voice satellite with a touch screen of its own.

Every Echo that can be unlocked now runs it. The bootloader exploit these devices are opened with, amonet, reaches five Amazon Echos. All five run the same daemon:

Device Model Repository Status
Echo Show 5, 2nd gen (2021, cronos) C76N82 this one In daily use
Echo Show 5, 1st gen (2019, checkers) H23K37 this one, same binary; hardware notes in techo5-checkers Working, tested end to end on one unit
Echo Show 8, 1st gen (2019, crown) C7H6N3 this one, same binary Working on one unit, the newest port
Echo Spot, 1st gen (2017, rook) VN94DQ TECHO5 Spot In daily use
Echo Dot, 2nd gen (2016, biscuit) RS03QR TECHO5 Dot In daily use

Every other device amonet opens is a Fire tablet. No Echo made after 2021 has a public unlock, so this is the whole family as it stands, not a roadmap.

The screen turning into a sunrise over the twenty minutes before an alarm: a dark red sky warming through orange to a pale gold, a sun climbing into it, the time readable throughout

Waking to light. For up to half an hour before an alarm the screen becomes a dawn, on a curve that does most of its work near the end. Every frame here is drawn by the code the device draws with.

What's new

The bigger changes of late September 2026. Every release lists the rest.

A dashboard drawn by the Echo Show 8 itself: tiles for a lamp, a fan, a scene, a porch light, a lock, the heat and the weather The same dashboard streamed to the Echo Show 8 exactly as Home Assistant draws it, with a five-day forecast
Drawn on the device: instant, no server Streamed: exactly as Home Assistant draws it

Home Assistant dashboards on the screen (v0.9.0). The Echo Show and the Echo Spot can show a dashboard as a page you swipe in from the left edge of the clock (on the Spot, from the ring menu), or in place of the clock when nothing else is on the screen. There are two ways, picked per device in Home Assistant:

Which to use, how to set it up and what each can do: docs/dashboards.md.

Now playing from Music Assistant, with the album's cover behind the song Now playing on the Echo Spot, with the album cover in a circle
Cover art for Music Assistant (v0.8.13). Music from Music Assistant, your own library included, now shows its album cover on the now-playing screen, the way radio stations already did. Music Assistant sends the picture itself, so there's nothing to set up. On the Spot it sits in a circle over the song.

Built on EchoLocal

TECHO5 started from EchoLocal by Yuri Gelfand (MIT), which already turns the Echo Dot 2 (biscuit, the same MT8163 family) into an ESPHome-native Home Assistant satellite, with a single static Go daemon that drives the hardware directly. TECHO5's echod is that daemon, vendored and ported to the Show 5's cronos, and much of it is still EchoLocal's code: the wake word engine, the ALSA client and the service framework almost unchanged, and the voice satellite, media player and component registry grown from EchoLocal's own. What TECHO5 added is the Show's hardware, the screen, the camera, Bluetooth, the update and slot system, phone calls, and a minimal Alpine root filesystem in place of Android. See NOTICE for the full attribution and EchoLocal's license.

Why TECHO5

🐧 Real Linux, no Android The Show boots straight into a minimal Alpine Linux root filesystem. No Android framework, no Google services, no app store: one daemon drives the microphones, speaker, screen, camera and radios directly.
🚫 No Alexa, no Amazon account, no Amazon cloud Your voice goes only to your Home Assistant, over its encrypted ESPHome API. The Show reaches the internet just for what you use: update checks against this repo, network time, radio streams with their song and cover lookups, the rain radar map, and in the U.S. the National Weather Service's weather alerts. Voice and control keep working with the internet down, as long as your Home Assistant pipeline is local.
🎙️ Wake word on the device microWakeWord runs locally: twelve wake words, "Alexa", "Okay Nabu", "Hey Jarvis", "Hey Mycroft", "Computer" and more, chosen on the screen or in Home Assistant. Echo cancellation keeps it listening over music.
🔐 Secure by default SSH is keys-only and off until you turn it on; keys arrive only through Home Assistant. The camera and screen web pages start closed. No password logins, not even in rescue.
🔄 Updates that can't brick it Releases install over the air from Home Assistant's update card into the spare of two root filesystem slots, boot on trial, and fall back on their own if the new one doesn't settle.
📺 A screen that's actually useful Clock and weather, the conversation as it happens, now playing with song and cover art, your Home Assistant dashboards, forecasts, a live rain radar, the National Weather Service's alerts (in the U.S.), live Home Assistant cameras, timers and alarms, Wi-Fi setup, 13 themes.
📻 Weather and radio with no setup A new Show uses the forecast every Home Assistant has, and lists the radio stations near home from Home Assistant's Radio Browser. Pick another weather entity (your own station, say) on the screen, and keep your own favorite stations too.
⏰ Alarms that ring on their own Set on the screen, by Home Assistant, or followed from its helpers; they ring from the Show's own clock even when Home Assistant is down. Snooze included, and the screen can wake you with a sunrise before the sound.
🎧 Bluetooth, rebuilt Earbuds and speakers over A2DP, plus a Home Assistant Bluetooth proxy, on a kernel rebuilt with Bluetooth from the LineageOS source.
📞 A speakerphone again Calls through your own SIP provider: "call Alex" by voice, calls that ring on the screen, calls between your own devices, and a help call that alerts your phones and dials people in turn. Encrypted end to end to the provider, and off until you sign it in. docs/phone.md
📷 A camera you control The front camera becomes a Home Assistant camera entity, off unless something is watching, and physically off while the mute button is engaged.
🛟 Always recoverable A rescue environment with a USB serial console, and TWRP left in place: LineageOS is one flash away.

Screenshots

Straight from the device's own screen. All of them, including the Echo Show 8 and the Echo Spot, are in docs/screenshots.

Clock with weather over a photo An alarm ringing, with Stop and Snooze
Clock, weather and your own photos behind it Alarm ringing, big enough to hit half awake
Now playing from Music Assistant, with the album's cover The mini player strip over the clock
Now playing, with the album's cover The mini player, over the clock
Settings: Display Settings: Sound & Voice
Settings by category: brightness, night hours, theme, clock Sound & Voice: volume, microphone, wake word and its sound
Alarm editor Settings: Privacy & Security
Alarms set on the device, no app needed Privacy: every open door has a switch
Theme list Settings: Connections
Themes: presets or your own colors Connections: Wi-Fi, Bluetooth and the Home Assistant proxy
Weather with a five day forecast The cameras drawer
Weather now and for the week, with the rain radar a tap away Cameras and Radio, a swipe in from the right

The sunrise before an alarm on the Echo Spot's round face: the circle warming from dark red through orange to gold, a sun climbing from the bottom

The Echo Spot takes the same twenty minutes across its round face.

Stock vs TECHO5

Stock Echo Show 5 (Alexa) TECHO5
Operating system Fire OS (Android) Alpine Linux, one daemon
Voice assistant Alexa, in Amazon's cloud Home Assistant Assist, with any pipeline you run
Where your voice goes Amazon Your Home Assistant, encrypted
Wake word "Alexa", processed for Amazon On the device: Alexa, Okay Nabu, Hey Jarvis, Hey Mycroft and eight more
Screen Alexa cards and ads Clock, weather, now playing, Home Assistant dashboards, cameras, timers, alarms, settings
Music Amazon Music and skills Home Assistant radio lists with cover art, Music Assistant (Sendspin), Home Assistant media
Timers and alarms Alexa Home Assistant timers on screen; alarms that ring without Home Assistant
Camera Video calls, Drop In A Home Assistant camera entity, off unless watched
Bluetooth Speaker and phone audio Audio to earbuds and speakers; Home Assistant Bluetooth proxy
Smart home Alexa routines Everything Home Assistant does
Updates Amazon, automatic, whenever From this repo's releases, when you press Install; A/B slots with automatic fallback
Remote access None SSH with keys, off by default
Listening on your network Amazon's services Home Assistant's encrypted API and the Sendspin player; SSH and web pages only when switched on. A signed-in phone keeps its own connection out to the provider
Calling Alexa calling and Drop In Phone calls through your own SIP provider (TLS and SRTP), placed from Home Assistant or by voice, answered on the screen; device to device calls in the house
Shopping, skills Yes No. Those are Alexa cloud services

Install

New to this? Start with Getting started: every step from a stock Echo Show 5, Dot or Spot, with the unlock guides linked, what to check after each step, and notes for Windows, Linux and macOS.

You need a Show 5 unlocked and running LineageOS 18.1 — 2nd gen with amonet-cronos and this ROM, 1st gen with amonet-checkers and R0rt1z2's checkers build of the same LineageOS — a USB cable, a computer (Windows, Linux or macOS) with Python 3, adb and fastboot, and Home Assistant. Each release carries everything else: the boot image (with Bluetooth) and the root filesystem. Nothing is built.

git clone https://github.com/HuskerMinion/techo5
cd techo5
python3 tools/install-show.py

It finds the Show, asks what to call it and asks once before erasing anything (or takes --serial, --name and --force from a script), downloads and checks the release, flashes the boot image, creates the slot store and installs over the USB serial console, and prints where the Home Assistant key is kept. Later updates come from Home Assistant. Every step by hand, and the fixes for what can go wrong: docs/install.md.

Status: in daily use on two Echo Show 5 units. It's a hobby project, not a product: keep your backups, and expect rough edges.

Echo Show 5 1st gen (2019, checkers) installs with the same command: the installer sees which generation it is talking to and takes that unit's boot image from the release. Everything works on it — screen, touch, speaker, microphones, wake word, camera, the mute button and voice — tested end to end, though so far on one unit rather than the two years of daily use behind the 2nd gen. The hardware notes are in techo5-checkers.

Echo Show 8 1st gen (2019, crown) installs with the same command as well. Its screen, touch, speaker, four microphones, wake word, camera, lens cover and mute latch all work, and it takes slot updates like the others. It is the newest of the three and has been through far less use than either Show 5, so treat it as such. Two things worth knowing first: a seller's model number does not tell the two Show 8 generations apart, so go by the year when buying second-hand, and cycling the mute latch stops the camera until the unit is rebooted.

Under the hood

Layer What
Boot Amazon's LK, unlocked with amonet; the LineageOS 4.9 kernel rebuilt with Bluetooth; a rescue initramfs that picks a slot
System Alpine Linux armv7 in two root filesystem slots, read-only, with a trial-and-commit boot counter
Daemon echod, one Go binary: audio, wake word, echo cancellation, screen renderer, touch, camera ISP, Bluetooth, updates
Home Assistant The native ESPHome API: voice satellite, media player, camera, update entity, dozens of settings

Sister projects

TECHO5 Dot does the same for the Echo Dot 2nd generation: Linux in place of Fire OS, all seven microphones, Bluetooth speaker mode, signed updates. TECHO5 Spot does it for the Echo Spot (1st gen), on its round screen. All three run the same daemon source, built per device.

Made possible by

TECHO5 exists because of these projects and the people behind them.

The path here

What runs on the device

See NOTICE for licenses of code carried in this repository.

The older route: the daemon beside LineageOS (Windows, PowerShell)

Before the Linux image, the daemon ran as an init service on LineageOS 18.1. That still works, on a unit with USB debugging and rooted debugging enabled:

cd echod
$env:GOOS='linux'; $env:GOARCH='arm'; $env:GOARM='7'; $env:CGO_ENABLED='0'
go build -trimpath -ldflags '-s -w' -o ../bin/echod-arm ./cmd/echod
cd ..
.\tools\install-cronos.ps1 -Serial <adb serial> -Name "Kitchen" -KeyFile .\kitchen.psk

The installer puts the daemon in place as an init service, switches Android to its null audio HAL (the daemon owns the microphone and speaker), provisions the name, API key and wake word models, and reboots. Home Assistant then discovers the device as an ESPHome node; paste the key when asked. Android and any app on the screen keep running, silently.

License

MIT. See LICENSE and NOTICE.

TECHO5 isn't affiliated with Amazon. Echo and Alexa are trademarks of Amazon.com, Inc.

techo5 (HuskerMinion/techo5)

home-assistant
Searching Database…

338 ·GitHub
What is this?TECHO5 is open-source firmware that replaces Android and Alexa on the Amazon Echo Show 5 (also ported to the Show 8, Spot and Dot 2) with a minimal Alpine Linux image and a single Go daemon, turning the device into a local Home Assistant voice satellite with its own touchscreen and no Amazon cloud involved.
Is this an app I install, or firmware that replaces the device's OS?It is firmware, not an app: a minimal Alpine Linux root filesystem plus one Go daemon (echod) that drives the microphones, speaker, screen and radios directly, flashed in place of Fire OS/Android.
How do I get it running on my Echo?You first unlock the device with the amonet bootloader exploit and install LineageOS 18.1, then flash a TECHO5 release following the Getting Started guide; later updates install over the air from Home Assistant's update card.
What do I need on my computer to flash it?A USB cable, a Windows, Linux or macOS computer with Python 3, adb and fastboot, and a running Home Assistant instance for the voice pipeline.
Which Echo devices actually support this?Only devices the amonet bootloader exploit can unlock: Echo Show 5 (1st and 2nd gen), Echo Show 8 1st gen, Echo Spot 1st gen and Echo Dot 2nd gen. No Echo released after 2021 has a public unlock, so this is the whole supported family, not a growing roadmap.
Does it keep working if my internet goes down?Yes, voice and control keep working with the internet down as long as your Home Assistant pipeline runs locally.
Where does my voice data go?Your voice goes only to your own Home Assistant over its encrypted ESPHome API; the device reaches the internet only for update checks, time sync, radio metadata, weather radar and US weather alerts.
Is this free to use, and whose code is it built on?TECHO5 is MIT licensed and builds on Yuri Gelfand's EchoLocal project, which already turned the Echo Dot 2 into a Home Assistant satellite; full attribution is kept in NOTICE.
Can a bad update brick my device?No, updates install into a spare A/B root filesystem slot, boot on trial, and the device falls back on its own if the new slot does not settle.
Can I go back to stock Alexa firmware later?Yes, a rescue environment with a USB serial console is always available and TWRP is left in place, so flashing LineageOS back is one step away.
Can I see my Home Assistant dashboards on the screen?Yes, dashboards can be drawn natively on the device for instant touch response, or streamed pixel-perfect from a small Docker server called dashcast that mirrors exactly what Home Assistant renders, custom cards included.
Does it support phone calls?Yes, through your own SIP provider: you can say 'call Alex', calls ring on screen, and TECHO5 devices in the house can call each other directly, encrypted end to end to the provider.
Size
19.4 MB
Stars
338
Age
1mo
Commits · 90 Days