Ir para o conteúdo
yt-dlp

YouTube para MP3 com yt-dlp

Monte o comando do yt-dlp que transforma um vídeo do YouTube num MP3 com tags e capa.

Conseguindo um MP3 utilizável

A extração é uma conversão, então o ffmpeg é obrigatório — é por isso que o comando falha numa instalação nova. A melhor (VBR) é o padrão certo: dá a melhor relação tamanho-qualidade, e um bitrate fixo mais alto não acrescenta qualidade que a fonte nunca teve.

Capa e metadados transformam uma pasta de arquivos anônimos em algo que um player consegue organizar. O modelo de nome aqui coloca o artista primeiro e recorre ao autor quando não há artista nas tags.

--audio-quality 0 é o ajuste que mais gente entende ao contrário. Não é "qualidade zero": é o melhor ajuste de taxa de bits variável, cerca de 245 kbps em média, e a escala corre ao contrário — 0 é o melhor e 9 o pior. A taxa variável gasta mais bits nas partes densas de uma faixa e menos nos silêncios, e por isso um arquivo VBR costuma soar melhor que um de taxa fixa do mesmo tamanho. Se precisar de taxa fixa para um aparelho que exige isso, peça pelo nome — --audio-quality 320K — em vez de chutar um número na escala 0–9.

A pergunta maior é se vale converter. O YouTube entrega o áudio em Opus ou AAC, e nenhum dos dois é MP3, então pedir MP3 sempre significa recodificar: o arquivo é decodificado e comprimido uma segunda vez, e um pouco de qualidade vai embora a cada passagem. Se nada que você tem exige especificamente a extensão .mp3, escolha "Melhor (sem conversão)". É mais rápido, dispensa o ffmpeg por completo, e o resultado fica mais perto da fonte do que qualquer MP3 dela consegue ficar. Converta quando o som do carro, um programa de DJ ou um celular antigo não deixarem alternativa.

Para uma playlist inteira, ligue as playlists e acrescente um arquivo de histórico. Ele registra o que já foi baixado, então rodar o mesmo comando na semana seguinte pega só o que é novo em vez de recomeçar — e junto com "continuar após erros", uma faixa bloqueada por região ou apagada deixa de derrubar as outras duzentas. Ponha o índice da playlist no modelo de saída se a ordem importa; sem ele o seu player vai ordenar a pasta alfabeticamente e o álbum sai fora de sequência.

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

Seu comando

yt-dlp -x --audio-format mp3 --audio-quality 0 --no-playlist --embed-thumbnail --embed-metadata -o '%(artist,uploader)s - %(title)s.%(ext)s' 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
Básico

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

Áudio

O arquivo para o qual o áudio é convertido.

VBR dá a melhor relação tamanho-qualidade; bitrates fixos são mais previsí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.

Metadados e capa
Opções avançadas (3)
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.

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.

Redefinir

Perguntas frequentes

Que qualidade de MP3 devo escolher?
A melhor (VBR) na maioria dos casos — dá a melhor relação tamanho-qualidade. 320 kbps só vale se algo mais adiante exigir bitrate fixo. Nenhuma das duas acrescenta qualidade que a fonte não tinha.
Por que a extração de MP3 falha?
Converter áudio exige ffmpeg. Instale e confira com ffmpeg -version.
VBR ou bitrate fixo?
VBR gasta bits onde importam e fica menor com a mesma qualidade percebida. Use bitrate fixo só quando um aparelho ou programa exigir.
Posso converter uma playlist inteira para MP3?
Sim — saída de áudio mais modo playlist inteira. Adicione um arquivo de registro para que uma nova execução não repita as conversões.