yt-dlp란? 공식 다운로드와 기본 사용법, 주의할 점

yt-dlp는 지원하는 웹사이트의 영상이나 음성을 내 컴퓨터에 파일로 저장하는 무료 오픈소스 프로그램입니다. 영상 주소를 명령어 창에 입력해 사용하며 화질 선택·자막 확인·음성 추출 같은 작업도 할 수 있습니다. 다만 프로그램을 무료로 쓸 수 있다는 것과 다른 사람이 올린 영상을 자유롭게 저장·재사용할 수 있다는 것은 별개입니다.

yt-dlp 공식 GitHub 저장소는 이 도구를 youtube-dl에서 갈라져 나온 명령줄 오디오·비디오 다운로드 도구로 소개합니다. 여기서 명령줄은 버튼이 많은 앱 화면 대신 명령 프롬프트(CMD) 같은 창에 짧은 명령을 입력하는 방식입니다. 아래 내용은 공식 저장소·설치 문서와 2026년 11월 9일 확인한 최신 릴리스를 기준으로 정리했습니다.

yt-dlp가 필요한 상황은 무엇인가요?

예를 들어 자신이 제작한 영상을 허용된 경로에서 보관하거나, 다운로드 권한이 명시된 공개 자료를 오프라인 편집용 파일로 준비할 때 쓸 수 있습니다. 브라우저에서 영상을 재생하는 일과 영상 파일을 컴퓨터에 저장하는 일은 다릅니다. yt-dlp는 저장할 수 있도록 허용된 자료의 주소를 받아 해당 사이트가 제공하는 형식을 찾아 파일로 내려받는 도구입니다.

• 화질·형식 확인: -F 명령으로 제공되는 영상·음성 형식 목록을 봅니다.
• 자막 확인: --list-subs로 제공되는 자막을 살펴봅니다. 자막이 없는 영상에서 자막을 새로 만드는 기능은 아닙니다.
• 음성만 추출: -x로 허용된 영상에서 오디오 파일을 만들 수 있으며 이 작업에는 FFmpeg가 필요합니다.
• 여러 주소 관리: 공식 문서는 재생목록과 다양한 출력 파일명·폴더 옵션도 안내합니다.

영상과 음성이 따로 내려오는 이유

웹에서 보이는 영상은 하나처럼 느껴지지만, 서비스가 화면 데이터와 소리 데이터를 별도 형식으로 제공하는 경우가 있습니다. 이때 yt-dlp는 이용 가능한 형식을 살펴보고 필요한 데이터를 받습니다. 두 데이터를 하나의 재생 파일로 합칠 때는 FFmpeg라는 별도 미디어 처리 도구가 쓰입니다. FFmpeg를 설치하지 않았다면 어떤 형식은 합치거나 변환할 수 없습니다.

yt-dlp 자체와 FFmpeg의 역할을 나누어 이해하면 설치 중 생기는 문제도 찾기 쉽습니다. 주소를 분석해 받는 단계와 받은 미디어를 합치거나 변환하는 단계에서 필요한 도구가 다를 수 있습니다.

설치 전에 알아둘 환경과 준비물

공식 최신 릴리스 페이지에서 Windows용 yt-dlp.exe를 받을 수 있습니다. 2026년 11월 9일 이 링크가 연결된 릴리스는 2026.10.26이며 공식 릴리스 안내에 따르면 Windows 실행 파일은 Windows 10 이상용입니다. 이 독립 실행 파일을 쓰면 Python을 별도로 설치할 필요가 없습니다. macOS용 실행 파일은 macOS 10.15 이상, Python 패키지로 설치하는 경로는 Python 3.11 이상이 필요합니다.

공식 문서는 FFmpeg·ffprobe를 미디어 병합과 후처리에 강하게 권장합니다. 전체 YouTube 지원에는 yt-dlp-ejs와 지원되는 JavaScript 실행 환경이 필요합니다. 공식 Windows 실행 파일에는 EJS 스크립트가 포함되지만 JavaScript 실행 환경은 별도로 준비해야 합니다. 공식 EJS 안내는 Deno 2.3 이상을 권장합니다. Node.js 22 이상도 옵션으로 설명합니다. 아래 Windows 안내에서는 영상 병합과 MP3 추출까지 따라 할 수 있도록 FFmpeg와 Deno를 함께 준비합니다.

