elevenlabs-transcribe

---
name: elevenlabs-transcribe
description: Transcribe audio to text using ElevenLabs Scribe. Supports batch transcription, realtime streaming from URLs, microphone input, and local files.
homepage: https://elevenlabs.io/speech-to-text
metadata: {"clawdbot":{"emoji":"🎙️","requires":{"bins":["ffmpeg","python3"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY"}}
---

# ElevenLabs Speech-to-Text

> **Official ElevenLabs skill for speech-to-text transcription.**

Convert audio to text with state-of-the-art accuracy. Supports 90+ languages, speaker diarization, and realtime streaming.

## Prerequisites

- **ffmpeg** installed (`brew install ffmpeg` on macOS)
- **ELEVENLABS_API_KEY** environment variable set
- Python 3.8+ (dependencies auto-install on first run)

## Usage

```bash
{baseDir}/scripts/transcribe.sh <audio_file> [options]
{baseDir}/scripts/transcribe.sh --url <stream_url> [options]
{baseDir}/scripts/transcribe.sh --mic [options]
```

## Examples

### Batch Transcription

Transcribe a local audio file:

```bash
{baseDir}/scripts/transcribe.sh recording.mp3
```

With speaker identification:

```bash
{baseDir}/scripts/transcribe.sh meeting.mp3 --diarize
```

Get full JSON response with timestamps:

```bash
{baseDir}/scripts/transcribe.sh interview.wav --diarize --json
```

### Realtime Streaming

Stream from a URL (e.g., live radio, podcast):

```bash
{baseDir}/scripts/transcribe.sh --url https://npr-ice.streamguys1.com/live.mp3
```

Transcribe from microphone:

```bash
{baseDir}/scripts/transcribe.sh --mic
```

Stream a local file in realtime (useful for testing):

```bash
{baseDir}/scripts/transcribe.sh audio.mp3 --realtime
```

### Quiet Mode for Agents

Suppress status messages on stderr:

```bash
{baseDir}/scripts/transcribe.sh --mic --quiet
```

## Options

| Option | Description |
|--------|-------------|
| `--diarize` | Identify different speakers in the audio |
| `--lang CODE` | ISO language hint (e.g., `en`, `pt`, `es`, `fr`) |
| `--js