yt-dlp 명령어 생성기

필요한 옵션을 고르면 정확한 yt-dlp 명령어가 나옵니다. 사용하는 shell에 맞게 따옴표까지 제대로 붙은 상태로요. flag를 외울 필요도, 여기에 무엇을 설치할 필요도 없고, 아무것도 업로드되지 않습니다.

영상, 재생목록 또는 채널 URL

선택 사항입니다. 비워 두면 명령어가 URL 로 끝나므로 나중에 직접 채우면 됩니다.

만들어진 명령어

yt-dlp URL

기본

무엇을 원하나요

영상 오디오만

오디오만 고르면 소리 트랙만 뽑고 영상은 버립니다.

영상과 화질

최대 화질 -f

높이 상한을 정합니다. yt-dlp는 그 상한 이하에서 가장 좋은 트랙을 고릅니다.

Container --merge-output-format ffmpeg 필요

분리된 영상과 오디오 트랙을 병합해 담을 파일 형식입니다.

고급 옵션 (3)

직접 쓰는 format selector -f

화질 선택을 대체합니다. format 문법을 이미 아는 분을 위한 항목입니다.

remux 대상 --remux-video ffmpeg 필요

재인코딩 없이 다시 포장만 합니다. 빠르고 손실이 없습니다.

재인코딩 대상 --recode-video ffmpeg 필요

영상을 다시 인코딩합니다. 느리고 손실이 있습니다 —— remux로 안 될 때만 쓰세요.

오디오

오디오 형식 --audio-format ffmpeg 필요

오디오를 변환할 대상 형식입니다.

오디오 품질 --audio-quality ffmpeg 필요

VBR은 용량 대비 품질이 가장 좋고, 고정 bitrate는 용량을 예상하기 쉽습니다.

자막

삽입은 자막을 영상 안에 넣고, 저장은 옆에 별도의 .srt 파일을 만듭니다.

자막 언어 --sub-langs

쉼표로 구분합니다. 사용 가능한 모든 언어를 원하면 all 이라고 쓰세요.

자동 생성 자막 --write-auto-subs 사람이 만든 자막이 없을 때 기계가 만든 자막도 포함합니다.

재생목록과 채널

재생목록 처리

URL이 영상과 재생목록에 동시에 속할 때 어떻게 할지 정합니다.

어떤 항목 -I

범위와 목록 모두 됩니다. 예를 들어 1-10,15, 또는 끝에서부터 하나씩 건너뛰는 -5::2.

고급 옵션 (1)

기록 파일 --download-archive

이미 내려받은 항목을 적어 두어 다시 실행할 때 건너뜁니다. 채널을 계속 동기화하는 방법이 바로 이것입니다.

구간과 챕터

고급 옵션 (2)

일부 구간만 내려받기 --download-sections ffmpeg 필요

*00:01:30-00:03:00 같은 시간 범위, 또는 챕터 이름입니다. 앞의 별표는 시각이라는 뜻입니다.

챕터별로 나누기 --split-chapters ffmpeg 필요 긴 파일 하나가 아니라 챕터마다 파일 하나를 만듭니다.

메타데이터와 표지

썸네일 삽입 --embed-thumbnail ffmpeg 필요 영상 썸네일을 표지로 씁니다.

메타데이터 삽입 --embed-metadata ffmpeg 필요 제목, 업로더, 날짜를 파일 자체에 기록합니다.

챕터 삽입 --embed-chapters ffmpeg 필요 플레이어에서 건너뛸 수 있는 챕터 표시를 넣습니다.

고급 옵션 (3)

썸네일 파일 저장 --write-thumbnail 표지 이미지를 영상 옆에 저장합니다.

설명 저장 --write-description 설명을 .description 파일에 저장합니다.

메타데이터 JSON 저장 --write-info-json yt-dlp가 그 영상에 대해 아는 모든 것을 .info.json 파일에 저장합니다.

SponsorBlock

구간 제거 --sponsorblock-remove ffmpeg 필요

SponsorBlock 데이터를 바탕으로 커뮤니티가 표시한 구간을 파일에서 잘라냅니다.

고급 옵션 (1)

구간을 챕터로 표시 --sponsorblock-mark

구간은 남기고 표시만 해서 직접 건너뛸 수 있게 합니다.

파일과 폴더

파일 이름 템플릿 -o

필드 이름은 %(...)s 안에 씁니다. 슬래시는 폴더를 만듭니다.

안전한 (ASCII만) 파일 이름 --restrict-filenames 악센트, 공백, 그리고 까다로운 파일 시스템이 거부할 수 있는 문자를 없앱니다.

기존 파일 덮어쓰기 --force-overwrites 이미 있는 파일을 대체합니다.

중단된 내려받기 이어서 -c 멈춘 지점부터 계속합니다.

고급 옵션 (4)

내려받을 폴더 -P

파일을 저장할 위치입니다. 위 템플릿과 조합하면 하위 폴더도 만들 수 있습니다.

Windows에 안전한 이름 --windows-filenames 다른 시스템에서 실행해도 Windows가 받지 않는 문자를 없앱니다.

이름 길이 제한 --trim-filenames

파일 이름의 최대 길이(문자 수)입니다.

절대 덮어쓰지 않기 -w 이미 내려받은 것은 건너뜁니다.

필터

고급 옵션 (5)

이 날짜 이후 업로드 --dateafter

YYYYMMDD, 또는 now-1month 같은 상대 날짜.

이 날짜 이전 업로드 --datebefore

YYYYMMDD, 또는 상대 날짜.

최소 크기 --min-filesize

