Windows PowerShell / CMD  ·  Copiar e colar  ·  Atualizado 2026

Cheatsheet de Comandos yt-dlp para Windows

Todos os comandos comuns do yt-dlp em um só lugar. Cole diretamente no PowerShell ou CMD. Substitua a URL pelo link do seu vídeo ou playlist.

Básico

Comandos essenciais do yt-dlp

Baixar um vídeo — melhor qualidade disponível
yt-dlp "URL"
Forçar mesclagem melhor vídeo + melhor áudio (requer FFmpeg)
yt-dlp -f "bestvideo+bestaudio/best" "URL"
Verificar versão instalada
yt-dlp --version
Atualizar para o último release
yt-dlp -U
Listar todos os formatos disponíveis para um vídeo
yt-dlp -F "URL"
Simulação — mostrar o que seria baixado sem baixar
yt-dlp --simulate "URL"

Qualidade & seleção de formato

Comandos de formato e resolução

Limitar a 1080p
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "URL"
Forçar 4K (2160p) se disponível
yt-dlp -f "bestvideo[height>=2160]+bestaudio/best" "URL"
Preferir H.264/MP4 — máxima compatibilidade
yt-dlp -f "bestvideo[ext=mp4][vcodec*=h264]+bestaudio[ext=m4a]/best[ext=mp4]" "URL"
Preferir AV1 → VP9 → fallback
yt-dlp -f "bestvideo[vcodec^=av01]/bestvideo[vcodec^=vp9]/bestvideo+bestaudio/best" "URL"

Áudio & MP3

Extração e conversão de áudio

Converter para MP3 — melhor qualidade com artwork e tags
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata "URL"
Manter áudio original sem re-codificar (melhor qualidade real)
yt-dlp -f ba -x --audio-format best "URL"
Converter playlist para MP3
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata --yes-playlist -o "%(playlist_index)02d-%(title)s.%(ext)s" "PLAYLIST_URL"
Lote de arquivo de texto (uma URL por linha)
yt-dlp -a links.txt -x --audio-format mp3 --audio-quality 0

Playlists & canais

Comandos de playlist e canal

Baixar playlist inteira — manter ordem nos nomes de arquivo
yt-dlp --yes-playlist -o "%(playlist_index)02d-%(title)s.%(ext)s" "PLAYLIST_URL"
Baixar apenas itens específicos
yt-dlp --playlist-items 1,5,10-12 "PLAYLIST_URL"
Retomar + pular já baixados
yt-dlp --continue --download-archive downloaded.txt "PLAYLIST_URL"
Baixar canal inteiro
yt-dlp "https://www.youtube.com/@NomeDoCanal/videos" -o "%(upload_date>%Y-%m-%d)s-%(title)s.%(ext)s"

Legendas

Comandos de download de legendas

Baixar legendas como arquivos SRT separados
yt-dlp --write-sub --write-auto-sub --sub-langs pt --sub-format srt "URL"
Incorporar legendas no MKV
yt-dlp -f "bv+ba/best" --write-auto-sub --sub-langs "pt,*" --embed-subs --merge-output-format mkv "URL"
Apenas legendas — sem download de vídeo
yt-dlp --write-sub --write-auto-sub --sub-langs pt --skip-download "URL"

Templates de saída

Nomes de arquivo e organização de pastas

Título do vídeo como nome de arquivo
-o "C:/Vídeos/%(title)s.%(ext)s"
Uma pasta por playlist, arquivos numerados
-o "C:/Vídeos/%(playlist)s/%(playlist_index)02d-%(title)s.%(ext)s"
Biblioteca de música — subpasta artista/canal
-o "C:/Música/%(artist,channel)s/%(title)s.%(ext)s"
Nomeação por data para canais
-o "C:/Vídeos/%(channel)s/%(upload_date>%Y-%m-%d)s-%(title)s.%(ext)s"

Variáveis de template comuns:

%(title)s
Título do vídeo
%(ext)s
Extensão do arquivo
%(id)s
ID do vídeo
%(upload_date)s
Data de upload (AAAAMMDD)
%(channel)s
Nome do canal
%(playlist_index)02d
Número de faixa com zeros

Avançado

Desempenho, cookies e metadados

Downloads de fragmentos paralelos (mais rápido em boas conexões)
-N 4
Limite de taxa (evitar throttling)
--limit-rate 5M
Tentar novamente em falhas
--retries 10 --fragment-retries 10
Passar cookies do navegador (para conteúdo privado ou restrito por idade)
--cookies-from-browser chrome
Incorporar thumbnail e metadados
--embed-thumbnail --embed-metadata
Apenas novos vídeos dos últimos 30 dias
--dateafter today-30days