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

# Voice recap

> Record a voice channel and get a speaker-labelled transcript of it.

Recap records a voice channel and produces a written transcript with speakers identified. Built for meetings, staff calls and anything else worth having a record of.

<Warning>
  Recording people's voices has legal implications that vary by jurisdiction, and social ones that don't. **Tell everyone before you start.** Recording is disabled by default for exactly this reason, and anyone can permanently opt out.
</Warning>

## Enabling it

```javascript theme={null}
!recap toggle
```

Requires **Manage Server**. Off by default, server-wide.

## Recording

<CodeGroup>
  ```javascript Start theme={null}
  !recap start
  ```

  ```javascript A specific channel theme={null}
  !recap start #meeting-room
  ```

  ```javascript Check progress theme={null}
  !recap status
  ```

  ```javascript Stop and transcribe theme={null}
  !recap stop
  ```
</CodeGroup>

Aliases: `begin` / `end`. `recap status` shows how long it's been running and who's been captured.

When you stop, the audio is transcribed and posted as a text transcript with speaker labels and timestamps.

## Browsing past recordings

```javascript theme={null}
!recap list
```

Aliases: `history`. Past recordings for the server, with their transcripts.

## Opting out

```javascript theme={null}
!recap optout
```

**Permanent, global, and applies in every server.** An opted-out member's audio is never captured — not muted in the transcript, never recorded in the first place.

```javascript theme={null}
!recap optin
```

Reverses it.

<Note>
  Opt-out is a personal setting, not a server one. No server admin can override it, and nobody is told you've opted out.
</Note>

## Practical notes

* Only people **speaking** are recorded. Someone sitting silently in the channel produces nothing.
* Transcription quality depends on audio quality. A decent microphone and one person speaking at a time make an enormous difference; five people talking over each other will produce mush.
* Long recordings take a while to transcribe. A one-hour call is not instant.
* Everyone in the channel can see that recording is active.

<Tip>
  Set expectations before you start rather than after. "I'm recording this so we have notes" takes three seconds and avoids every awkward conversation that follows finding out later.
</Tip>

## Command reference

| Command                 | Aliases                   | Permission    | Description                  |
| ----------------------- | ------------------------- | ------------- | ---------------------------- |
| `recap`                 | `record`, `recaps`, `rec` | —             | Overview                     |
| `recap toggle`          | —                         | Manage Server | Enable recording server-wide |
| `recap start [channel]` | `begin`                   | —             | Start recording              |
| `recap stop`            | `end`                     | —             | Stop and transcribe          |
| `recap status`          | —                         | —             | What's been captured         |
| `recap list`            | `history`                 | —             | Past recordings              |
| `recap optout`          | —                         | —             | Never be recorded, anywhere  |
| `recap optin`           | —                         | —             | Undo an opt-out              |