Windows, macOS, Linux를 위한 단계별 설정 가이드.
yt-dlp는 강력한 명령줄 미디어 다운로더(youtube-dl의 적극적으로 유지보수되는 포크)로, 수천 개의 웹사이트에서 동영상과 오디오를 다운로드할 수 있습니다. 터미널에서 실행되므로 기본 그래픽 인터페이스가 없습니다.
고화질 비디오(1080p, 4K 등)를 다운로드하거나 MP3 오디오를 추출하려면 FFmpeg를 반드시 설치해야 합니다. YouTube의 JavaScript 제한에 대비해 Deno 설치를 강력히 권장합니다. 아래에 가이드가 준비되어 있습니다.
소프트웨어를 설치하고 싶지 않으신가요? 모든 명령어를 직접 온라인 콘솔 구성 없이.
Windows 10 (1809+)과 Windows 11에는 Windows 패키지 관리자(winget)가 기본 포함되어 있습니다. 설치, 경로, 업데이트를 자동으로 관리합니다.
winget install yt-dlpWindows에서 명령줄 패키지 관리자를 사용하는 고급 사용자용.
scoop install yt-dlpchoco install yt-dlp독립형 실행 파일을 직접 다운로드합니다.
C:\yt-dlp\, 다운로드한 yt-dlp.exe를 그 안으로 이동합니다.
C:\yt-dlp를 입력한 후 모든 대화 상자에서 확인을 클릭합니다.Homebrew는 macOS의 표준 패키지 관리자입니다. Python과 FFmpeg를 포함한 모든 종속성을 자동으로 해결합니다.
brew install yt-dlp또는 MacPorts 패키지 관리자로 yt-dlp를 설치할 수 있습니다.
sudo port install yt-dlp컴파일된 바이너리를 로컬 실행 경로에 직접 다운로드합니다.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpPython의 pip 관리자를 사용하면 비디오 추출기 스크립트의 최신 업데이트를 직접 받을 수 있습니다.
python3 -m pip install -U yt-dlpLinux 배포판 패키지 관리자로 yt-dlp를 설치합니다.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlp독립형 Linux 바이너리를 로컬 실행 가능 경로에 직접 다운로드합니다.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg는 yt-dlp가 내부적으로 사용하는 오픈소스 미디어 라이브러리로, 별도의 고화질 비디오 트랙(1080p, 4K)과 오디오 트랙을 병합하거나 오디오를 MP3로 추출합니다. FFmpeg 없이는 yt-dlp가 내장 오디오가 있는 720p 이하의 스트림만 다운로드합니다.
winget으로 한 줄 명령어로 FFmpeg 설치:
winget install Gyan.FFmpeg또는 Gyan.dev에서 빌드를 다운로드하고 압축을 푼 다음 bin 디렉터리를 PATH 환경 변수에 추가합니다.
Homebrew를 사용하면 자동으로 설치됩니다. 수동 설치:
brew install ffmpeg시스템 패키지 관리자로 설치:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno는 최신 JavaScript 런타임입니다. yt-dlp는 Deno를 사용하여 YouTube의 JavaScript 기반 시그니처 알고리즘을 실행합니다. Deno를 설치하면 다운로드 속도를 최대로 유지할 수 있습니다.
winget으로 한 줄 명령어로 Deno 설치:
winget install DenoLand.Deno또는 Scoop 사용: scoop install deno
Homebrew로 Deno 설치:
brew install deno공식 셸 스크립트로 Deno 설치:
curl -fsSL https://deno.land/install.sh | sh이 스크립트를 실행하기 전에 unzip과 curl이 설치되어 있는지 확인하세요.
설치 후 터미널(PowerShell, 명령 프롬프트 또는 Terminal.app)을 열고 버전 확인 명령어를 실행하여 모든 것이 정상 작동하는지 확인합니다.
터미널에서 버전 확인 명령어를 실행:
yt-dlp --version성공적으로 설치되면 다음과 같은 릴리스 날짜 버전 번호가 출력됩니다:
2026.06.18"명령을 찾을 수 없습니다"가 표시되면 터미널을 재시작하거나 yt-dlp가 포함된 폴더가 시스템 환경 PATH에 올바르게 추가되었는지 확인하세요.
문제가 발생하셨나요? Windows, macOS, Linux에서 가장 흔한 yt-dlp 오류의 해결 방법입니다.
yt-dlp가 시스템 PATH에 없습니다. winget, Homebrew 또는 pip로 설치한 경우 터미널을 닫고 다시 열어주세요 — PATH는 새 세션에서만 업데이트됩니다.
yt-dlp.exe를 수동으로 다운로드한 경우 해당 폴더를 PATH 환경 변수에 추가해야 합니다. 위의 자세한 PATH 설정 단계를 참조하세요.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp 또는 brew upgrade yt-dlp).
yt-dlp -U)을 사용 중인지 확인하세요.
yt-dlp.exe는 PyInstaller를 사용하여 빌드되며, Python 인터프리터를 단일 실행 파일로 번들합니다. 일부 맬웨어도 동일한 패키징 기술을 사용하기 때문에 바이러스 백신 소프트웨어가 PyInstaller 번들을 종종 플래그하지만, yt-dlp 자체는 완전히 안전합니다.
winget install yt-dlp로 설치하세요(Microsoft 인증 패키지는 플래그되지 않습니다).
YouTube 및 기타 동영상 플랫폼은 스트리밍 프로토콜을 자주 업데이트하며, 이로 인해 이전 버전의 yt-dlp가 작동하지 않을 수 있습니다. 추출 오류를 자동으로 해결하려면 로컬 설치를 최신 상태로 유지하세요.
바이너리를 직접 다운로드했거나 pip로 설치한 경우 터미널에서 내장 업데이트 명령어를 실행:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
터미널에서 이 기본 명령어로 시작하세요:
| 목표 | 명령어 | 작업 |
|---|---|---|
| 동영상 다운로드 (최고 화질) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| MP3 오디오 추출 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
네, yt-dlp는 안전합니다. Unlicense 라이선스의 100% 오픈소스 프로젝트로, GitHub에서 100,000개 이상의 스타와 수백 명의 활발한 기여자가 있습니다. 모든 코드가 공개 감사 가능합니다.
winget으로 설치하면 이를 피할 수 있습니다.로컬에서 실행 파일을 실행하고 싶지 않다면, 저희 온라인 콘솔 서버에서 yt-dlp를 실행 — 기기에 아무것도 설치되지 않습니다.
100K+ ⭐
GitHub 오픈소스
서버에서 직접 yt-dlp 명령어를 실행합니다. 웹 UI로 재생목록 다운로드, 스트림 녹화, 오디오 즉시 추출이 가능합니다.