aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 36d5ffcd656dbd6e8b106ab9a9b980d3304cb7a4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# tldw

Too Long; Didn't Watch - Summarize YouTube videos using Claude.

## Installation

```bash
uv sync
```

## Usage

### tldw - Summarize a video

```bash
tldw <youtube-url>
tldw -l es <youtube-url>                            # Use Spanish captions
tldw -r <youtube-url>                               # Output raw transcript
tldw -m openai/gpt-4o <youtube-url>                 # Use OpenAI
tldw -m anthropic/claude-sonnet-4-20250514 <url>    # Use Anthropic API
```

**Options:**
- `-l, --language` - Language code for captions (default: `en`)
- `-r, --raw` - Output raw transcript without summarizing
- `-m, --model` - Model in `provider/model` format (default: `claude/sonnet`)
- `-s, --system-prompt` - Custom prompt for the LLM

**Supported providers:**
- `claude/*` - Claude Agent SDK (sonnet, opus, haiku)
- `anthropic/*` - Anthropic API (requires `ANTHROPIC_API_KEY`)
- `openai/*` - OpenAI API (requires `OPENAI_API_KEY`)

### yt-transcript - Get raw transcript

```bash
yt-transcript <youtube-url>
```

Outputs timestamped transcript snippets.

## Requirements

- Python 3.12+
- Claude Code CLI (bundled with multillm-claude)