Repository navigation
Pinna 0.3.0
The first release of Pinna for the Echo Dot (2nd gen) and the Echo (2nd gen). It is a voice satellite for Home Assistant or on its own, set up from a dashboard in your browser, with signed updates that go back when they fail.
Install
Pinna needs an Echo Dot (2nd gen) or an Echo (2nd gen) that is unlocked with
Kaeru/amonet. Download all files of this release into one folder and follow
Install Pinna. Back up the
device first, as described in
What you need:
installing Pinna erases the data partition.
Recover a device explains
how to undo each step.
Highlights
A voice satellite for Home Assistant
Home Assistant adds the satellite over the ESPHome API, with its key for an
encrypted connection. The wake word runs on the satellite: up to two at a
time, chosen in Home Assistant or on the dashboard's Voice & sound page.
The ring shows Listening, Thinking and Speaking and points at the person
talking. The buttons, timers and a notification light are entities in Home
Assistant.
Standalone mode
Without Home Assistant, the satellite answers requests itself, with the speech
services and the language model or AI agent you choose: OpenAI-compatible
servers, Anthropic, Gemini and ElevenLabs. The satellite has timers, the
weather and internet radio of its own, and the language model can use your MCP
servers.
Set it up on the dashboard's Assistant page. Home Assistant switches modes
with the Voice mode select.
Set up and manage it from the dashboard
The satellite serves a dashboard on your network. You need no app, no account
and no Home Assistant. It sets the Wi-Fi, the name, the time zone, the volume
and the wake words, turns AirPlay and Bluetooth on or off, shows the logs,
restarts and resets the satellite, and switches to other satellites it finds
on your network.
Updates that go back when they fail
The satellite looks for releases on its channel: Updates is stable,
beta or off. A new release shows on the dashboard's System page and as
the Firmware update in Home Assistant, and installs when you select
Install. It goes into the second slot, and if it doesn't start, the satellite
goes back to the version before. When a start fails, the ring shows how far it
got, and rescue mode lets you recover the satellite.
In Home Assistant
- LED ring (light)
- Volume, Reply volume, Wake word sensitivity and
LED brightness (number) - Wake word, Listening direction, AirPlay, Bluetooth audio,
Bluetooth pairing, Wake word calibration, Wake sound and
Notification (switch) - Cancel request (button)
- Volume up button, Volume down button, Microphone mute button and
Action button (event): press, long press and double press - Voice assistant, Playback, Timer and Notification (event)
- Last wake word (sensor)
- Media player (media player): URLs and announcements
- Updates and Voice mode (select)
- Firmware (update)
Also in this release
- AirPlay and Bluetooth play music from phones and computers. The dashboard
shows what plays and where it comes from. - On the Echo Dot (2nd gen), echo cancellation lowers the satellite's own music
by 23 to 31 dB in what the microphones hear. - Quiet speech from across a room wakes the satellite.
- The wake word interrupts any request and stops a ringing timer alarm.
- Wake word calibration tunes the sensitivity with the volume buttons.
- The satellite serves metrics for Prometheus on
/metrics.
Files
Install: https://elsbrock.github.io/pinna/docs/flash/
Signed with keys/release.pub: 1170dfc308acae842fd81cbff011ecf33f2c0feb056fa2ec9998bc012fc9f706
5d3c142d1592c5b06c99b6efdcc4d1ff1535060af42fc88239aeca5d2faa5f8f pinna-0.3.0.root.img
3247ee2c51dac5be7c5cbbdad1a48c484f31739c20a48f9d122a28a83e074c0a pinna-boot.img
684cd59d03e732cf829060243eda8df426097ea8c599df7067888076d21c746b manifest.json
09b6cc579cf78e0e2a467e4abb298e496582a37a988d04af3c26629831f2fe17 manifest.json.sig
b918dff44fac83241901b4a3f5afeed81e142e45d0080c80f70cce62eb2b63a3 flash-gen2.sh