Guia de referência rápida para os comandos e opções mais comuns do yt-dlp.
yt-dlp é uma ferramenta de linha de comando de código aberto e um fork do youtube-dl mantido ativamente (oferecendo correções de bugs mais rápidas e suporte a 1700+ sites) para baixar vídeos, áudio e listas de reprodução.
Esta folha de referência cobre comandos comuns para baixar vídeo em 1080p/4K, extrair áudio MP3, contornar detecção de bots e embutir legendas.
Nuevo en la ferramenta? Visita nossa completa Guia de Download e Instalação do yt-dlp, ou simplesmente execute os exemplos abaixo diretamente no nosso console online sem nenhuma instalação.
Prefere criar seu próprio comando? Experimente o nosso Gerador de comandos yt-dlp interativo — escolha as opções e obtenha o comando exato.
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixe o vídeo na melhor qualidade (comportamento padrão). | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | Salve o vídeo com caminho de saída e modelo de nome de arquivo personalizados. | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | Limite a velocidade de download para contornar a limitação de banda (ex.: 50K, 10M). | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Evite conflitos de arquivos embutindo a data de upload e o ID único do vídeo no nome do arquivo de saída. |
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | Liste todas as resoluções, tamanhos, codecs e formatos disponíveis. | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Selecioner e baixar un código de formato específico (use -F para encontrar códigos primero). | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixar la mejor calidad de video a 1080p ou inferior. El mismo filtro de altura funciona para 1440p (2K) e 2160p (4K). | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | Force o download da melhor qualidade como um formato MP4 mesclado. | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | Baixar video e recodificarlo a MP4 estándar (útil si la plataforma use contenedores no estándar como WebM). |
-f bestvideo+bestaudio combinado com --merge-output-format mp4 para a melhor qualidade com máxima compatibilidade de dispositivos. No ytdlp.online, a mesclagem com ffmpeg é feita automaticamente no nosso servidor.
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | Extraia apenas a faixa de áudio (detecta automaticamente o melhor formato padrão). | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | Baixar audio e convertirlo específicamente al formato MP3. | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | Baixar audio e extraerlo como MP3 de mejor calidad (VBR 0 / equivalente a 320kbps). | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | Baixe o MP3 e embuta a descrição original do vídeo, as tags e a capa em miniatura. |
--embed-thumbnail --embed-metadata à sua extração de MP3 fornece automaticamente a capa do álbum e as tags da música — perfeito para apps de biblioteca musical como iTunes ou Spotify Local Files.
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Forçar o download de todos os vídeos em um link de playlist. | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixe apenas o vídeo individual da URL, ignorando a lista de reprodução à qual ele pertence. | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Baixe um intervalo específico de índices de uma lista de reprodução (ex.: 1-5, 1,3,5). |
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Liste todas as legendas enviadas manualmente e geradas automaticamente. | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Extraia e salve apenas os arquivos de legendas geradas automaticamente, pulando o download do vídeo. | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixe o vídeo e embuta automaticamente as legendas como soft-subs no arquivo MP4 mesclado. | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixe legendas enviadas manualmente em um idioma específico (ex.: en, zh-Hans, ja). Use --list-subs para ver os idiomas disponíveis primeiro. |
--sub-langs all para baixar legendas em todos os idiomas disponíveis, ou --sub-langs "en,zh-Hans" para obter vários idiomas de uma vez. Para a referência completa de legendas, consulte nossa Página de ajuda yt-dlp.
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Carregar cookies de um navegador (ex.: chrome, firefox) para contornar verificações de login ou bloqueio de bots. |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Imite as características do cliente TLS do navegador (requer curl-cffi) para contornar os bloqueios de detecção de bots do Cloudflare e do YouTube. | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Contorne os erros de "Faça login para confirmar que você não é um robô" forçando uma combinação específica de clientes do player do YouTube. | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Roteie o tráfego do yt-dlp através de um proxy HTTP, HTTPS ou SOCKS — útil para conteúdo com bloqueio geográfico. | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Falsifique o código de país de geolocalização (ex.: US, GB, JP) para contornar restrições regionais de conteúdo. |
| Comando | Descrição | Ações |
|---|---|---|
| yt-dlp -a urls.txt | Baixe em lote todas as URLs de vídeo listadas linha por linha em um arquivo de texto. |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | Dividir un video automáticamente en pistas/arquivos separados según sus capítulos internos. | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | Usar um downloader externo multi-thread (Aria2) para acelerar significativamente seus downloads. | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Aplique atrasos aleatórios (5 a 15s) entre os downloads para evitar banimentos de endereço IP. | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Baixar un clip de video específico ou rango de tiempo (ej. 1m0s a 2m30s) en lugar del video completo. | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Rastrear o histórico de downloads em archive.txt e pular automaticamente vídeos já baixados. |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
.exe independente como falso positivo devido ao empacotamento com PyInstaller. Instale via winget install yt-dlp para evitar isso. Para uma opção sem instalação, use nosso console online. Lee mais en nossa guia de segurança.
winget install yt-dlp. Você também pode usar Scoop, Chocolatey, pip, ou baixar o yt-dlp.exe independente diretamente do GitHub.
Execute qualquer comando yt-dlp no nosso servidor. Nenhuma instalação necessária.