thumbnail-maker은(는) 무엇을 하나요?
scripts/thumbnail.py (scripts/fonts.py가 같은 디렉터리에 위치). Python 3.9+ 및 pip install pillow 필요.
# 기술 / 튜토리얼: 실제 스크린샷, 중요한 줄에 원 표시, 제목에서 화살표 연결
python thumbnail.py --title "Claude almost deleted *everything*" --style dark --shot terminal.png --circle 0.19,0.17,0.18 --arrow --out t.jpg
# 토킹헤드: 제목 앞에 컷아웃된 인물 사진
python thumbnail.py --title "I tested *every* AI coding tool" --style dark --photo me-cutout.png --out t.jpg
# 사진 배경, Shorts 크기
python thumbnail.py --title "A day as a *dev*" --bg desk.jpg --style dark --size 1080x1920 --out short.jpg
| 옵션 | 설명 |
|---|---|
--title | 3-5단어가 가장 잘 읽힙니다. *단어*로 키워드를 표시합니다(하나의 박스 또는 색상). --keep-case를 사용하지 않으면 대문자로 변환됩니다. |
--style | dark(거의 검정 + 노랑), light(아이보리 + 빨강), 또는 더 강렬한 pop, red, green, tech. |
--look | clean(기본값): 부드러운 비네트가 있는 단색, 또는 대비를 위해 흐릿하고 어둡게 처리된 --bg 사진. burst: 이전 그라데이션 + 햇살 스타일. |
--shot img | 주요 시각 요소로 사용할 실제 스크린샷. 가로로 긴 이미지(터미널 또는 UI 한 두 줄)는 제목 아래 전체 너비로 배치되고, 세로로 긴 이미지는 제목 옆에 배치됩니다. 공간을 채우도록 확대됩니다. |
--circle x,y,r | 스크린샷 위에 손으로 그린 빨간 타원. x,y = 중심, r = 타원의 반 너비(스크린샷 크기에 대한 비율). |
--arrow | 제목에서 원까지 손으로 그린 화살표(위에 공간이 없으면 제목 주위로 우회). --mark-color로 빨간색을 변경할 수 있습니다. |
--photo img | 인물 사진. 투명 배경의 PNG(컷아웃)는 윤곽선이 그려지고 깊이감을 위해 제목 가장자리 앞에 배치됩니다. 일반 사진은 테두리가 있는 카드가 됩니다(--photo-shape circle, --tilt). |
--subtitle, --emoji, --accent, --highlight color, --size, --align, --font | 이전과 동일: 작은 두 번째 줄, 이모지 스티커, 키워드 색상, 박스 없는 컬러 키워드, 출력 크기, 정렬, 제목 글꼴. |
디자인 규칙 (2026년 최상위 썸네일 참고)
- 하나의 아이디어, 3-5단어. 제목은 이미지를 보완해야 하며 이미지를 설명해서는 안 됩니다.
- 실제 내용을 보여주세요. 실제 오류, 결과 또는 UI의 크롭된 스크린샷이 일반적인 그래픽보다 효과적입니다. 중요한 줄을 정확히 크롭하고 원을 그리세요.
- 얼굴: 표정이 뚜렷한 컷아웃, 크게(높이의 40-60%). 눈 위에 텍스트를 배치하지 마십시오.
- 두 가지 색상. 단색 배경에 하나의 강조 색상. 햇살, 이모지 벽 또는 그라데이션 텍스트는 템플릿이나 AI 제작처럼 보입니다.
- 우측 하단 코너를 비워두세요. YouTube가 비디오 길이를 표시합니다.
검사 (콘솔 출력 및 <이름>.preview.png에 표시)
- YouTube 검색에서 제목 글자 높이(168px 너비 기준)가 8px 미만 → 경고.
- 제목의 유효 대비(채우기 vs 배경 및 윤곽선)가 3:1 미만 → 경고.
- 눈가림 테스트: 제목 영역을 48px 너비로 블러 처리했을 때 주변과 여전히 구분되어야 함.
- 타임스탬프 코너: 제목이 우측 하단 20% x 16% 영역에 닿음 → 경고.
- 키워드 박스가 배경과 혼동되거나, 키워드 대 박스/윤곽선 대비 불량, 6단어 초과. 경고 발생 시 종료 코드 1. 이미지를 사용하기 전에 반드시 미리보기 시트를 확인하세요.
제한 사항
- 배경 제거 미지원: 이미 컷아웃된 PNG를 전달하세요(remove.bg, Photoshop, macOS "피사체 선택").
- 원과 화살표는 사용자가 지정한
--circle숫자에 따라 배치됩니다. 미리보기를 확인하고 x/y/r을 조정하여 타원이 맞지 않을 경우 수정하세요. - 글꼴: 제목에는 Impact 사용(Windows/macOS, Linux에서는
ttf-mscorefonts를 설치하거나FONT_TITLE=/path/Anton-Regular.ttf로 설정).FONT_TITLE,FONT_BOLD,FONT_EMOJI로 재정의 가능. - 이모지: 단일 코드포인트만 지원(Pillow는 libraqm 없이 ZWJ 시퀀스를 결합할 수 없음).
- 얼굴 감지 미지원: 얼굴이 가장자리에 닿지 않도록 사진을 크롭하세요.