본문으로 건너뛰기
yt-dlp

Pinterest용 yt-dlp 명령어 생성기

Pinterest의 영상 핀용 yt-dlp 명령어를 만듭니다.

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

만들어진 명령어

yt-dlp --merge-output-format mp4 --no-playlist https://www.pinterest.com/pin/123456789/
기본

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

영상과 화질

높이 상한을 정합니다. 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)
초기화

Pinterest에서 주의할 점

영상이 들어 있는 개별 핀 주소는 그대로 동작하고 특별한 옵션이 필요하지 않습니다.

보드 전체 지원은 제한적이고 Pinterest 자체 마크업에 따라 바뀝니다. 핀 주소를 하나씩 넘기는 편이 느리지만 훨씬 확실합니다.

모든 핀이 영상인 것은 아닙니다 —— 대부분은 이미지입니다 —— 그리고 보드를 통째로 yt-dlp에 넘기면 돌아오는 것은 대개 이미지 항목입니다. 이 페이지의 대상은 영상 핀입니다. 핀을 열고 핀 페이지 자체의 주소를 복사하세요(브라우저가 보여 주는 i.pinimg.com 이미지 주소가 아니라). 그 뒤의 미디어가 영상인지는 yt-dlp에게 판단하게 하세요. yt-dlp가 이미지라고 답하면 그 핀에는 정말 영상이 없는 것이고, 이미지 핀을 영상 핀으로 바꾸는 옵션은 존재하지 않습니다.

Pinterest는 일부 콘텐츠를 로그인 너머에 두고, 대부분의 플랫폼과 달리 이 관문이 내려받기만이 아니라 둘러보기에도 걸립니다. cookies가 없으면 보드는 첫 페이지에서 멈추고 일부 카테고리의 영상 핀은 아무것도 돌려주지 않습니다. 여기서 확실한 길은 브라우저 cookies 옵션입니다. 평소처럼 브라우저에서 로그인하고 cookies 파일을 yt-dlp에 넘기면 페이지 넘기기가 로그인 중인 계정을 따라갑니다. 로그아웃된 세션의 cookies는 아무 소용이 없습니다.

긴 보드나 계속 좇아갈 가치가 있는 프로필이라면 cookies에 기록 파일을 더해 같은 명령어를 주기적으로 돌리세요. 기록 파일은 이미 가져온 핀을 모두 기록하므로 다음 실행은 지난번 이후에 핀한 것만 옮겨 옵니다. 출력의 모양은 시간이 지나며 바뀐다고 생각하세요 —— Pinterest는 yt-dlp가 지원하는 어느 플랫폼보다 자주 마크업을 다시 만듭니다. 보드가 갑자기 거대한 갤러리 하나로 내려받히거나 제목을 잃으면, 대개 yt-dlp 갱신이 해법 전부입니다. 갱신해도 사라지지 않을 때에만 보고하세요.

출력 이름은 핀이 아니라 보드 기준으로 붙이세요. 핀 제목은 겹칩니다 —— "제목 없음", 보드 이름, 혹은 아무것도 없음 —— 그래서 단순한 제목 템플릿으로는 한 번의 실행 안에서 이름이 부딪힙니다. 여기 기본 템플릿은 고유한 id를 유지하고, 재생목록 번호를 더하면 보드 내려받기가 보드 순서를 유지합니다. 보드 안의 섹션은 하위 재생목록으로 도착하는데, 기록 파일이 그 모든 층위를 추적하므로 다음 실행에서는 아무것도 다시 내려받지 않습니다.

자주 묻는 질문

yt-dlp가 Pinterest 영상을 받을 수 있나요?
가능합니다. 영상이 들어 있는 핀 주소는 그대로 동작합니다.
보드 전체를 받을 수 있나요?
보드 지원은 제한적이고 자주 바뀝니다. 핀 주소를 하나씩 넘기는 편이 확실합니다.