무엇을 원하나요
오디오만 고르면 소리 트랙만 뽑고 영상은 버립니다.
yt-dlp 옵션 목록
yt-dlp 2026.07.21 기준으로 작성했습니다. 버전마다 옵션이 추가되거나 이름이 바뀌므로 yt-dlp --version 으로 본인 버전을 확인하세요.
기본
영상과 화질
-f FORMAT
--format
최대 화질
높이 상한을 정합니다. yt-dlp는 그 상한 이하에서 가장 좋은 트랙을 고릅니다.
-f FORMAT
--format
직접 쓰는 format selector
화질 선택을 대체합니다. format 문법을 이미 아는 분을 위한 항목입니다.
예시
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
ffmpeg 필요
Container
분리된 영상과 오디오 트랙을 병합해 담을 파일 형식입니다.
--remux-video FORMAT
ffmpeg 필요
remux 대상
재인코딩 없이 다시 포장만 합니다. 빠르고 손실이 없습니다.
--recode-video FORMAT
ffmpeg 필요
재인코딩 대상
영상을 다시 인코딩합니다. 느리고 손실이 있습니다 —— remux로 안 될 때만 쓰세요.
오디오
--audio-format FORMAT
ffmpeg 필요
오디오 형식
오디오를 변환할 대상 형식입니다.
--audio-quality QUALITY
ffmpeg 필요
오디오 품질
VBR은 용량 대비 품질이 가장 좋고, 고정 bitrate는 용량을 예상하기 쉽습니다.
자막
자막
삽입은 자막을 영상 안에 넣고, 저장은 옆에 별도의 .srt 파일을 만듭니다.
자막 언어
쉼표로 구분합니다. 사용 가능한 모든 언어를 원하면 all 이라고 쓰세요.
예시
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
자동 생성 자막
사람이 만든 자막이 없을 때 기계가 만든 자막도 포함합니다.
재생목록과 채널
재생목록 처리
URL이 영상과 재생목록에 동시에 속할 때 어떻게 할지 정합니다.
-I ITEM_SPEC
--playlist-items
어떤 항목
범위와 목록 모두 됩니다. 예를 들어 1-10,15, 또는 끝에서부터 하나씩 건너뛰는 -5::2.
예시
-I 1:5-I "1,3,7-10"-I "-5::2"
기록 파일
이미 내려받은 항목을 적어 두어 다시 실행할 때 건너뜁니다. 채널을 계속 동기화하는 방법이 바로 이것입니다.
구간과 챕터
--download-sections REGEX
ffmpeg 필요
일부 구간만 내려받기
*00:01:30-00:03:00 같은 시간 범위, 또는 챕터 이름입니다. 앞의 별표는 시각이라는 뜻입니다.
예시
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
ffmpeg 필요
챕터별로 나누기
긴 파일 하나가 아니라 챕터마다 파일 하나를 만듭니다.
메타데이터와 표지
--embed-thumbnail
ffmpeg 필요
썸네일 삽입
영상 썸네일을 표지로 씁니다.
--embed-metadata
ffmpeg 필요
메타데이터 삽입
제목, 업로더, 날짜를 파일 자체에 기록합니다.
--embed-chapters
ffmpeg 필요
챕터 삽입
플레이어에서 건너뛸 수 있는 챕터 표시를 넣습니다.
썸네일 파일 저장
표지 이미지를 영상 옆에 저장합니다.
설명 저장
설명을 .description 파일에 저장합니다.
메타데이터 JSON 저장
yt-dlp가 그 영상에 대해 아는 모든 것을 .info.json 파일에 저장합니다.
SponsorBlock
--sponsorblock-remove CATS
ffmpeg 필요
구간 제거
SponsorBlock 데이터를 바탕으로 커뮤니티가 표시한 구간을 파일에서 잘라냅니다.
구간을 챕터로 표시
구간은 남기고 표시만 해서 직접 건너뛸 수 있게 합니다.
파일과 폴더
-o [TYPES:]TEMPLATE
--output
파일 이름 템플릿
필드 이름은 %(...)s 안에 씁니다. 슬래시는 폴더를 만듭니다.
예시
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
내려받을 폴더
파일을 저장할 위치입니다. 위 템플릿과 조합하면 하위 폴더도 만들 수 있습니다.
안전한 (ASCII만) 파일 이름
악센트, 공백, 그리고 까다로운 파일 시스템이 거부할 수 있는 문자를 없앱니다.
Windows에 안전한 이름
다른 시스템에서 실행해도 Windows가 받지 않는 문자를 없앱니다.
이름 길이 제한
파일 이름의 최대 길이(문자 수)입니다.
기존 파일 덮어쓰기
이미 있는 파일을 대체합니다.
-w
--no-overwrites
절대 덮어쓰지 않기
이미 내려받은 것은 건너뜁니다.
-c
--continue
중단된 내려받기 이어서
멈춘 지점부터 계속합니다.
필터
이 날짜 이후 업로드
YYYYMMDD, 또는 now-1month 같은 상대 날짜.
예시
--dateafter 20240101--dateafter now-1month
이 날짜 이전 업로드
YYYYMMDD, 또는 상대 날짜.
최소 크기
이보다 작은 것은 건너뜁니다. 5M, 500K 같은 표기를 씁니다.
최대 크기
이보다 큰 것은 건너뜁니다.
이 개수 후 중단
멈추기 전까지 내려받을 파일 수입니다.
네트워크
-r RATE
--limit-rate
속도 제한
예를 들어 2M 또는 500K. 남은 대역폭을 다른 일에 써야 할 때 유용합니다.
-N N
--concurrent-fragments
동시 fragment 수
조각으로 나뉜 트랙을 빠르게 합니다. 4 정도로 시작하면 무리가 없습니다.
-R RETRIES
--retries
재시도 횟수
실패한 조각을 몇 번 다시 시도할지. infinite 도 쓸 수 있습니다.
Proxy
HTTP, HTTPS 또는 SOCKS proxy 주소입니다.
지역 제한 우회
요청 출처를 위장합니다. 일부 사이트에서는 되지만 전부는 아닙니다.
브라우저로 위장
요청이 실제 브라우저에서 온 것처럼 보이게 합니다. 갑자기 403이 날 때 흔히 쓰는 해법입니다.
로그인과 cookies
브라우저에서 cookies 읽기
로그인된 세션을 직접 읽습니다. 비공개, 연령 제한, 멤버 전용 콘텐츠에는 필요합니다.
cookies 파일
브라우저에서 내보낸 Netscape 형식 cookies.txt 파일입니다.
라이브 방송
방송 처음부터 녹화
현재 시점이 아니라 라이브 방송 시작부터 녹화합니다.
방송 시작 대기
예정된 방송이 시작될 때까지 계속 확인합니다. MIN-MAX는 확인 간격(초)입니다.
우회 방법
--user-agent UA
구식 — --add-headers
User agent
구식이며 --add-headers 로 대체되었습니다. 오래된 안내 글이 아직 많이 쓰기 때문에 남겨 두었습니다.
--referer URL
구식 — --add-headers
Referer
구식이며 --add-headers 로 대체되었습니다.
extractor 인자
사이트별 전용 옵션입니다. 예를 들어 youtube:player_client=web.
예시
--extractor-args "youtube:player_client=web,android"