O que video-download faz?
Baixe vídeos e áudios de URLs usando yt-dlp diretamente. Nenhum script de 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 a 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 várias legendas
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
Presets 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 (AAAAMMDD) |
%(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 em disco. - Se o 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 de
--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 vídeo e áudio são streams separados (comum no YouTube em HD).
- Downloads falham ou retornam erros: Execute
yt-dlp -Upara atualizar. Os sites mudam com frequência e o yt-dlp envia correções regularmente.