재생목록 내려받기 — yt-dlp 명령어 생성기

재생목록 전체를 위한 yt-dlp 명령어를 만듭니다: 번호가 붙고, 이어서 받을 수 있고, 항목 하나가 깨져도 전부 멈추지 않게요.

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

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

만들어진 명령어

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --yes-playlist -I 1-10 --download-archive archive.txt -o '%(playlist_index)02d - %(title)s.%(ext)s' -i 'https://www.youtube.com/playlist?list=PLxxxxxxxx'

기본

무엇을 원하나요

영상 오디오만

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

영상과 화질

최대 화질 -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 파일을 쓰는 것만 빼고 전부 수행합니다.

초기화

여기서 중요한 옵션

재생목록 처리 URL이 영상과 재생목록에 동시에 속할 때 어떻게 할지 정합니다.
어떤 항목 -I 범위와 목록 모두 됩니다. 예를 들어 1-10,15, 또는 끝에서부터 하나씩 건너뛰는 -5::2.
파일 이름 템플릿 -o 필드 이름은 %(...)s 안에 씁니다. 슬래시는 폴더를 만듭니다.
기록 파일 --download-archive 이미 내려받은 항목을 적어 두어 다시 실행할 때 건너뜁니다. 채널을 계속 동기화하는 방법이 바로 이것입니다.

정말 중요한 두 가지 옵션

기록 파일은 끝난 항목을 하나하나 적어 두므로, 같은 명령어를 다시 실행하면 빠진 것만 내려받습니다. 긴 재생목록에 느린 회선이라면 이것이 "이어서 하기"와 "처음부터 다시"의 차이입니다.

다른 하나는 오류가 나도 계속입니다. 재생목록은 시간이 지나며 삭제된, 비공개인, 지역 차단된 항목을 쌓아 가고, 이 옵션이 없으면 그런 첫 항목에서 실행 전체가 중단됩니다. 번호 템플릿은 파일을 재생목록 순서대로 유지합니다.

자주 묻는 질문

› 재생목록의 일부만 받으려면?

항목 선택자를 쓰세요: 앞의 열 개면 1-10, 섞으려면 1,3,7-10, 끝에서부터 하나씩 건너뛰려면 -5::2.

› 중단된 재생목록 내려받기를 이어서 하려면?

기록 파일을 쓰세요. 끝난 항목을 하나하나 적어 두므로 같은 명령어를 다시 실행하면 빠진 것만 받습니다.

› 영상 하나가 실패하면 전부 멈춥니다.

오류가 나도 계속을 켜세요. 삭제된, 비공개인, 지역 차단된 항목은 실행 전체를 중단시키는 대신 건너뛰어집니다.

› 파일 이름에 재생목록 순서를 유지하려면?

템플릿에 재생목록 번호를 넣으세요: %(playlist_index)02d - %(title)s.%(ext)s. 02d는 두 자리로 0을 채워 파일이 올바르게 정렬되게 합니다.