비디오 크리에이터
비디오를 단일 HTML 페이지로 제작합니다. 하나의 함수 render(t)가 시간만을 기준으로 모든 요소의 상태를 설정합니다. CSS 전환, 타이머 또는 이전 프레임의 메모리를 사용하지 않습니다. Playwright 스크립트가 각 프레임의 시간으로 이동하여 스크린샷을 찍고, ffmpeg이 프레임을 인코딩합니다. 모든 프레임이 t의 순수 함수이기 때문에, 어떤 순간으로든 이동하거나 병렬로 렌더링할 수 있으며 항상 동일한 출력을 얻을 수 있습니다.
창의적인 재량권이 넓습니다. 이 기술은 기법, 어렵게 얻은 교훈, 그리고 Danny의 기본값을 제공합니다. 템플릿이 아닙니다. 최고의 비디오는 주제에 특화된 하나의 강력한 아이디어에서 나옵니다.
참조 구현: website/video/ (https://github.com/dannysmith/astro-editor). README에는 페이지, 렌더러, 합성 오디오 및 게시에 대한 내용이 포함되어 있습니다. 기법을 배우기 위해 읽되, 외형을 그대로 따라 하지는 마세요. 어둡고 영화 같은 스타일은 그 제품에 적합했지만 모든 제품에 적합한 것은 아닙니다.
페이지
window.DURATION = 45 // 초
window.__ready = Promise.all([document.fonts.ready, ...[...document.images].map((i) => i.decode())])
window.render = (t) => { /* 모든 요소를 t로부터 설정 */ }
대부분의 모션은 세 가지 헬퍼로 구성합니다: 시간 창을 통한 0-1 진행률, 이징 곡선, lerp. 카메라 움직임을 위한 키프레임 리스트와 텍스트를 위한 시드 기반 타이핑 헬퍼를 추가하세요. ?t=12 (한 순간에 고정) 및 ?play (requestAnimationFrame으로 구동되는 일반 속도 루프 재생)를 지원하여 Danny가 브라우저에서 페이지를 열어 확인할 수 있게 하세요. 둘 다 없으면 render(t)가 호출될 때까지 페이지는 아무것도 하지 않아야 합니다. 렌더러가 페이지를 로드하는 방식이기 때문입니다. 프레임 0을 렌더링하기 전에 __ready를 해결하세요. 그렇지 않으면 초기 프레임이 폴백 폰트를 사용하거나 누락된 이미지를 표시할 수 있습니다.
워크플로우
-
조사. 어떤 자료를 바탕으로 작업할지 파악하세요.
- 웹사이트나 브랜드가 있는 프로젝트: 실제 색상, 폰트, 스크린샷, 카피 및 스타일시트를 가져오고, 문서를 기준으로 제품 주장을 확인하세요.
- 브랜드가 거의 없거나 UI가 없는 프로젝트: README와 문서에서 핵심 내용을, 외형은 하우스 스타일에서 가져오세요.
- 프롬프트만 있는 경우 (컨셉, 기사, 가상 제품): 프롬프트와 첨부된 모든 것이 출처입니다. 하우스 스타일을 사용하세요. 가상의 것에 대해서는 자유롭게 창작하되 일관성을 유지하세요.
중요한 것이 누락된 경우 질문하세요.
-
제안. 빌드하기 전에 Danny에게 확인을 받기 위한 짧은 컨셉을 제공하세요: 중심 아이디어와 장면 간의 연결, 순서별 비트, 대략적인 길이, 외형 및 오디오 접근 방식. 컨텍스트가 충분하면 하나의 컨셉을 제안하세요. 컨텍스트가 적으면 각각 몇 줄로 두세 가지 대비되는 방향을 제안하세요.
-
계획. 자신의 사용을 위해 시간별 스토리보드(장면, 시작, 종료, 화면에 표시될 내용)를 작성하세요.
-
빌드. 현재 프로젝트의
video/디렉토리에서 작업하세요(요청하지 않으면 커밋하지 마세요). 또는 현재 디렉토리가 비어 있으면 그곳에서 작업하세요. 프로젝트용 렌더 스크립트를 작성하세요: 이 기술의assets/render.mjs를 시작점으로 복사하고 비디오에 필요한 대로 변경하세요. 애니메이션이 필요한 UI는 HTML로 재현하고, 정적이거나 몽타주 순간에는 실제 스크린샷을 사용하며, 모양과 일러스트레이션에는 SVG를 사용하세요. -
검토. 콘택트 시트와 스틸 이미지를 렌더링하고 수정한 후 반복하세요. 전체 렌더링 전에 최소 두 번 이상 수행하세요(제작 참조).
-
전달. 최종 MP4, Danny가 비디오 전체를 한눈에 볼 수 있는 콘택트 시트, 재렌더링 방법, 그리고 타사 에셋을 사용한 경우
LICENSES.txt를 포함하세요. 인코딩된 파일에서 프레임을 스팟 체크하세요.
달리 지시하지 않는 한: 16:9 비율, 1920×1080, 60fps, 콘텐츠에 적합한 길이(프로모션의 경우 30-60초), 소리를 끈 상태에서도 이해할 수 있어야 합니다.
제작
- 중심축을 찾으세요. 모든 컷을 관통하는 하나의 장치: 창, 도형, 커서, 카메라 경로, 카메라가 이동하는 단일 세계. 이것이 없으면 비디오는 페이드 효과가 있는 애니메이션 슬라이드가 됩니다. 크로스페이드보다는 매치 컷과 한 사물이 다음 사물로 변형되는 것을 선호하세요.
- 속도를 조절하세요. 대략 1.5~4초 길이의 비트. 길이를 다양하게 하세요: 가장 느린 장면은 가장 빠른 장면보다 약 3배 길어야 합니다. 아무것도 움직이지 않고 대사가 강조되는 정적인 비트를 최소 하나 포함하세요. 퇴장은 등장보다 빠릅니다. 처음 몇 초 안에 이것이 무엇인지 알리세요.
- 사람들이 읽을 시간을 주세요. 텍스트가 나타난 후 최소 0.6초에 단어당 0.3초를 더한 시간 동안 텍스트를 유지하세요. 한 줄을 2초 안에 읽을 수 없으면 단어를 줄이세요.
- 웹이 아닌 비디오에 맞게 크기를 조정하세요. 1080p에서 헤드라인은 90px 이상, 본문 텍스트는 32px 이상. 1px 선과 10% 미만의 불투명도는 인코딩 후 사라집니다. 전체 화면 선형 그라데이션은 띠가 생기므로 단색 또는 방사형 채우기를 사용하세요.
- 지루한 기본값을 피하세요: 모든 것에 동일한 이징과 지속 시간, 모든 등장이 슬라이드 업 앤 페이드, 모든 장면에서 동일한 지연 효과, 모든 컷에서 크로스페이드, 그라데이션 텍스트, 검은색 배경에 보라색 또는 시안 글로우, 모든 것이 가운데 정렬.
- 실제 자료를 사용하세요. 출처의 실제 색상, 카피 및 UI. 화면에 표시되는 모든 숫자와 주장을 확인하세요.
- 편집자처럼 검토하세요.
- 초당 약 한 프레임의 콘택트 시트는 속도와 구성을 보여줍니다.
- 스틸 이미지는 모션을 숨기므로, 각 전환에 걸쳐 프레임을 촘촘히 배치하여 이징을 확인하세요(예제 렌더러의
--sheet 0.05 --from 12 --to 12.6). - 코드 내
getBoundingClientRect()를 사용하여 텍스트 오버플로우와 충돌을 육안뿐만 아니라 확인하세요.
주의사항
- 프레임 간 상태 없음. 병렬 렌더 워커는 비디오 중간부터 시작하므로 이전 프레임에서 캐시된 모든 것이 누락됩니다. 모든 것을
t로부터 유도하거나, 각 프레임에서 페이지로부터 측정하세요. - 폰트를 로컬로 유지하세요. 웹 폰트 파일을 프로젝트에 다운로드하세요. 렌더링 시 네트워크에서 로드하는 것은 신뢰할 수 없습니다. Mac에 설치된 라이선스 폰트(예: Operator Mono)는
local()로 로드됩니다. 해당 파일을 리포지토리에 복사하지 마세요. - 모든 무작위성에 시드를 사용하세요 (타이핑 리듬, 지터, 블롭 모양). 렌더링이 동일하도록 보장합니다.
- 측정하고 추측하지 마세요. 레이아웃 종속 위치(연결선, 드롭 대상, 커서 경로)는
getBoundingClientRect()를 사용하여 가져오세요. 이미지에 주석을 오버레이할 때는 이미지 자체의 오프셋을 추가하는 것을 잊지 마세요. <video>요소를 재생하지 마세요. ffmpeg를 사용하여 프레임을 추출하고t에 해당하는 올바른 프레임을 표시하세요.- Chromium이 Claude Code 샌드박스 내에서 실행되지 않습니다. 렌더링은 샌드박스 외부에서 실행하세요.
- 오디오를 들을 수 없습니다. 그렇게 말하세요. 레벨을 숫자로 확인하고 파형을 살펴보세요(
references/audio.md참조). - 웹 전달: H.264 with
-crf 27 -preset veryslow -tune animation -pix_fmt yuv420p -movflags +faststart,loudnorm=I=-16으로 정규화된 AAC 오디오.
하우스 스타일
프로젝트와 프롬프트가 명확하지 않은 부분에 대한 기본값입니다. 프로젝트 자체 브랜드가 외형에서 우선하며, Danny의 지침이 모든 것보다 우선합니다. 그가 다른 스타일을 요청하거나 기본값을 무시하라고 말하면 완전히 버리세요: 팔레트, 블롭 또는 서체를 습관적으로 가져오지 마세요. 톤, 애니메이션 및 오디오 기본값은 그가 달리 말하지 않는 한 브랜드 비디오에도 여전히 적용됩니다.
색상
Notion의 색상을 기반으로 한 Danny의 팔레트: Brand Grey #2f3437 캔버스, 프레임 및 더 어두운 패널용 #191919, 흰색 텍스트, 주요 단어에 코랄 #ff7369. 모양에는 파스텔 400번대와 채도 높은 500번대. references/colours.md에는 각 음영의 용도를 포함한 전체 팔레트와 danny.is 및 Flexoki 팔레트, 그리고 사용 시기에 대한 내용이 있습니다. 비디오당 하나의 팔레트를 사용하세요.
폰트
기본적으로 Geist, 헤드라인에는 무거운 두께. 또한:
- Figtree: 더 친근한 산세리프.
- Literata: 인용문 및 에세이 형식을 위한 세리프.
- Caveat: 곁말을 위한 필기체. 제한적으로 사용하세요.
- Operator Mono: 코드 및 터미널. 로컬에 설치되어 있으므로
local('Operator Mono')를 사용하고, 폴백으로 Fira Code를 사용하세요. - 시스템 폰트 (SF Pro): Mac 앱 프로젝트의 경우, 네이티브 UI와 일치시키기 위해 사용합니다.
- Inter: Danny의 이전 Figma 슬라이드와 일치시킬 때 사용합니다.
Operator Mono와 SF Pro를 제외한 모든 폰트는 Google Fonts에 있습니다.
타이포그래피
크고 무겁게: 헤드라인은 두께 800–900, 좁은 행간, 약간의 네거티브 자간. 짧은 제목은 모두 대문자, 진술문은 문장의 첫 글자만 대문자. 이탤릭 대신 색상으로 강조하세요. 가운데 정렬보다는 왼쪽 정렬 및 비대칭을 더 자주 사용하세요.
톤
- 영국식 영어.
- 따뜻하고, 평범하며 약간 건방진. 낯선 사람에게 판매하는 듯한 느낌보다는 영리한 친구에게 설명하는 듯한 느낌.
- 구체적으로: "워크플로우를 혁신하세요"가 아닌 "당신의 스키마가 폼이 됩니다".
- 한 줄에 하나의 생각.
- 그 일이 할 수 있는 것 이상으로 주장하지 마세요.
- 이모지는 환영합니다.
- 마케팅 클리셰 금지 ("소개합니다", "혁신", "완벽한", "잠금 해제", "게임 체인저").
Astro Editor 및 Taskdn 홈페이지가 이 목소리를 보여줍니다. 내레이션이나 헤드라인보다 긴 모든 것에는 writing:guide를 로드하세요.
미학
프로젝트 자체 홈페이지에서 시작하세요. 홈페이지가 없으면 Danny 자신의 슬라이드 및 소셜 이미지의 느낌을 빌리세요 (references/examples/의 스크린샷; 디자인하기 전에 살펴보세요). 레이아웃이 아닌 재료를 가져오세요:
- 어두운 프레임 안에 박힌 차콜 캔버스.
- 코랄 하이라이트가 있는 크고 대담한 흰색 타입.
- 모서리에서 흘러나오는 코랄 및 파스텔 톤의 유기적인 블롭.
- 느슨하고 손으로 그린 듯한 꼬임 또는 화살표.
- 일러스트레이션으로서의 큰 이모지.
- 팔레트의 플랫 벡터 드로잉.
- 가끔 사용되는 전체 면적 컬러 카드.
- 코드용 macOS 윈도우 크롬.
- 충분한 여백.
친근하고, 약간 장난기 있으며, 분명 사람이 만든 것 같은 느낌이어야 합니다.
이미지
사진보다는 직접 그린 SVG (시드 기반 블롭, 플랫 일러스트레이션, 다이어그램)를 선호하세요. 사진은 무언가를 더할 때만 사용하세요. Unsplash 또는 Pexels에서 가져오세요. 아이콘은 Lucide 또는 Phosphor에서 가져옵니다. Apple 이모지는 네이티브로 렌더링되며 개인 비디오에 적합합니다. 상업용 제품 마케팅에는 Fluent Emoji (MIT 라이선스)를 사용하세요.
애니메이션
- 부드럽고, 휘젓지 않게: 회전, 3D 뒤집기, 줌 블러, 렌즈 플레어 또는 입자 폭발 금지.
- 모션은 주의를 집중시켜야 하며, 한 번에 하나의 초점 움직임.
- 타이핑은 사람처럼 느껴져야 합니다: 불규칙한 리듬, 구두점에서의 일시 정지, 타이핑 중에는 단단하고 유휴 상태일 때 깜빡이는 커서.
- 약간의 배경 생동감을 추가하세요: 떠다니는 블롭, 까딱이는 이모지, 나타나는 체크 표시.
- 누군가를 미소 짓게 만드는 순간을 하나 목표로 하세요.
- 정지된 엔드 카드로 끝내세요.
오디오
비디오별로 선택하고 제안에서 그 이유를 설명하세요:
- 비디오에 맞춘 발견된 트랙. Danny에게 두세 개를 선별하세요. 당신은 들을 수 없으니까요.
- 화면 이벤트에 고정된 합성 사운드. 기본 발진기가 아닌 샘플 악기를 사용하세요.
- 위 두 가지의 혼합.
- 무음. 짧은 클립 또는 음소거 상태로 자동 재생될 모든 항목에 사용합니다.
음향 효과는 미묘하게 유지하세요: 의미 있는 이벤트당 하나. references/audio.md에는 출처, 라이선스, ffmpeg 레시피 및 들을 수 없는 오디오를 확인하는 방법이 있습니다.