Skip to main content
subagent

podcast-transcriber — Claude Code subagent: how to install and use

Subagent for turning podcast audio and video into structured JSON transcripts. It runs FFMPEG to process tracks, identifies speakers, and calculates exact timestamps.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --agent ffmpeg-clip-team/podcast-transcriber
Open on GitHub

What podcast-transcriber does

This agent processes recordings directly through shell utilities. It starts by inspecting media streams with ffprobe to determine format details and runtime. Then it extracts the audio track into a single-channel 16 kHz WAV file via FFMPEG, applying a loudnorm filter whenever volume levels need leveling.

Longer audio runs are divided into chunks for easier handling. The agent assigns millisecond-level timestamps to each spoken phrase, distinguishes separate voices, and outputs everything as a JSON file. This payload includes confidence ratings alongside metadata like detected language and total run time.

Local ffmpeg and ffprobe binaries must be present in the path. Without them, shell execution fails immediately during the audio extraction stage.

What it helps with

  • extract audio from video files into 16 kHz mono WAV
  • normalize uneven loudness across podcast recordings
  • slice lengthy audio files into timed chunks
  • generate JSON transcripts with speaker labels and millisecond timings

Example prompts for the agent

  • Extract the audio from interview.mp4 and produce a JSON transcript with speaker tags.
  • Normalize episode_12.wav and transcribe speech with millisecond timestamps.

How to install podcast-transcriber

1claude-code-templates

npx claude-code-templates@latest --agent ffmpeg-clip-team/podcast-transcriber

2Manually: put the files in place

.claude/agents/podcast-transcriber.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about podcast-transcriber

How to install podcast-transcriber in Claude Code?

Run npx claude-code-templates@latest --agent ffmpeg-clip-team/podcast-transcriber. Alternatively, place the agent definition directly into .claude/agents/podcast-transcriber.md.

What does podcast-transcriber do?

It automates media extraction and speech transcription, outputting a structured JSON document with timestamps, confidence scores, and speaker labels.

What dependencies does podcast-transcriber require?

The subagent uses Bash, Read, and Write tools in Claude Code. The host system must have ffmpeg and ffprobe installed and reachable in the path.

Similar subagents

All subagents for AI and ML →

From the same set804

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor