baoyu-youtube-transcript

Installation
Summary

Download YouTube transcripts, subtitles, and cover images with multi-language support and intelligent caching.

  • Accepts YouTube URLs or video IDs in multiple formats; no API key required, uses InnerTube API with automatic fallback to yt-dlp when blocked
  • Outputs markdown with timestamps, SRT subtitles, or raw transcript; supports language selection, translation, chapter segmentation, and speaker identification via AI post-processing
  • Caches raw transcript data and metadata on first fetch for fast re-formatting without network calls; use --refresh to force re-fetch
  • Handles CJK text intelligently, proportionally allocates timestamps across sentence boundaries, and auto-generates cover images and video metadata
SKILL.md

YouTube Transcript

Works with manual and auto-generated transcripts. No API key or browser: uses YouTube's InnerTube API, falling back to yt-dlp when YouTube blocks the direct path. First run also fetches metadata and cover image and caches raw data for fast re-formatting.

Script Directory

{baseDir} = this SKILL.md's directory. ${BUN_X} = bun if installed; else npx -y bun if npx available; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

Script Purpose
scripts/main.ts Transcript download CLI

Usage

Installs
22.2K
GitHub Stars
27.3K
First Seen
Mar 22, 2026