Skip to main content

CLI tool to transcribe podcasts and YouTube videos into clean markdown with speaker diarization and timestamps

Project description

Podscript

Podcast → Transcript!

Transcribe any podcast episode or YouTube video from the command line. Generates clean markdown with speaker diarization and timestamps.

Podscript - Podcast to Transcript

Installation

pip install podscript
podscript --setup  # paste your ElevenLabs API key

You'll need an ElevenLabs API key.

For YouTube support, also install yt-dlp and ffmpeg.

Usage

# Transcribe a podcast from an Apple Podcasts link
podscript "https://podcasts.apple.com/us/podcast/huberman-lab/id1545953110?i=1000690"

# Transcribe a YouTube video
podscript "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Use an RSS feed directly
podscript https://feeds.simplecast.com/JGE3yC0V

# Browse episodes first
podscript https://feeds.simplecast.com/JGE3yC0V --list

# Search for a specific episode
podscript https://feeds.simplecast.com/JGE3yC0V --search "AI"

# Pick episode #3 from the list
podscript https://feeds.simplecast.com/JGE3yC0V --episode 3

# Custom output filename
podscript https://feeds.simplecast.com/JGE3yC0V --latest --output transcript.md

Without any flags, the default behavior is to transcribe the most recent episode.

Output

Generates a markdown file with speaker labels and timestamps:

# The Economics of Carbon Removal

**Podcast:** a16z Podcast
**Date:** 2/10/2026
**Duration:** 1:04:23

---

## Speaker 1
[0:00] Welcome back to the show. Today we're talking about...

## Speaker 2
[0:15] Thanks for having me. So the key challenge with carbon removal is...

## Speaker 1
[2:41] That's fascinating. How does the economics actually work at scale?

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

podscript-0.1.0.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

podscript-0.1.0-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file podscript-0.1.0.tar.gz.

File metadata

  • Download URL: podscript-0.1.0.tar.gz
  • Upload date:
  • Size: 10.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.6

File hashes

Hashes for podscript-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a13d36e6f54fa33416ee38244a8c8de3a1d09889fba072456d848e8e9866d3fb
MD5 648260ca43013395ab8995e0838fb55a
BLAKE2b-256 6f2261f5a2fdb0d67750ec394ab07e65a1718fe248e7188f9ec3c9d0b9086172

See more details on using hashes here.

File details

Details for the file podscript-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: podscript-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.6

File hashes

Hashes for podscript-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5d3880eccda84135ea646e4b93a15393341ea2e4465bc626c20fa8274b28c1c8
MD5 372505a79ff328a4d3b8fd750d3b8c6f
BLAKE2b-256 8c3696d2e8847c0974951a0d070c4ea23070e6e44b813b119a8752c44fd7d2b7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page