tactility_apps/Apps/LiveCaptions

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):

{
  "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.