1. yt-dlp 설치
Homebrew가 가장 손이 덜 가는 길이고, 한 줄로 두 도구를 모두 설치합니다.
brew install yt-dlp ffmpeg
Homebrew를 쓰지 않는다면 pipx가 yt-dlp를 자체 환경에 두므로 Python으로 설치한 다른 것과 충돌하지 않습니다.
pipx install yt-dlp
시스템 Python에 그냥 pip install을 하는 것은 피하세요. 최근 macOS는 이를 막으며, 어쩌다 되더라도 나중에 엉뚱한 이유로 깨지기 쉽습니다.
2. ffmpeg 설치
Homebrew를 썼다면 위에서 이미 함께 설치됐습니다. 그렇지 않다면 따로 설치하세요. 병합, MP3 추출, 삽입이 모두 이것에 의존합니다.
brew install ffmpeg
3. 제대로 됐는지 확인
yt-dlp --version ffmpeg -version
pipx로 설치한 뒤 셸이 yt-dlp를 찾지 못하면 pipx ensurepath를 실행하고 새 터미널을 여세요.
Safari의 쿠키
--cookies-from-browser safari는 터미널에 대한 전체 디스크 접근 권한이 필요하며, 시스템 설정 → 개인정보 보호 및 보안에서 부여합니다. 없으면 권한 오류로 실패하는데, 그 메시지는 이 설정을 언급하지 않습니다. Chrome과 Firefox는 이것 없이도 동작합니다.
갱신
brew upgrade yt-dlp # Homebrew pipx upgrade yt-dlp # pipx