공식 문서에 일반적인 최소 RAM·GPU·VRAM 수치는 제시되지 않습니다. AI 영상 생성처럼 고성능 그래픽카드가 꼭 필요하다고 볼 근거는 없습니다. 실제 저장 공간은 내려받는 파일의 크기와 수에 따라 달라집니다.

Windows 10·11 간단 설치: CMD에서 세 줄 입력하기

처음 사용한다면 WinGet으로 필요한 프로그램을 설치하는 방법이 간단합니다. WinGet은 프로그램 이름을 입력하면 내려받아 설치해 주는 Windows 도구입니다. 아래 명령은 명령 프롬프트(CMD) 기준이며 한 줄씩 입력하고 Enter를 누르면 됩니다.

1. CMD를 엽니다. 키보드에서 Win + R을 누르고 cmd를 입력한 뒤 Enter를 누르세요.
2. WinGet이 있는지 확인합니다. 아래 명령을 입력하고 Enter를 누르세요. 버전 번호가 나오면 다음 단계로 갑니다.

winget --version

winget을 찾을 수 없다는 메시지가 나오면 Microsoft Store에서 앱 설치 관리자(App Installer)를 설치·업데이트한 뒤 CMD를 새로 여세요. WinGet은 Windows 10 1809 이상에서 지원됩니다. Microsoft의 WinGet 안내

3. 다음 세 줄을 차례로 실행합니다. 첫 줄 설치가 끝나면 둘째 줄, 둘째 줄이 끝나면 셋째 줄을 입력하세요. 설치 중 안내가 나타나면 프로그램 이름과 출처·동의 내용을 확인하고 진행합니다.

winget install --id yt-dlp.yt-dlp -e --source winget
winget install --id Gyan.FFmpeg -e --source winget
winget install --id DenoLand.Deno -e --source winget

• yt-dlp: 영상 주소를 읽고 파일을 내려받는 프로그램입니다.
• FFmpeg: 영상과 소리를 합치거나 MP3로 바꾸는 도구입니다. FFprobe도 함께 준비됩니다.
• Deno: yt-dlp가 YouTube 영상을 처리할 때 쓰는 JavaScript 실행 도구입니다. 코드를 직접 작성할 필요는 없습니다.

4. CMD를 닫았다가 다시 엽니다. 새로 설치한 명령을 인식하도록 창을 다시 여세요. 아래 명령을 한 줄씩 실행하세요.

yt-dlp --version
ffmpeg -version
ffprobe -version
deno --version

각 프로그램의 버전 정보가 나오면 명령을 찾을 수 있는 상태입니다. yt-dlp의 YouTube 지원에 권장되는 Deno는 2.3 이상입니다. 이 확인은 설치된 프로그램을 찾는 단계이며 특정 영상의 다운로드 성공까지 보장하지는 않습니다.

설치 근거: yt-dlp 공식 설치 안내 · Gyan FFmpeg 빌드 안내 · Deno 공식 설치 안내. WinGet은 지정한 패키지를 설치하는 방법입니다. 이 글에서는 독자의 PC에 실제로 설치하지 않았습니다.

실행 파일을 직접 받아 사용하는 방법도 있습니다

공식 GitHub 최신 릴리스가 새 탭에서 열립니다.

다운로드한 파일을 저장할 폴더 정하기

WinGet으로 설치했다면 CMD에서 아래 두 줄을 한 줄씩 입력하고 Enter를 누르세요.

mkdir "%USERPROFILE%\Downloads\yt-dlp"
cd /d "%USERPROFILE%\Downloads\yt-dlp"

