Gerador de comandos yt-dlp para SoundCloud

yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata -o '%(uploader)s - %(title)s.%(ext)s' https://soundcloud.com/artist/track

Básico

O que você quer

Vídeo Só áudio

Só áudio extrai a trilha sonora e descarta o vídeo.

Vídeo e qualidade

Qualidade máxima -f A melhor disponível 4K (2160p) 2K (1440p) 1080p 720p 480p 360p

Limita a altura. O yt-dlp ainda escolhe a melhor faixa nesse limite ou abaixo.

Container --merge-output-format precisa de ffmpeg Manter o original MP4 (o mais compatível) MKV (aceita tudo) WebM MOV

O tipo de arquivo em que as faixas separadas de vídeo e áudio são unidas.

Opções avançadas (3)

Selector de formato próprio -f

Substitui a lista de qualidade. Para quem já conhece a sintaxe de formatos.

Remux para --remux-video precisa de ffmpeg Nenhum MP4 (o mais compatível) MKV (aceita tudo) WebM MOV

Reempacota as faixas sem recodificar. Rápido e sem perdas.

Recodificar para --recode-video precisa de ffmpeg Nenhum MP4 (o mais compatível) MKV (aceita tudo) WebM

Recodifica o vídeo. Lento e com perdas — só quando remux não resolver.

Áudio

Formato de áudio --audio-format precisa de ffmpeg MP3 M4A (AAC) Opus FLAC (sem perdas) WAV (sem perdas) Vorbis A melhor disponível (sem conversão)

O arquivo para o qual o áudio é convertido.

Qualidade do áudio --audio-quality precisa de ffmpeg A melhor (VBR) 320 kbps 256 kbps 192 kbps 128 kbps

VBR dá a melhor relação tamanho-qualidade; bitrates fixos são mais previsíveis.

Legendas

Legendas Nenhum Embutir no vídeo Salvar como arquivo .srt Embutir e salvar

Embutir coloca as legendas dentro do vídeo; salvar grava um .srt separado ao lado.

Idiomas das legendas --sub-langs

Separados por vírgula. Use all para todos os idiomas disponíveis.

Legendas automáticas --write-auto-subs Inclui as legendas geradas por máquina quando não existem legendas humanas.

Playlists e canais

Playlists Deixar o yt-dlp decidir Só este vídeo A playlist inteira

O que fazer quando a URL pertence a um vídeo e a uma playlist ao mesmo tempo.

Quais itens -I

Intervalos e listas funcionam, por exemplo 1-10,15 ou -5::2 para um a cada dois de trás para frente.

Opções avançadas (1)

Arquivo de registro --download-archive

Anota o que já foi baixado para que uma nova execução pule. É assim que se mantém um canal sincronizado.

Trechos e capítulos

Opções avançadas (2)

Baixar só um trecho --download-sections precisa de ffmpeg

Um intervalo como *00:01:30-00:03:00, ou o nome de um capítulo. O asterisco na frente indica que é um horário.

Dividir por capítulos --split-chapters precisa de ffmpeg Grava um arquivo por capítulo em vez de um só, longo.

Metadados e capa

Embutir thumbnail --embed-thumbnail precisa de ffmpeg Usa a thumbnail do vídeo como capa.

Embutir metadados --embed-metadata precisa de ffmpeg Grava título, autor e data dentro do próprio arquivo.

Embutir capítulos --embed-chapters precisa de ffmpeg Adiciona marcadores de capítulo que seu player consegue pular.

Opções avançadas (3)

Salvar a thumbnail --write-thumbnail Grava a imagem de capa ao lado do vídeo.

Salvar a descrição --write-description Grava a descrição num arquivo .description.

Salvar metadados em JSON --write-info-json Grava tudo que o yt-dlp sabe sobre o vídeo num arquivo .info.json.

SponsorBlock

