Ir para o conteúdo

yt-dlp: downloader de áudio e vídeo avançado

yt-dlp é uma ferramenta de linha de comando projetada para baixar áudio e vídeo de uma vasta gama de sites na internet. Sua origem como fork do youtube-dl garante compatibilidade ampla, enquanto o desenvolvimento ativo traz novos recursos e suporte a serviços emergentes.

Instalação

A instalação pode ser feita de várias maneiras, dependendo do sistema operacional e das preferências do usuário. As opções mais comuns incluem:

  • Baixar o executável pré‑compilado diretamente da página de releases.
  • Utilizar gerenciadores de pacotes como pip (pip install -U yt-dlp).
  • Clonar o repositório Git e compilar a partir do fonte (necessita de Python e ferramentas de build).

Observação

É recomendável manter o yt-dlp atualizado para garantir acesso aos últimos extractores e correções de segurança.

Dica

Ao instalar via pip, use a flag --user para evitar necessidade de privilégios de administrador.

Uso e Opções

O yt-dlp oferece um conjunto extenso de opções que permitem ajustar quase todos os aspectos do download. As principais categorias são:

  • Opções gerais (verbose, simulação, saída padrão).
  • Opções de rede (proxy, timeout, retry).
  • Seleção de vídeo (filtro por ID, título, data).
  • Opções de download (limite de taxa, número de simultâneos).
  • Opções de sistema de arquivos (nome de arquivo, diretório, sobrescrever).
  • Opções de thumbnail e atalhos de internet.
  • Opções de verbosidade e simulação.
  • Workarounds para sites com restrições ou mecanismos de proteção.
  • Opções de formato de vídeo (seleção, filtragem, ordenação).
  • Opções de legenda (embed, conversão, subsync).
  • Opções de autenticação (netrc, cookies, token).
  • Opções de pós‑processamento (extração de áudio, embed de thumbnail, metadados).
  • Opções do SponsorBlock (pular segmentos patrocinados).
  • Opções de extrator (arguments específicos por site).
  • Alias de preset (configurações prontas para uso comum).

Configuração

O comportamento do yt-dlp pode ser ajustado por meio de arquivos de configuração, variáveis de ambiente ou opções na linha de comando. Pontos relevantes incluem:

  • Definição da codificação do arquivo de configuração (UTF‑8 recomendado).
  • Autenticação via arquivo netrc para login em serviços que exigem credenciais.
  • Uso de variáveis de ambiente como YTDLP_OPTS para aplicar opções globalmente.

Seleção de Formato

A escolha do formato de saída é uma das funcionalidades mais poderosas do yt-dlp. Ele permite filtrar, ordenar e combinar streams de vídeo e áudio conforme critérios como resolução, taxa de bits, codec e contêiner. Exemplos de uso incluem:

  • -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" para obter o melhor vídeo MP4 com áudio compatível.
  • -f "best" para selecionar o formato único de maior qualidade disponível.

Plugins e Extensão

O yt-dlp suporta plugins que podem acrescentar novos extractores ou modificar o comportamento existente. O processo envolve:

  1. Instalação do plugin via pip ou colocando o arquivo no diretório de plugins.
  2. Para desenvolvedores, criação de um novo extractor seguindo a estrutura de classe definida no projeto.

Incorporação (Embedding)

Além do uso direto via CLI, o yt-dlp pode ser embarcado como biblioteca em aplicativos Python, permitindo chamadas programáticas ao seu API de download. Exemplos de embed mostram como definir opções, coletar metadados e tratar eventos de progresso.

Pontos-chave

  • yt-dlp é um downloader de linha de comando com suporte a milhares de sites, derivado do youtube-dl/youtube-dlc.
  • Oferece ampla gama de opções de instalação, uso, configuração e pós‑processamento.
  • Permite seleção avançada de formatos, uso de plugins e embeddamento em código Python.

Ferramentas e Tecnologias

  • [[yt-dlp]]
  • [[Python]]
  • [[FFmpeg]]

Nota pessoal

https://github.com/yt-dlp/yt-dlp

Tags

downloader #linha-de-comando #vídeo #áudio #plugins