이보다 작은 것은 건너뜁니다. 5M, 500K 같은 표기를 씁니다.

최대 크기 --max-filesize

이보다 큰 것은 건너뜁니다.

이 개수 후 중단 --max-downloads

멈추기 전까지 내려받을 파일 수입니다.

네트워크

속도 제한 -r

예를 들어 2M 또는 500K. 남은 대역폭을 다른 일에 써야 할 때 유용합니다.

고급 옵션 (5)

동시 fragment 수 -N

조각으로 나뉜 트랙을 빠르게 합니다. 4 정도로 시작하면 무리가 없습니다.

재시도 횟수 -R

실패한 조각을 몇 번 다시 시도할지. infinite 도 쓸 수 있습니다.

Proxy --proxy

HTTP, HTTPS 또는 SOCKS proxy 주소입니다.

지역 제한 우회 --geo-bypass 요청 출처를 위장합니다. 일부 사이트에서는 되지만 전부는 아닙니다.

브라우저로 위장 --impersonate

요청이 실제 브라우저에서 온 것처럼 보이게 합니다. 갑자기 403이 날 때 흔히 쓰는 해법입니다.

로그인과 cookies

브라우저에서 cookies 읽기 --cookies-from-browser

로그인된 세션을 직접 읽습니다. 비공개, 연령 제한, 멤버 전용 콘텐츠에는 필요합니다.

고급 옵션 (1)

cookies 파일 --cookies

브라우저에서 내보낸 Netscape 형식 cookies.txt 파일입니다.

라이브 방송

고급 옵션 (2)

방송 처음부터 녹화 --live-from-start 현재 시점이 아니라 라이브 방송 시작부터 녹화합니다.

방송 시작 대기 --wait-for-video

예정된 방송이 시작될 때까지 계속 확인합니다. MIN-MAX는 확인 간격(초)입니다.

우회 방법

고급 옵션 (3)

User agent --user-agent 구식

구식이며 --add-headers 로 대체되었습니다. 오래된 안내 글이 아직 많이 쓰기 때문에 남겨 두었습니다.

Referer --referer 구식

구식이며 --add-headers 로 대체되었습니다.

extractor 인자 --extractor-args

사이트별 전용 옵션입니다. 예를 들어 youtube:player_client=web.

출력과 디버그

형식 목록만 보기 -F 사용 가능한 형식을 출력하고 내려받지 않은 채 종료합니다.

고급 옵션 (2)

오류가 나도 계속 -i 실패한 항목을 건너뛰고 멈추지 않습니다. 큰 재생목록에서는 반드시 필요합니다.

모의 실행 -s 파일을 쓰는 것만 빼고 전부 수행합니다.

초기화

명령어 생성기가 왜 필요한가

yt-dlp에는 옵션이 수백 개 있고, 정작 유용한 것들은 혼자서 동작하는 경우가 드뭅니다. 1080p를 요청하려면 format selector와 merge container를 함께 써야 하고, 자막 삽입은 말없이 ffmpeg를 요구합니다. 이 페이지는 그런 조합을 미리 처리해 두었기 때문에 명령어가 첫 번에 동작합니다.

여기 있는 모든 옵션은 실제 flag에 대응하고, 그 flag가 옆에 표시됩니다. 옵션 목록 페이지는 특정 yt-dlp 버전을 기준으로 전부 기록해 둡니다. 유료 요금제 뒤에 숨겨 둔 기능은 없습니다.

yt-dlp 명령어 만드는 법

원하는 영상, 재생목록, 채널의 주소를 URL 칸에 붙여넣습니다.
화질, container, 오디오 형식, 자막 등 필요한 것을 고릅니다. 고르는 동안 명령어가 실시간으로 갱신됩니다.
사용하는 shell로 옮겨서 명령어를 복사하고, yt-dlp가 설치된 터미널에서 실행합니다.

자주 묻는 질문

› yt-dlp 명령어 생성기란 무엇인가요?

명령어를 대신 써 주는 폼입니다. 원하는 것을 평범한 말로 고르면 정확한 yt-dlp 명령어 한 줄이 나옵니다. flag 순서도 맞고, 사용하는 shell에 맞는 따옴표까지 붙습니다.

› 이 페이지를 쓰려면 무엇을 설치해야 하나요?

페이지를 쓰는 데는 아무것도 필요 없습니다 —— 글자를 만들어 줄 뿐입니다. 명령어를 실행하려면 yt-dlp가 필요하고, 병합·변환·삽입이 들어가는 것에는 ffmpeg도 필요합니다. 설치 안내에 둘 다 나옵니다.

› 어떤 yt-dlp 옵션을 만들 수 있나요?

대부분의 사람이 필요한 것은 다 있습니다: 형식과 화질, 오디오 추출, 자막, 재생목록, 구간, SponsorBlock, 메타데이터, 파일 이름, 필터, 네트워크 설정, cookies, 라이브 방송, 그리고 흔한 우회 방법. 옵션 목록 페이지에 전부 실려 있습니다.

› 이 명령어가 youtube-dl에서도 되나요?

대부분 됩니다. yt-dlp는 youtube-dl의 옵션 이름을 그대로 이어받았으므로 단순한 명령어는 서로 바꿔 쓸 수 있습니다. --download-sections, --sponsorblock-remove, --impersonate 같은 새 옵션은 yt-dlp에만 있습니다.

› 유료인 부분이 있나요?

없습니다. 모든 옵션, 프리셋, 페이지가 무료입니다. 아무것도 업로드되지 않고, 계정도 없으며, 생성기의 어떤 부분도 유료 요금제용으로 남겨 두지 않았습니다.