첫 줄은 내 사용자 폴더의 다운로드 → yt-dlp 폴더를 만듭니다. 둘째 줄은 CMD의 작업 위치를 그 폴더로 옮깁니다. %USERPROFILE%은 Windows가 현재 사용자 폴더로 바꿔 주는 표현이므로 그대로 입력하세요. 이미 폴더가 있다는 메시지가 나오면 둘째 줄부터 진행하면 됩니다. 직접 만든 다른 폴더를 사용해도 됩니다.

이후 예시에서 받는 파일은 현재 CMD가 열려 있는 폴더에 저장됩니다. CMD를 새로 열었다면 다운로드 전에 둘째 줄을 다시 실행하세요. 실행 파일을 직접 받은 방식이라면 그 파일이 있는 폴더에서 CMD를 열고 진행하면 됩니다.

자주 쓰는 yt-dlp 명령어 한 번에 보기

YouTube 영상 다운로드: 주소를 넣고 Enter

아래는 본인 영상 또는 다운로드 허가를 확인한 영상 한 개를 저장하는 기본 순서입니다.

1. 영상 페이지 주소를 복사합니다. 브라우저 주소창의 URL을 복사하세요.
2. 아래 명령의 따옴표 안을 복사한 주소로 바꿉니다. 여기에-영상-주소라는 글자를 지우고 실제 주소를 넣으세요. 따옴표는 남겨 둡니다.

yt-dlp --no-playlist "여기에-영상-주소"

3. Enter를 누르고 기다립니다. 다운로드가 끝나도 영상과 소리를 합치는 작업이 이어질 수 있습니다. 100%가 보였다고 바로 창을 닫지 마세요.
4. 오류 없이 작업이 끝나 입력 대기 상태로 돌아오면 파일을 확인합니다. 아래 명령을 입력하고 Enter를 누르면 저장 폴더가 탐색기로 열립니다.

explorer .

--no-playlist는 재생목록이 연결된 영상 주소에서도 해당 영상 한 개를 받는 옵션입니다. 파일 이름에는 보통 영상 제목이 들어갑니다. 기본 명령은 확장자를 MP4로 고정하지 않으므로 제공 형식에 따라 WebM 등으로 저장될 수도 있습니다.

MP4 파일로 받고 싶다면

같은 순서로 아래 명령을 실행하세요. 공식 mp4 프리셋을 사용하며 FFmpeg가 필요합니다.

yt-dlp --no-playlist -t mp4 "여기에-영상-주소"

변환·병합까지 끝나고 입력 대기 상태로 돌아온 뒤 저장 폴더의 .mp4 파일을 확인합니다. 제공 코덱과 형식에 따라 처리 결과가 달라질 수 있습니다. 형식이 맞지 않아 오류가 나면 확장자만 바꾸어 해결하려 하지 마세요.

영상에서 오디오만 추출해 MP3로 저장하기

1. 저장 폴더에서 CMD를 엽니다. 위 다운로드 폴더를 사용한다면 cd /d "%USERPROFILE%\Downloads\yt-dlp"를 먼저 실행합니다.
2. 아래 명령의 따옴표 안을 영상 주소로 바꿉니다. 이 명령은 인터넷 주소에서 오디오를 받아 MP3로 변환하는 예시입니다.

yt-dlp --no-playlist -x --audio-format mp3 "여기에-영상-주소"

3. Enter를 누르고 변환이 끝날 때까지 기다립니다. 내려받기 뒤 MP3 추출 단계가 이어지므로 중간에 창을 닫지 마세요.
4. 오류 없이 끝나면 저장 폴더에서 .mp3 파일을 확인합니다. 필요하면 explorer .로 현재 폴더를 열 수 있습니다.

-x는 오디오만 추출하고 --audio-format mp3는 결과를 MP3로 만들라는 뜻입니다. FFmpeg·FFprobe가 필요합니다. MP3로 바꾼다고 원본보다 음질이 좋아지지는 않습니다.

명령을 입력했는데 안 될 때 먼저 확인할 것

