Twitch용 yt-dlp 명령어 생성기

yt-dlp --merge-output-format mp4 -o '%(uploader)s - %(title)s.%(ext)s' -N 4 --live-from-start https://www.twitch.tv/videos/1234567890

기본

무엇을 원하나요

영상 오디오만

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

영상과 화질

최대 화질 -f 사용 가능한 최고 화질 4K (2160p) 2K (1440p) 1080p 720p 480p 360p

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

Container --merge-output-format ffmpeg 필요 원본 그대로 MP4 (호환성이 가장 좋음) MKV (무엇이든 담김) WebM MOV

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

고급 옵션 (3)

직접 쓰는 format selector -f

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

remux 대상 --remux-video ffmpeg 필요 사용 안 함 MP4 (호환성이 가장 좋음) MKV (무엇이든 담김) WebM MOV

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

재인코딩 대상 --recode-video ffmpeg 필요 사용 안 함 MP4 (호환성이 가장 좋음) MKV (무엇이든 담김) WebM

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

오디오

오디오 형식 --audio-format ffmpeg 필요 MP3 M4A (AAC) Opus FLAC (무손실) WAV (무손실) Vorbis 사용 가능한 최고 오디오 (변환 없음)

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

오디오 품질 --audio-quality ffmpeg 필요 최고 (VBR) 320 kbps 256 kbps 192 kbps 128 kbps

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

자막

자막 사용 안 함 영상에 삽입 .srt 파일로 저장 삽입하고 파일로도 저장

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

자막 언어 --sub-langs

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

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

재생목록과 채널

재생목록 처리 yt-dlp가 판단하게 이 영상만 재생목록 전체

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

제목 제목 + ID 번호가 붙은 재생목록 업로더 / 날짜 - 제목

필드 이름은 %(...)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 사용 안 함 Chrome Edge Safari Firefox

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

로그인과 cookies

브라우저에서 cookies 읽기 --cookies-from-browser 사용 안 함 Chrome Firefox Edge Brave Safari Chromium Opera Vivaldi

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

고급 옵션 (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 파일을 쓰는 것만 빼고 전부 수행합니다.