Format Selection¶
Interactive Format Browser¶
Use -list-formats to browse all available formats in an interactive TUI:
Keyboard Controls¶
| Key | Action |
|---|---|
↑/↓ or j/k |
Navigate |
Enter |
Download selected format |
1-9 |
Jump to itags starting with digit |
Page Up/Down |
Jump 10 formats |
Home/End or g/G |
First/Last format |
b |
Go back without downloading |
q/Esc/Ctrl+C |
Quit |
Quality Selection¶
# Specific resolution
ytdl-go -quality 1080p URL
ytdl-go -quality 720p URL
# Best or worst
ytdl-go -quality best URL
ytdl-go -quality worst URL
# Audio bitrate (with -audio)
ytdl-go -audio -quality 128k URL
If the exact quality is unavailable, the closest match is selected.
Container Format¶
Direct Itag Selection¶
Bypass automatic selection by specifying a YouTube itag number:
Common itags:
| Itag | Type | Description |
|---|---|---|
| 18 | Video | 360p MP4 (progressive) |
| 22 | Video | 720p MP4 (progressive) |
| 140 | Audio | AAC 128kbps |
| 251 | Audio | Opus ~160kbps |
JSON Format Listing¶
For scripting, combine -json with -list-formats to get machine-readable format data:
Flag Precedence¶
When flags conflict:
-itagoverrides-qualityand-format-jsonimplies-quiet-infoprevents downloading (metadata only)-list-formatsprevents automatic downloading