Tater Voice

Pair and organize satellites

Add Satellite creates a short-lived pairing code, then Tater remembers the device and its room.

• Flash a supported Tater Native image, connect to its setup network, and enter the pairing code shown in Settings -> Voice -> Satellites.
• After pairing, give the device a useful name and room. Room assignment becomes part of every trusted voice turn and can select devices or a preferred music player automatically.
• Saved device identity and pairing credentials persist across Tater restarts and Docker image updates when the documented runtime volume is mounted.

Local microWakeWord and trainers

Wake detection stays on the satellite and custom words publish through a scoped trainer link.

• Choose the active wake word from each satellite's settings popup: a built-in profile, a model from Tater-Wake-Words, or a custom trainer/GitHub JSON URL.
• The Apple Silicon and NVIDIA trainers link with a short-lived code from Tater, then publish only their own trained package and active-word selection.
• Sensitivity and room environment controls adjust acceptance around the model's JSON threshold, sliding window, and close-miss tuning.

Wake verification and persistent stats

A fast STT check can observe or reject wake-word mismatches without becoming a new point of failure.

• Observe records the transcript, match score, result, and latency while allowing the turn. Enabled rejects clear mismatches but fails open if verification errors or misses its deadline.
• Per-satellite checks, rejections, fail-opens, latest results, and the broader voice summary are stored in Redis and remain visible while a device is offline.
• Statistics automatically begin a new 30-day collection period and can be reset either for Wake Verification alone or for all voice statistics.

Stereo pairs and multi-room playback

Sendspin keeps native and Echo satellites on one playback timeline across rooms.

• Create a left/right pair under Voice -> Stereo Pairs. Sendspin preserves stereo, left, right, and mono assignments across reconnects and reboots.
• Music Core and AirPlay input use one synchronized timeline for supported native and Echo satellites, including mixed groups with per-satellite output-delay calibration.
• Active music keeps its place while TTS, replies, announcements, wake cues, and timers take local priority; playback resumes cleanly afterward.
• Capable Echo displays and Biscuit LEDs can follow now-playing metadata and live music presentation without adding that overhead to older audio-only devices.

Prebuilt firmware and recovery

Update by OTA or recover over Browser USB without compiling firmware locally.

• Tater matches the selected satellite to the correct firmware family and board revision, then compares its installed version with the signed native release manifest.
• OTA updates run one device at a time with progress and live logs. Browser USB downloads the factory image, optionally erases flash, writes it directly, and follows the device through restart.
• Tater Native Firmware 0.5.0 covers Voice PE, Satellite1, ReSpeaker XVF3800, and S3 Box. Echo Firmware v2.2.0 covers Biscuit, Checkers, and Rook through its target-aware factory and OTA paths.

Identity, rooms, and reply routing

The latest voice event decides who spoke, where they spoke, and what access applies to that turn.

• Speaker ID aliases can link to a master Person alongside that person's WebUI and portal identities; older history cannot replace the current speaker or inherit their admin access.
• Device Control can use the speaking room when a request says only 'turn on the lights,' while an explicitly named room overrides the satellite room.
• Music Core follows the same rule and can honor the room's preferred player, preferring Sonos when several compatible automatic choices are available.
• Replies can play locally, on a preferred external device, or silently on display-only hardware while follow-up listening remains attached to the original satellite.

Intercom, displays, and observability

Tater Voice also carries targeted announcements, visual events, firmware status, and live diagnostics.

• Intercom resolves device and room names before starting a targeted announcement and can preserve the normal follow-up flow afterward.
• Display APIs publish compact environment values and transient camera, doorbell, image, voice, tool-progress, status, or alert cards to selected Tater screens.
• Voice tabs separate Satellites, Firmware, Stereo Pairs, Stats, and Settings, with live logs and direct entity controls where supported.
• Satellite inventory and hardware state refresh through background System Tasks so opening the page does not perform a slow full-device scan.

Load the complete Voice settings workspace.

Returns cached satellite inventory, firmware state, stereo pairs, settings, logs, and persistent voice-stat sections for the local WebUI.

Run a Voice UI action.

Handles pairing, room and device settings, stereo-pair changes, firmware actions, intercom controls, live logs, direct entity actions, and voice-stat resets.

Inspect current voice-pipeline and speech-backend state.

Reports the effective speech backends, local model roots, runtime availability, and current native voice state.

List satellite playback and voice targets.

Returns connected and saved native satellites for room-aware routing and compatible companion clients.

Discover targets and control an intercom session.

Lists available destinations, reports current state, starts a targeted spoken intercom message, or cancels an active session.

Serve compact environment and status data to Tater displays.

Returns display-ready readings, labels, online state, and clock data sourced from Tater and enabled cores.

Poll or publish targeted display cards.

Carries transient text, images, snapshot references, tool progress, voice states, and alert metadata to selected displays.