Quick Start¶

Download a Video¶

ytdl-go https://www.youtube.com/watch?v=BaW_jenozKc

Downloads the best available quality to the current directory.

ytdl-go -audio https://www.youtube.com/watch?v=BaW_jenozKc

ytdl-go -list-formats https://www.youtube.com/watch?v=BaW_jenozKc

Use the interactive TUI to browse and select a format:

ytdl-go -info https://www.youtube.com/watch?v=BaW_jenozKc

Prints metadata as JSON without downloading.

ytdl-go "https://youtube.com/playlist?list=..."

ytdl-go -web

Opens a browser-based interface for downloading and managing media.

Goal	Command
Best video	`ytdl-go URL`
Audio only	`ytdl-go -audio URL`
Specific quality	`ytdl-go -quality 720p URL`
Specific format	`ytdl-go -format mp4 URL`
Specific itag	`ytdl-go -itag 251 URL`
Custom output path	`ytdl-go -o "downloads/{title}.{ext}" URL`
JSON output	`ytdl-go -json URL`
Quiet mode	`ytdl-go -quiet URL`

See the full CLI Options reference for all flags.