transcript-to-epublisted

# Transcript to EPUB Turn a spoken-word transcript (a YouTube URL or a local timestamped markdown file) into a calm, book-like EPUB — and **always** credit the original creators with an explicit unofficial / no-copyright-claim notice. ## When To Use - YouTube video URL → auto-fetch transcript + channel name → EPUB - Raw transcript with `**HH:MM:SS**` timestamps → clean EPUB - Podcast / interview transcripts with `>>` speaker markers → auto-detect speakers - Any conversation transcript that should become a readable e-book ## When NOT To Use - Already-formatted markdown → just use `pandoc` directly - Video/audio with no captions → needs captions or a manual transcript - Private/restricted YouTube videos → transcript won't be accessible ## Requirements - `python3` and `pandoc` on PATH (pandoc builds the EPUB). - YouTube input: `pip3 install youtube-transcript-api` (no API key needed). - `--cover-method pillow` (and `auto` when Pillow is present): `pip3 install Pillow`. - `yt-dlp` *(optional)* — more reliable YouTube title/channel; falls back to HTML scrape. ## CLI contract ``` python3 scripts/build.py <input> [options] ``` `<input>` is a YouTube URL **or** a path to a local `.md` transcript. | Flag | Default | Meaning | |------|---------|---------| | `input` (positional) | — | YouTube URL or local `.md` transcript path | | `--title` | derived from filename or video title | Book title | | `--speakers` | auto-detected | Comma-separated names; overrides the auto-detected