feat(live-captions): add ESP32 streaming captions app

This commit is contained in:
Adolfo Reyna
2026-08-21 22:41:01 -04:00
parent 03e65fb7f7
commit 52bf3e1870
8 changed files with 648 additions and 0 deletions
+17
View File
@@ -0,0 +1,17 @@
# Live Captions
ESP32-S3 external app that streams 16 kHz signed-16-bit mono microphone PCM to the Mac mini Hermes voice gateway and renders its live draft/final captions. It stores **only final captions** on the device SD card in `/sdcard/captions/YYYY-MM-DD.txt`.
## Configuration
Before packaging, place `config.json` in the app's user-data directory (not source control):
```json
{
"server_url": "ws://192.168.68.102:8642/api/esp32/voice/ws",
"device_id": "your-registered-device-id",
"api_key": "device-profile-key"
}
```
The app never retries automatically: connection failure remains `FAILED` until the user selects **Start** again. **Stop** sends the gateway `stop` event, waits for the final caption, appends it to that day’s text file, then returns to idle.