Remover trechos --sponsorblock-remove precisa de ffmpeg Nenhum Só patrocínios Patrocínios, introduções e autopromoção Tudo que está marcado

Corta do arquivo os trechos marcados pela comunidade, usando os dados do SponsorBlock.

Opções avançadas (1)

Marcar trechos como capítulos --sponsorblock-mark Nenhum Patrocínios, introduções e autopromoção Tudo que está marcado

Mantém os trechos, mas marca-os para você pular por conta própria.

Arquivos e pastas

Modelo do nome do arquivo -o

Título Título + ID Playlist numerada Autor / data - título

Os campos vão em %(...)s. Barras criam pastas.

Nomes seguros (só ASCII) --restrict-filenames Remove acentos, espaços e qualquer caractere que um sistema de arquivos exigente possa rejeitar.

Sobrescrever arquivos existentes --force-overwrites Substitui os arquivos que já estiverem lá.

Continuar downloads parciais -c Retoma de onde o download foi interrompido.

Opções avançadas (4)

Pasta de download -P

Onde os arquivos são gravados. Combine com o modelo acima para criar subpastas.

Nomes compatíveis com Windows --windows-filenames Remove os caracteres que o Windows recusa, mesmo rodando em outro sistema.

Cortar nomes em --trim-filenames

Tamanho máximo do nome do arquivo, em caracteres.

Nunca sobrescrever -w Pula tudo que já foi baixado.

Filtros

Opções avançadas (5)

Publicado depois de --dateafter

AAAAMMDD, ou uma data relativa como now-1month.

Publicado antes de --datebefore

AAAAMMDD, ou uma data relativa.

Tamanho mínimo --min-filesize

Pula o que for menor. Aceita 5M, 500K e similares.

Tamanho máximo --max-filesize

Pula o que for maior.

Parar depois de --max-downloads

Quantidade de arquivos a baixar antes de parar.

Rede

Limite de velocidade -r

Por exemplo 2M ou 500K. Útil quando você precisa do resto da banda.

Opções avançadas (5)

Fragmentos em paralelo -N

Acelera faixas fragmentadas. Quatro é um bom ponto de partida.

Tentativas -R

Quantas vezes tentar de novo uma parte que falhou. infinite é aceito.

Proxy --proxy

URL de proxy HTTP, HTTPS ou SOCKS.

Contornar bloqueio regional --geo-bypass Finge a origem da requisição. Funciona em alguns sites, não em todos.

Simular um navegador --impersonate Nenhum Chrome Edge Safari Firefox

Faz as requisições parecerem de um navegador real. É a solução comum para um 403 repentino.

Login e cookies

Cookies do navegador --cookies-from-browser Nenhum Chrome Firefox Edge Brave Safari Chromium Opera Vivaldi

Lê sua sessão logada diretamente. Necessário para conteúdo privado, com restrição de idade ou só para membros.

Opções avançadas (1)

Arquivo de cookies --cookies

Um cookies.txt no formato Netscape exportado do seu navegador.

Transmissões ao vivo

Opções avançadas (2)

Gravar desde o início --live-from-start Começa uma transmissão ao vivo do início em vez do momento atual.

Esperar a transmissão --wait-for-video

Consulta até uma transmissão agendada começar. MIN-MAX segundos entre as checagens.

Contornos

Opções avançadas (3)

User agent --user-agent obsoleto

Obsoleto em favor de --add-headers. Mantido porque muitos guias antigos ainda usam.

Referer --referer obsoleto

Obsoleto em favor de --add-headers.

Argumentos do extractor --extractor-args

Opções específicas de cada site, por exemplo youtube:player_client=web.

Saída e depuração

Só listar formatos -F Imprime os formatos disponíveis e encerra sem baixar.

Opções avançadas (2)

Continuar apesar dos erros -i Pula os itens que falham em vez de parar. Indispensável em playlists grandes.

Simular -s Faz tudo, menos gravar o arquivo.