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