Skip to main content
Version: 0.4.x

Voice Input in Remote Mode

In remote control mode, the MIC key records with the keypad's microphone and sends the audio to a Whisper-compatible endpoint you configure. The transcript appears in an on-screen editor, and you press ACCEPT to submit it to the terminal.

An ASR service is required

Remote mode always records on the device, so the MIC key does nothing until you configure a speech-to-text service. The "prefer built-in ASR" setting applies to keyboard mode only.

Configure the speech-to-text service

Open the VibeKeys setup page in Chrome or Edge, connect to your device, and fill in the ASR (Speech Recognition) fields:

FieldWhat to enter
URIA Whisper-compatible transcriptions endpoint, e.g. https://api.groq.com/openai/v1/audio/transcriptions
API keyThe API key for that service (sent as a bearer token)
ModelThe model name, e.g. whisper-large-v3

Groq, OpenAI, and self-hosted whisper.cpp or faster-whisper servers all work.

Choose a MIC mode

The setup page offers two trigger styles for the MIC key:

  • PTT (push to talk): hold MIC to record, release to send.
  • Toggle: tap MIC to start recording, tap again to stop and send.

Use it

  1. Press MIC and speak. The screen shows connecting... in a yellow frame, then a green frame while it listens.
  2. When recognition finishes, the transcript opens in an editor on the device screen.
  3. Move the cursor with the rotary knob to edit it.
  4. Press ACCEPT to send the text to the terminal, or ESC to discard it.