download-de-video
Baixe vídeos e áudios de URLs usando yt-dlp diretamente. Nenhum script wrapper é necessário.
Pré-requisitos
- yt-dlp:
brew install yt-dlpoupip install yt-dlp - ffmpeg:
brew install ffmpegouapt install ffmpeg(necessário para mesclar streams de vídeo+áudio)
Atualize o yt-dlp periodicamente para acompanhar as mudanças nos sites: yt-dlp -U ou pip install -U yt-dlp.
Comandos
Baixar melhor qualidade
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
Baixar resolução específica
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
Apenas áudio
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
Baixar legendas
# Baixar vídeo com legendas em inglês
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# Baixar vídeo com múltiplos idiomas de legenda
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# Baixar apenas legendas (sem vídeo)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
Obter metadados (sem download)
yt-dlp "URL" --dump-json --no-download
Listar formatos disponíveis
yt-dlp "URL" -F
Especificar diretório de saída
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
Predefinições de Qualidade
| Qualidade | Flag de formato |
|---|---|
| Melhor | -f "bestvideo+bestaudio/best" (padrão) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| Pior | -f "worstvideo+worstaudio/worst" |
Variáveis do Modelo de Saída
Variáveis comuns para modelos -o:
| Variável | Descrição |
|---|---|
%(title)s | Título do vídeo |
%(ext)s | Extensão do arquivo |
%(id)s | ID do vídeo |
%(uploader)s | Nome do canal/uploader |
%(upload_date)s | Data de upload (YYYYMMDD) |
%(duration)s | Duração em segundos |
%(resolution)s | Resolução do vídeo |
Dicas
- Sempre use
--merge-output-format mp4para evitar arquivos.webmou.mkv. - Use
--no-downloadcom--dump-jsonpara consultas apenas de metadados -- nenhum arquivo é gravado no disco. - Se um download falhar com erros HTTP, atualize o yt-dlp primeiro (
yt-dlp -U). - Use
-f "bestvideo[height<=720]+bestaudio"para economizar largura de banda quando a resolução máxima não for necessária. - O yt-dlp lida automaticamente com limitação de taxa e tentativas.
- A saída
--dump-jsonincluititle,duration,uploader,view_count,description,formats,subtitlese muito mais.
Solução de Problemas
- "yt-dlp: comando não encontrado": Instale-o (
pip install yt-dlp) e certifique-se de que seu PATH inclui o diretório bin do pip. - "ffmpeg: comando não encontrado": Instale o ffmpeg. Sem ele, os downloads falham quando o vídeo e o áudio estão em fluxos separados (comum no YouTube para HD).
- Downloads falham ou retornam erros: Execute
yt-dlp -Upara atualizar. Os sites mudam com frequência e o yt-dlp lança correções regularmente.