썸픽 | 영상 하나가 유튜브 썸네일 3안이 됩니다

영상을 올릴 때마다 썸네일 때문에 발이 묶인 적이 있으실 겁니다. 프레임을 하나하나 돌려보며
눈으로 고르고, 포토샵이나 캔바를 열어 글자를 얹고, 확대 화면에서는 멀쩡해 보였는데 막상
피드에서는 글자가 뭉개져 있는 걸 뒤늦게 발견하는 일도 흔합니다. 썸픽은 이 과정을
스크립트 세 개로 줄여 드립니다. 프레임을 자동으로 채점해 후보를 추리고, 세 가지 레이아웃으로
바로 합성하고, 작은 화면에서 어떻게 보이는지까지 한 장에 모아 보여 드립니다.

파이프라인

1. 프레임 채점: ffmpeg로 장면전환·균등 샘플링 타임스탬프를 뽑고, 각 프레임을
   선명도(라플라시안 분산)·밝기대비·얼굴 존재(OpenCV Haar cascade)·컬러풀니스로 채점해
   상위 후보만 남깁니다.
2. 후킹 텍스트 선정: 채점 결과와 후보 이미지를 보고 변형마다 2~6단어 한국어 문구를
   정합니다. 검증된 문구 패턴 가이드가 포함되어 있습니다.
3. 레이아웃 합성: Pillow로 큰 외곽선 텍스트, 색상 블록·스트라이프, 원·화살표 강조,
   배경 블러·암전을 조합해 세 가지 스타일로 렌더링합니다. 우측 하단 재생시간 배지 자리는
   코드로 비워 둡니다.
4. 비교 시트: 실제 업로드 크기와 모바일 피드 실제 크기(168x94)를 나란히 놓아 작은
   화면에서도 글자가 읽히는지 바로 확인합니다.

실제 명령

uv run scripts/frames.py --input video.mp4 --out-dir out/frames --top-n 8
uv run scripts/compose.py --input out/frames/candidate_04.jpg \
  --text "안 보면 후회함" --layout side-panel --out out/thumb_A.jpg
uv run scripts/preview.py \
  --thumb out/thumb_A.jpg=A --thumb out/thumb_B.jpg=B --thumb out/thumb_C.jpg=C \
  --out out/compare_sheet.jpg

포함 구성

사용 예시 3개

1. 브이로그 하이라이트 영상: 여러 장면이 섞인 10분짜리 원본에서 자동으로 장면전환
   지점을 찾아 후보를 뽑고, 가장 분위기가 살아있는 프레임에 손실회피형 문구(안 보면 후회함)를 얹은 side-panel 안을 고릅니다.
2. 여행 브이로그: 풍경이 중심인 영상이라 컬러풀니스 위주로 후보가 정렬되고, 반전형
   문구(말도 안 되는 절경)를 bottom-stripe 레이아웃으로 합성해 핵심 피사체(해·랜드마크
   등)를 원으로 강조합니다.
3. 레시피·쿡방 영상: 완성 장면이 화면 중앙에 나오는 프레임을 --focus로 지정하고,
   숫자형 문구(3분이면 완성)를 top-banner 레이아웃으로 얹어 세 번째 안으로 비교에
   추가합니다.

필요한 준비물

• ffmpeg(Homebrew 등)와 uv가 설치되어 있어야 합니다.
• 한글이 들어간 OS 폰트가 필요합니다: macOS/Windows/Linux 주요 배포판은 자동으로
  찾지만, 못 찾으면 --font로 TTF/TTC 경로를 직접 넘겨야 합니다.
• 얼굴 검출은 OpenCV 기본 Haar cascade라 정면 얼굴 기준입니다. 측면·역광·아주 작은
  얼굴은 놓칠 수 있고, 얼굴이 없는 영상(그래픽·게임 화면 등)에서는 얼굴 점수 없이
  나머지 지표로만 순위가 매겨집니다. 이 경우도 정상 동작입니다.
