가장 일반적인 yt-dlp 명령어와 옵션에 대한 빠른 참조 가이드.
yt-dlp는 오픈소스 명령줄 도구이자 youtube-dl의 적극적으로 유지보수되는 포크(더 빠른 버그 수정과 1700개 이상의 사이트 지원)로, 동영상, 오디오, 재생목록 다운로드에 사용됩니다.
이 치트시트는 1080p/4K 동영상 다운로드, MP3 오디오 추출, 봇 감지 우회, 자막 삽입에 관한 일반적인 명령어를 다룹니다.
처음 사용하시나요? 종합 yt-dlp 다운로드 및 설치 가이드, 또는 아래 예시를 직접 온라인 콘솔 설정 없이.
나만의 명령어를 직접 만들고 싶으신가요? 대화형 yt-dlp 명령어 생성기 — 옵션을 선택하고 정확한 명령어를 가져와 보세요.
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 최고 화질의 동영상을 다운로드합니다(기본 동작). | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | 사용자 정의 출력 경로와 파일명 템플릿으로 동영상을 저장합니다. | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | 대역폭 제한을 우회하기 위해 다운로드 속도를 제한합니다(예: 50K, 10M). | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 출력 파일명에 업로드 날짜와 고유 동영상 ID를 삽입하여 파일 충돌을 방지합니다. |
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | 사용 가능한 모든 해상도, 크기, 코덱, 형식을 나열합니다. | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 특정 형식 코드를 선택하여 다운로드합니다(먼저 -F로 코드 확인). | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 1080p 이하의 최고 화질을 다운로드합니다. 동일한 높이 필터가 1440p(2K)와 2160p(4K)에도 작동합니다. | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | 병합된 MP4 형식으로 최고 화질을 강제 다운로드합니다. | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | 동영상을 다운로드하고 표준 MP4로 재인코딩합니다(플랫폼이 WebM 같은 비표준 컨테이너를 사용하는 경우 유용). |
-f bestvideo+bestaudio와 --merge-output-format mp4를 결합하여 최대 기기 호환성과 최고 화질을 얻습니다. ytdlp.online에서는 ffmpeg 병합이 서버에서 자동 처리됩니다.
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | 오디오 트랙만 추출합니다(최적 기본 형식 자동 감지). | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | 오디오를 다운로드하고 MP3 형식으로 변환합니다. | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | 오디오를 다운로드하고 최고 품질 MP3(VBR 0 / 320kbps 동등)로 추출합니다. | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | MP3를 다운로드하고 원본 동영상 설명, 태그, 썸네일 커버 아트를 삽입합니다. |
--embed-thumbnail --embed-metadata를 추가하면 앨범 아트와 곡 태그가 자동으로 포함됩니다 — iTunes나 Spotify 로컬 파일 같은 음악 라이브러리 앱에 적합합니다.
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 재생목록 링크의 모든 동영상을 강제 다운로드합니다. | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | URL의 단일 동영상만 다운로드하고 속한 재생목록은 무시합니다. | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 재생목록의 특정 인덱스 범위를 다운로드합니다 (예: 1-5, 1,3,5). |
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 모든 수동 업로드 자막과 자동 생성 자막을 나열합니다. | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 자동 생성된 자막 파일만 추출하고 저장하며, 동영상 다운로드는 건너뜁니다. | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 동영상을 다운로드하고 병합된 MP4 파일에 소프트 자막으로 자동 삽입합니다. | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 특정 언어의 수동 업로드 자막을 다운로드합니다(예: en, zh-Hans, ja). 먼저 --list-subs로 사용 가능한 언어를 확인하세요. |
--sub-langs all로 모든 사용 가능한 언어의 자막을 다운로드하거나 --sub-langs "en,zh-Hans"로 여러 언어를 한 번에 가져올 수 있습니다. 전체 자막 참조는 yt-dlp 도움말 페이지.
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 브라우저(예: chrome, firefox)에서 쿠키를 로드하여 로그인 확인이나 봇 차단 검증을 우회합니다. |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 브라우저 TLS 클라이언트 특성을 위장(curl-cffi 필요)하여 Cloudflare와 YouTube 봇 감지 차단을 우회합니다. | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | YouTube 플레이어 클라이언트의 특정 조합을 강제하여 "봇이 아닌지 확인하려면 로그인" 오류를 우회합니다. | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | HTTP, HTTPS 또는 SOCKS 프록시를 통해 yt-dlp 트래픽을 라우팅 — 지역 차단된 콘텐츠에 유용합니다. | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 지역 콘텐츠 제한을 우회하기 위해 지리적 위치 국가 코드(예: US, GB, JP)를 위장합니다. |
| 명령어 | 설명 | 작업 |
|---|---|---|
| yt-dlp -a urls.txt | 텍스트 파일에 줄별로 나열된 모든 동영상 URL을 일괄 다운로드합니다. |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | 내부 챕터를 기반으로 동영상을 자동으로 별도의 트랙/파일로 분할합니다. | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | 외부 멀티스레드 다운로더(Aria2)를 사용하여 다운로드 속도를 크게 향상시킵니다. | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | IP 차단을 방지하기 위해 다운로드 사이에 랜덤 지연(5~15초)을 강제합니다. | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 전체 동영상 대신 특정 클립 또는 시간 범위(예: 1m0s~2m30s)를 다운로드합니다. | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | archive.txt에서 다운로드 기록을 추적하고 이전에 다운로드한 동영상을 자동 건너뜁니다. |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
winget install yt-dlp를 실행합니다. Scoop, Chocolatey, pip 또는 GitHub에서 독립형 yt-dlp.exe를 직접 다운로드할 수도 있습니다.