본문으로 건너뛰기
yt-dlp

TikTok용 yt-dlp 명령어 생성기

TikTok 영상 하나 또는 크리에이터 프로필 전체에 맞는 yt-dlp 명령어를 만듭니다. 파일 이름도 읽을 수 있는 형태로 유지합니다.

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

만들어진 명령어

yt-dlp --merge-output-format mp4 --no-playlist --embed-metadata -o '%(uploader)s - %(id)s.%(ext)s' https://www.tiktok.com/@user/video/1234567890
기본

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

영상과 화질

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

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

고급 옵션 (3)

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

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

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

오디오

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

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

자막

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

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

재생목록과 채널

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

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

고급 옵션 (1)

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

구간과 챕터
고급 옵션 (2)

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

메타데이터와 표지
고급 옵션 (3)
SponsorBlock

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

고급 옵션 (1)

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

파일과 폴더

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

고급 옵션 (4)

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

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

필터
고급 옵션 (5)

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

YYYYMMDD, 또는 상대 날짜.

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

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

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

네트워크

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

고급 옵션 (5)

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

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

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

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

로그인과 cookies

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

고급 옵션 (1)

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

라이브 방송
고급 옵션 (2)

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

우회 방법
고급 옵션 (3)

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

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

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

출력과 디버그
고급 옵션 (2)
초기화

TikTok에서 주의할 점

TikTok의 제목은 설명 첫 줄이라서 파일 이름이 아주 길고 대개 쓰기 어렵습니다. 여기 프리셋은 업로더와 id로 이름을 붙입니다 —— 정렬도 되고 이름이 겹치지도 않습니다.

워터마크 없는 트랙이 있는지는 영상과 지역에 따라 다릅니다 —— 없다고 단정하기 전에 -F 를 붙여 실제로 무엇이 있는지 확인하세요. 비공개나 팔로워 전용 게시물은 그것을 볼 수 있는 계정의 cookies가 필요합니다.

TikTok는 이제 세로 영상만의 장이 아닙니다. 사진 모드 게시물과 슬라이드쇼도 같은 모양의 URL로 제공되고, yt-dlp는 여러 항목짜리를 재생목록으로 취급합니다 —— 슬라이드 한 장이 한 항목, 붙는 소리는 (있으면) 별개의 오디오 항목으로. 이것은 플랫폼의 구조이지 실패가 아니며, 슬라이드쇼를 한 파일로 되돌려 합치는 옵션은 존재하지 않습니다. "이미지만 내려받는" 것처럼 보이는 명령어는, 실제로는 게시물의 내용을 그대로 내려받은 것입니다.

프로필 URL —— tiktok.com/@handle —— 는 그 계정의 영상을 모두 내려받고, 페이지로 나뉘어 진행되므로 게시물이 많은 크리에이터에서는 긴 실행이 됩니다. 좋아요와 저장 탭은 계정 주인에게만 보이므로, 여기는 로그인된 세션의 cookies가 필요합니다. 재생목록 전체 처리에 기록 파일과 오류가 나도 계속을 결합하세요. 게시물이 많은 계정에는 삭제된 게시물이 하나쯤 있기 마련이고, 그 두 옵션이 없으면 삭제된 하나가 나머지 천 개를 멈춥니다.

TikTok는 공격적으로 속도를 제한합니다. 빠르게 시작해 그 후 기어가듯 느려지는 내려받기, 도중에 403으로 죽는 내려받기는, 대개 망가진 extractor가 아니라 레이트 리밋입니다 —— 속도 제한을 걸고, 동시 fragment 수를 낮추고, 반복 실행 사이에는 간격을 두세요. 로그인된 세션의 cookies는 천장을 상당히 올립니다. 다른 많은 사람이 함께 쓰는 VPN 출구는 제한을 완화하기보다 악화하는 경향이 있습니다. 요청을 보내기 전부터 그 IP는 이미 의심받고 있습니다.

오디오라면, -x 는 어디서나 그렇듯 TikTok의 사운드트랙을 뽑아 내고 영상은 통째로 건너뜁니다. 영상의 "원본 사운드"는 자기 페이지를 가진 별개 항목이라, 남의 게시물에서 들은 곡은 영상 없이 그 사운드 페이지에서 가져올 수 있습니다. 파일 이름은 대부분의 플랫폼보다 여기가 더 중요합니다 —— 설명을 제목 쓰는 순간, 같은 말로 시작하는 두 게시물에서 이름이 부딪힙니다 —— 그래서 이 프리셋은 업로더와 영상 id로 파일을 이름 붙입니다.

자주 묻는 질문

yt-dlp가 워터마크 없이 TikTok을 내려받을 수 있나요?
TikTok이 주는 것을 그대로 받습니다. 워터마크 없는 트랙은 있을 때도 없을 때도 있고, 영상과 지역에 따라 다릅니다 —— 그 주소에 무엇이 있는지는 -F 로 확인하세요.
비공개나 팔로워 전용 TikTok을 받을 수 있나요?
여러분 본인 계정이 볼 수 있을 때만요. --cookies-from-browser 를 써서 yt-dlp가 여러분으로서 요청하게 하세요.
한 크리에이터의 모든 영상을 받으려면?
프로필 주소에 재생목록 전체 모드로 yt-dlp를 실행하고, 기록 파일을 더해 다음 실행에서는 새 것만 받게 하세요.