• 클릭률 상승을 보장하지 않습니다. 후보를 빠르게 만들고 비교하기 쉽게 해 드릴 뿐이고,
  실제 성과는 채널·주제·업로드 타이밍에 달려 있습니다.
• 실존 인물 사칭·딥페이크·기만 목적 사용을 금지합니다. 이 스킬은 사용자가 가진 영상의
  프레임을 그대로 잘라 텍스트를 얹을 뿐이며, 얼굴을 바꾸거나 없는 표정·상황을 새로
  만들어내지 않습니다.

추천

• 유튜브에 정기적으로 올리면서 썸네일 시안을 여러 개 빠르게 비교하고 싶은 채널
• 프레임 고르기·텍스트 배치를 매번 포토샵으로 반복하기 번거로운 1인 제작자
• 이미 유튜브 제목 생성 스킬을 쓰고 있고, 이미지 쪽만 채워 넣으면 되는 경우

비추천

• 얼굴 인식 정확도가 핵심인 용도(보안·출입 통제 등): 이 스킬은 썸네일용 구도 참고
  점수일 뿐, 정밀 얼굴 인식 제품이 아닙니다.
• 완성된 디자인 시스템(브랜드 폰트·고정 템플릿)을 그대로 따라야 하는 채널: 레이아웃
  3종은 범용 스타일이고, 브랜드 전용 커스터마이징은 포함되어 있지 않습니다.

FAQ

Q1. 얼굴이 하나도 안 나오는 영상(강의, 게임 화면)에도 쓸 수 있나요?
그렇습니다. 얼굴 점수는 0으로 처리되고 선명도·대비·컬러풀니스만으로 후보 순위가
매겨집니다. 이 카드의 실제 출력 샘플도 사람 얼굴이 없는 합성 일러스트 영상(데스크·
여행·요리 장면)으로 만들었습니다.

Q2. 썸네일에 들어갈 제목 문구도 자동으로 지어주나요?
아닙니다. 이 스킬은 이미지 합성만 담당합니다. 문구는 가이드(guides/hook-text-patterns.md)를
참고해 에이전트가 영상 내용에 맞춰 직접 정합니다. 제목(타이틀) 자체를 생성하는 작업은
별도 스킬 영역입니다. 이미 유튜브 제목 생성 스킬을 쓰고 계시다면 그쪽에서 나온 제목과
이 스킬에서 나온 썸네일을 짝지어 쓰시면 됩니다.

Q3. 결과물이 진짜 유튜브에 바로 올릴 수 있는 크기인가요?
정확히 1280x720 JPG, 2MB 이하로 나옵니다. E2E 테스트에서 78~104KB 수준으로 나왔고,
compose.py가 품질을 자동으로 낮춰가며 용량을 맞춥니다.

Q4. 한글 폰트가 없는 환경에서는 어떻게 되나요?
macOS(Apple SD Gothic Neo), Windows(맑은 고딕), Linux(Noto Sans CJK) 순서로 자동
탐색합니다. 못 찾으면 에러 메시지와 함께 --font 옵션 사용법을 안내합니다.

Q5. 원 프레임에 없던 사람 얼굴이나 표정을 새로 만들어 넣을 수 있나요?
아닙니다. 이 스킬은 원본 영상의 프레임을 자르고 배경을 블러·암전 처리한 뒤 그 위에
텍스트와 도형을 얹을 뿐입니다. 얼굴을 생성하거나 다른 사람으로 바꾸는 기능은 없습니다.

구매 안내

다운로드 후 package/ 폴더를 그대로 프로젝트에 두고 uv run package/scripts/frames.py ...로
시작하시면 됩니다. 별도 설치나 API 키 등록은 필요 없습니다. ffmpeg와 uv만 준비하시면
됩니다.

예시 이미지는 Blender Foundation 의 오픈 무비 Sintel(CC BY 3.0, durian.blender.org) 예고편으로 실제로 돌린 결과입니다.