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

{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:

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

With speaker identification:

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

Get full JSON response with timestamps:

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

Realtime Streaming

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

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

Transcribe from microphone:

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

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

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

Quiet Mode for Agents

Suppress status messages on stderr:

{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) | | --json | Output full JSON with timestamps and metadata | | --events | Tag audio events (laughter, music, applause) | | --realtime | Stream local file instead of batch processing | | --partials | Show interim transcripts during realtime mode | | -q, --quiet | Suppress status messages (recommended for agents) |

Output Format

Text Mode (default)

Plain text transcription:

The quick brown fox jumps over the lazy dog.

JSON Mode (--json)

{
  "text": "The quick brown fox jumps over the lazy dog.",
  "language_code": "eng",
  "language_probability": 0.98,
  "words": [
    {"text": "The", "start": 0.0, "end": 0.15, "type": "word", "speaker_id": "speaker_0"}
  ]
}

Realtime Mode

Final transcripts print as they're committed. With --partials:

[partial] The quick
[partial] The quick brown fox
The quick brown fox jumps over the lazy dog.

Supported Formats

Audio: MP3, WAV, M4A, FLAC, OGG, WebM, AAC, AIFF, Opus Video: MP4, AVI, MKV, MOV, WMV, FLV, WebM, MPEG, 3GPP

Limits: Up to 3GB file size, 10 hours duration

Error Handling

The script exits with non-zero status on errors:

• Missing API key: Set ELEVENLABS_API_KEY environment variable
• File not found: Check the file path exists
• Missing ffmpeg: Install with your package manager
• API errors: Check API key validity and rate limits

When to Use Each Mode

| Scenario | Command | |----------|---------| | Transcribe a recording | ./transcribe.sh file.mp3 | | Meeting with multiple speakers | ./transcribe.sh meeting.mp3 --diarize | | Live radio/podcast stream | ./transcribe.sh --url <url> | | Voice input from user | ./transcribe.sh --mic --quiet | | Need word timestamps | ./transcribe.sh file.mp3 --json |