Ir para o conteúdo
yt-dlp

Gerador de comandos yt-dlp para TikTok

Monte um comando do yt-dlp para um vídeo do TikTok ou para o perfil inteiro de um criador, com nomes de arquivo legíveis.

Opcional. Se deixar vazio, o comando termina em URL para você preencher.

Seu comando

yt-dlp --merge-output-format mp4 --no-playlist --embed-metadata -o '%(uploader)s - %(id)s.%(ext)s' https://www.tiktok.com/@user/video/1234567890
Básico

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

Vídeo e qualidade

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

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

Opções avançadas (3)

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

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

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

Áudio

O arquivo para o qual o áudio é convertido.

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

Legendas

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

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

Playlists e canais

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

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)

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)

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.

Metadados e capa
Opções avançadas (3)
SponsorBlock

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

Opções avançadas (1)

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

Arquivos e pastas

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

Opções avançadas (4)

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

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

Filtros
Opções avançadas (5)

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

AAAAMMDD, ou uma data relativa.

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

Pula o que for maior.

Quantidade de arquivos a baixar antes de parar.

Rede

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

Opções avançadas (5)

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

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

URL de proxy HTTP, HTTPS ou SOCKS.

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

Login e cookies

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)

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

Transmissões ao vivo
Opções avançadas (2)

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

Contornos
Opções avançadas (3)

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

Obsoleto em favor de --add-headers.

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

Saída e depuração
Opções avançadas (2)
Redefinir

Observações sobre o TikTok

O título no TikTok é a primeira linha da legenda, o que produz nomes de arquivo enormes e muitas vezes inúteis. O preset aqui nomeia os arquivos por autor e id, o que continua ordenável e nunca colide.

Se existe uma faixa sem marca d'água varia por vídeo e por região — rode o comando com -F para ver o que realmente existe antes de concluir que falta. Posts privados ou só para seguidores precisam de cookies de uma conta que consiga vê-los.

O TikTok já não é só vídeo vertical: posts em modo foto e apresentações de slides chegam pelas mesmas formas de URL, e o yt-dlp trata as de vários itens como playlists — cada slide um item próprio, o som de fundo como item de áudio separado quando existe. Essa é a forma da plataforma, não uma falha, e não há opção que junte uma apresentação de slides de volta num único arquivo. Um comando que parece "baixar só imagens" baixou, na verdade, exatamente o que o post é.

Uma URL de perfil — tiktok.com/@handle — baixa todos os vídeos da conta, e ela pagina, o que num criador prolífico é uma corrida longa. As abas de curtidas e salvos são visíveis só para a conta dona delas, então precisam de cookies de uma sessão autenticada. Combine o modo playlist inteira com o arquivo de registro e continuar após erros: uma conta prolífica terá pelo menos um post apagado, e sem essas duas opções um post apagado para as outras mil.

O TikTok limita com agressividade. Um download que começa rápido e depois rasteja, ou morre com um 403 no meio, geralmente é limitação de tráfego e não um extrator quebrado — adicione um limite de velocidade, reduza a contagem de fragmentos em paralelo e espace as execuções repetidas. Cookies de uma sessão autenticada elevam o teto consideravelmente. Um endpoint de VPN que muita outra gente está usando ao mesmo tempo tende a piorar a limitação em vez de melhorar: o IP já é suspeito antes de você enviar uma requisição.

Para o áudio, -x extrai a trilha de som de um TikTok igual em qualquer outro lugar, e pula o vídeo por completo. O "som original" de um vídeo é um item separado com página própria, então uma faixa que você ouviu no post de outra pessoa pode ser buscada pela página do som, sem o vídeo de nenhum modo. O nome de arquivo importa mais aqui que na maioria das plataformas — título vindo da legenda colide no momento em que dois posts começam com as mesmas palavras —, por isso este preset nomeia os arquivos por autor e id do vídeo.

Perguntas frequentes

O yt-dlp baixa do TikTok sem marca d'água?
Ele baixa o que o TikTok entregar. Faixas sem marca d'água às vezes existem e às vezes não, e isso varia por vídeo e por região — rode -F para ver o que existe naquela URL.
Posso baixar um TikTok privado ou só para seguidores?
Só se a sua própria conta puder vê-lo. Use --cookies-from-browser para que o yt-dlp faça o pedido como você.
Como baixo todos os vídeos de um criador?
Aponte o yt-dlp para a URL do perfil com o modo playlist inteira, e adicione um arquivo de registro para que as execuções seguintes tragam só o que é novo.