> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# moorcheh-edge voice listen

> Record from the mic and print transcribed text.

## Synopsis

```bash theme={null}
moorcheh-edge voice listen [options]
```

Records from the default (or selected) ALSA capture device and transcribes with **Whisper tiny.en**.

## Options

| Flag | Default | Description |
| - | - | - |
| `--seconds` | - | Fixed recording length (disables silence detection) |
| `--until-silence` / `--no-until-silence` | on | Stop when you pause speaking |
| `--max-seconds` | `30` | Max length when using silence detection |
| `--capture-device` | env default | ALSA device, e.g. `plughw:1,0` (or `MOORCHEH_AUDIO_CAPTURE`) |
| `--json` | off | Print `{"text": "..."}` instead of plain text |

## Examples

```bash theme={null}
moorcheh-edge voice listen
moorcheh-edge voice listen --seconds 5
moorcheh-edge voice listen --capture-device plughw:1,0 --json
```

## Output

Prints transcribed text to stdout, or JSON when `--json` is set.

## Related

* [`voice transcribe`](/cli/voice/transcribe)
* [Voice server: POST /listen](/api-references/voice-serve#post-listen)
* [Voice CLI overview](/cli/voice/introduction)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.