Ir para o conteúdo
yt-dlp

Instalar o yt-dlp no macOS

Instale o yt-dlp e o ffmpeg no macOS com Homebrew ou pipx, e mantenha-os atualizados.

1. Instalar o yt-dlp

O Homebrew é o caminho de menor resistência e instala as duas ferramentas numa linha só.

brew install yt-dlp ffmpeg

Sem Homebrew, o pipx mantém o yt-dlp no ambiente dele, de modo que não colide com nada que você tenha instalado pelo Python.

pipx install yt-dlp

Evite um pip install cru no Python do sistema: versões recentes do macOS resistem a isso e, quando funciona, tende a quebrar depois por motivos alheios.

2. Instalar o ffmpeg

Já incluído acima se você usou o Homebrew. Caso contrário, instale à parte — juntar, extrair MP3 e embutir dependem todos dele.

brew install ffmpeg

3. Conferir se funcionou

yt-dlp --version
ffmpeg -version

Se o shell não achar o yt-dlp depois de uma instalação via pipx, rode pipx ensurepath e abra um terminal novo.

Cookies do Safari

--cookies-from-browser safari exige Acesso Total ao Disco para o seu terminal, concedido em Ajustes do Sistema → Privacidade e Segurança. Sem isso a leitura falha com um erro de permissão que não menciona esse ajuste. Chrome e Firefox funcionam sem.

Atualizar

brew upgrade yt-dlp     # Homebrew
pipx upgrade yt-dlp     # pipx

Perguntas frequentes

O macOS não encontra o yt-dlp depois de instalar com pipx.
Rode pipx ensurepath e abra um terminal novo para o PATH atualizado ser carregado.
Preciso de algo extra para cookies no macOS?
Só para o Safari: --cookies-from-browser safari exige acesso total ao disco para o seu terminal, em Ajustes do Sistema → Privacidade e Segurança. Chrome e Firefox funcionam sem isso.