• “명령을 찾을 수 없다”는 메시지: 설치를 마친 뒤 CMD를 닫았다가 다시 열고 버전 명령을 확인하세요. 직접 받은 yt-dlp.exe는 파일이 있는 폴더에서 실행해야 합니다.
• FFmpeg를 찾지 못하거나 MP3 변환이 실패: ffmpeg -version과 ffprobe -version이 실행되는지 확인하세요. 다운로드와 변환은 별도 단계입니다.
• JavaScript 실행 환경 관련 메시지: deno --version을 확인하고 공식 EJS 안내의 지원 조건과 대조하세요.
• 파일이 없거나 .part만 남아 있음: 오류 메시지와 저장 폴더를 확인하세요. .part는 다운로드 중간 파일일 수 있으므로 완료 파일로 생각하면 안 됩니다.

WinGet으로 설치한 yt-dlp 업데이트는 아래 명령으로 확인합니다. 직접 받은 실행 파일은 그 폴더에서 yt-dlp.exe -U를 사용합니다.

winget upgrade --id yt-dlp.yt-dlp -e --source winget

화질별 형식을 더 살펴보고 싶다면 yt-dlp -F "여기에-영상-주소"를 사용할 수 있습니다. 기본 다운로드를 하기 전에 반드시 거쳐야 하는 단계는 아닙니다. 다운로드·MP3 추출·MP4 프리셋의 옵션은 공식 명령어 안내를 기준으로 정리했습니다.

사용 전 알아둘 한계와 권리

yt-dlp는 명령어를 입력하는 도구이므로 버튼 중심 앱을 기대했다면 처음에는 낯설 수 있습니다. 사이트 구조가 바뀌면 일시적으로 작동하지 않을 수 있고 지원 사이트 목록에 있어도 모든 영상·형식·자막을 받는다고 보장되지 않습니다. 문제를 확인할 때는 공식 FAQ와 최신 릴리스 변경 사항을 먼저 살펴보는 편이 좋습니다.

프로그램 사용 허가와 영상 이용 허가는 따로 판단해야 합니다. 특히 YouTube 이용약관은 서비스가 명시적으로 허용한 경우나 YouTube와 해당되는 권리자의 사전 서면 허가를 받은 경우에 콘텐츠 다운로드·사용을 허용한다고 안내합니다. YouTube 공식 도움말에 따르면 자신이 업로드한 영상은 YouTube Studio에서 내려받는 방법도 있습니다. 그 공식 경로가 목적에 맞는지 먼저 확인하는 편이 간단합니다. 이 글은 타인의 영상 무단 저장·재배포나 접근 제한 우회 방법을 안내하지 않습니다.

무료·상업적 이용과 라이선스

yt-dlp의 핵심 코드는 Unlicense로 공개되어 개인·상업적 목적의 사용, 수정, 재배포가 가능합니다. 다만 공식 라이선스 파일과 README는 배포 파일에 포함된 제3자 구성 요소의 조건을 따로 설명합니다. 특히 공식 Windows 실행 파일은 PyInstaller가 묶은 GPLv3 이상 코드의 영향으로 결합 배포물에 GPLv3 이상 조건이 적용된다고 안내합니다. 실행 파일을 제품에 포함해 재배포한다면 그 조건을 따져야 합니다.

이는 yt-dlp 프로그램의 라이선스 설명입니다. 내려받은 영상·음원·자막에 대한 저작권이나 플랫폼의 이용 조건까지 허가해 주지는 않습니다. 개인 보관, 편집, 업무용 재사용 여부는 해당 자료의 권리와 서비스 조건에 따라 달라집니다.

이 글은 AI의 도움으로 작성했으며, yt-dlp 공식 저장소·설치 문서·릴리스·라이선스와 YouTube 공식 안내를 2026년 11월 9일 확인했습니다. 그림은 AI로 제작한 개념도입니다. Windows CMD 설치·영상 저장·MP3 추출 안내는 2026년 11월 6일 공식 문서와 대조해 보완했으며, 실제 설치나 영상 다운로드를 수행한 기록은 아닙니다.