dictate

# dictate - Voice to Text

Record from microphone and transcribe to text. Convenience wrapper combining `mic-record` and `transcribe`.

## Usage

```bash
dictate
dictate --duration 10
dictate --device plughw:Device --duration 30
```

## Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--duration` | 5 | Recording duration in seconds |
| `--device` | default | Audio device |
| `--lang` | en-US | Language for transcription |

## Output

Outputs transcribed text to stdout.

## Requirements

- `mic-record` tool
- `transcribe` tool
- Google Cloud Speech-to-Text API enabled
- `gcloud` CLI authenticated

## Examples

```bash
# Basic dictation
dictate --duration 10

# Use USB microphone
dictate --device plughw:Device --duration 10

# Dictate in Spanish
dictate --lang es-ES --duration 10

# Save to file
dictate --duration 30 > notes.txt

# Dictate and process
dictate --duration 10 | summarize
dictate --duration 10 | translate --lang French

# Dictate a commit message
dictate --duration 15 | git commit -F -
```

## How It Works

1. Calls `mic-record` to capture audio
2. Pipes audio file to `transcribe`
3. Outputs transcribed text
4. Cleans up temp audio file

## See Also

- `mic-record` - Audio recording (can be used independently)
- `transcribe` - Transcription (can transcribe any audio file)
- `read-aloud` - The reverse: text to speech with playback