본문으로 건너뛰기
yt-dlp

macOS에 yt-dlp 설치하기

Homebrew나 pipx로 macOS에 yt-dlp와 ffmpeg를 설치하고 최신 상태로 유지합니다.

이 글은 아직 번역되지 않아 영어로 표시됩니다. 화면 인터페이스는 여러분의 언어로 되어 있습니다.

1. Install yt-dlp

Homebrew is the path of least resistance and installs both tools in one line.

brew install yt-dlp ffmpeg

Without Homebrew, pipx keeps yt-dlp in its own environment so it cannot collide with anything else you have installed through Python.

pipx install yt-dlp

Avoid a bare pip install into the system Python: recent macOS releases push back on it, and when it does work it tends to break later for unrelated reasons.

2. Install ffmpeg

Included above if you used Homebrew. Otherwise install it separately — merging, MP3 extraction and embedding all depend on it.

brew install ffmpeg

3. Check it worked

yt-dlp --version
ffmpeg -version

If the shell cannot find yt-dlp after a pipx install, run pipx ensurepath and open a new terminal.

Cookies from Safari

--cookies-from-browser safari needs Full Disk Access for your terminal, granted in System Settings → Privacy & Security. Without it the read fails with a permissions error that does not mention the setting. Chrome and Firefox work without it.

Updating

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

자주 묻는 질문

pipx로 설치한 뒤 macOS가 yt-dlp를 찾지 못합니다.
pipx ensurepath 를 실행하고 새 터미널을 열어 갱신된 PATH를 읽게 하세요.
macOS에서 cookies를 쓰려면 뭔가 더 필요한가요?
Safari만 그렇습니다: --cookies-from-browser safari 는 터미널에 전체 디스크 접근 권한을 요구합니다(시스템 설정 → 개인정보 보호 및 보안). Chrome과 Firefox는 필요 없습니다.
yt-dlp는 어떻게 갱신하나요?
단독 바이너리는 yt-dlp -U 로 스스로 갱신합니다. 패키지 관리자로 설치했다면 그쪽으로 갱신하세요. 자체 갱신은 자기 소유가 아닌 파일을 건드리지 않습니다. 어떤 flag보다도 갱신이 더 많은 문제를 해결합니다.