모션 릴 (데몬 클립스 스튜디오)은(는) 무엇을 하나요?
이 릴의 모든 픽셀과 모든 사운드는 코드로 만들어집니다: 화면은 Remotion, pipeline/synth.py는 사운드, Edge TTS 또는 사용자 자신의 녹음은 음성입니다. 참조 빌드는 "Made in code": remotion/src/promo/MadeInCode.tsx, pipeline/promo.py, reels/261120-made-in-code/입니다. 새 릴을 작성하기 전에 이들을 읽으십시오. 패턴은 복사하되 내용을 그대로 복사하지 마십시오.
D:\Claude-Chrome\wearethedemon\studio 안에서 작업하고 studio/CLAUDE.md를 따르십시오 (환경, 렌더 경로, 스크래치용 A: 드라이브, 다운로드 전 확인, 요청 시에만 커밋, Claude 저작 표시 없음).
사용자가 매번 기대하는 것 (묻지 않고 제공할 것)
사용자는 직접적이며, 한 번 물어본 것을 두 번 말해야 하면 실망합니다. 처음부터 전체를 제공하십시오:
- 내레이션. 힌디어 나레이션, 비트에 맞춰 줄 단위로 시간 맞춤. AI 음성(Edge TTS
hi-IN-MadhurNeural)을 사용하십시오. 단, 사용자가 Voice-over Recorder에서 직접 녹음한 경우는 예외입니다. 음악만 있는 릴은 "나레이션 없음?"이라는 피드백을 받았습니다. - 아웃트로가 추가됨. 게시 가능한 파일은
-ig.mp4(팔로우) 및-yt.mp4(구독)이며, 아웃트로 자체 음향 효과와 릴과 아웃트로 전체에 걸쳐 마스터링된 하나의 사운드트랙이 포함됩니다. - 두 스크립트 모두. 로만 힌글리시와 데바나가리, 따라서 4개의 파일:
{roman,deva}-{ig,yt}. - 생동감 있지만 부드러운 모션. 요소가 튀어나오고, 흔들리고, 맥동하고, 오버슈팅합니다. 갑작스럽거나 성급하지 않게: 큰 움직임에는 시간을 주고 (진자 왕복은 1.5초; 1초는 "너무 빠르고 부드럽지 않음"), 빠른 움직임에는 모션 블러 흔적을 남깁니다.
- 하우스 룩: Paper Glass Lab. 옅은 그리드, 흰색 유리, 채널 레드 #E5162D / #B80F22, 잉크와 흰색. 야간 간주곡(#0E0E12 + 레드 글로우)은 리듬을 위해 허용되지만, 사용자가 공식적으로 승인하지 않았으므로 선택 사항으로 유지하십시오. 노란색 금지, 비디오 내 이모지 금지, 가짜 숫자 금지, 인증 배지 금지.
- 정직한 주장. 릴이 "모든 사운드는 코드"라고 말한다면, 실제로 그래야 합니다. 화면의 코드는 이 릴의 실제 소스이며, 테스트가 이를 확인합니다.
- 요청한 것을 만드십시오. 사용자가 X를 요청했다면, 더 가벼운 버전을 제안하고 다시 묻지 마십시오.
워크플로우
1. 형식 및 아이디어
참조 릴이 있다면, 그 형식만 가져오십시오: 구조, 리듬 및 움직임의 종류. 스크립트, 캡션 또는 디자인은 절대 가져오지 마십시오. 각각 한 줄씩 5-8개의 비트를 작성하십시오: 무엇이 움직이는지, 어떤 텍스트가 나타나는지, 어떤 소리가 재생되는지. 카피에 넣기 전에 모든 사실을 확인하십시오. reward.md에 실제 결과물이 있을 때만 "Comment KEYWORD" 카드를 사용하십시오. 해당 파일을 초안으로 작성하고 사용자의 승인이 필요하다고 표시하십시오; 사용자가 DM을 직접 보냅니다.
2. 폴더 및 카피
reels/<YYMMDD>-<slug>/를 생성하십시오:
copy.yaml:handle,keyword,brand.- 화면 텍스트용
roman:및deva:블록. voice:블록:id,rate,lines: [{at, text, roman}].text는 TTS용 데바나가리이며, 영어 단어는 hi-IN 음성이 발음하는 방식으로 철자합니다 (कोड, क्लॉड, एडिटर, डी एम).roman은 사용자가 녹음기에서 읽는 내용입니다.
reward.md: 사용자가 승인할 때까지 초안.notes.md:- 빌드 명령어 및 게시할 파일;
- 게시 전 체크리스트 및 커버 프레임 제안;
- 게시용 카피: 최대 5개의 해시태그가 있는 IG 캡션, 최대 100자의 YT 제목, 3-5개의 해시태그가 있는 설명.
3. 비트 시트 먼저
비트 시간을 하나의 JSON 파일 remotion/src/promo/<slug>.beats.json에 초 단위로 넣으십시오.
- 공유: 컴포지션과 Python 믹스가 모두 이를 읽어 모든 사운드가 정확한 프레임에 위치하도록 합니다.
- 이름: 발생하는 동작에 따라 비트 이름을 지정하십시오 (
cut,wall,land[],reveal,stretch,toCard,keyword,brand,fadeOut). - 종료: 마지막 0.4초는 조용하고 정적으로 유지되어 프레임 0으로의 루프백이 깔끔합니다.
- 길이: 릴 25-30초 + 아웃트로 3.5초.
4. 컴포지션
remotion/src/promo/<Name>.tsx를 작성하고 Root.tsx에 등록하십시오. calculateMetadata는 비트에서 길이를 가져옵니다.
- 스키마: 모든 카피 조각에 대한 zod 스키마 (
script: "roman" | "deva", 라인, 카드, 브랜드,audio,fps). 로만 카피가 기본값입니다. - 시간: 초 단위로,
../motion(seconds,springAt,ramp,wiggle,pulse,loop,stagger) 및brand/tokens.ts의 스프링 (SPRING.ui18/160/0.8,SPRING.stamp11/220/0.7)을 사용하십시오. 프레임 수는 절대 사용하지 마십시오. 따라서 모든 fps가 작동합니다. - 킷:
Backdrop,NightBackdrop,FitLine(라인을 너비에 맞춤),Card,Chip,Stamp,Rich,Phone,CaptionBar,SafeOverlay. - 텍스트:
- 안전 영역 내에 유지하십시오: x 60-950, y 250-1560. 읽을 수 있도록 의도된 것은 34px 미만이어서는 안 됩니다.
- 로만 캡션은 UPPERCASE Rajdhani입니다; 두 번째 줄은 빨간색 Poppins 600 기울임꼴입니다.
- 데바나가리는 대문자로 표기되지 않습니다. 더 큰 최대 크기(로만 150/128에 대해 약 148/120, 필 64에 대해 72),
lineHeight ≥ 1.25및lang="hi"가 필요합니다.
- 다양성: 아래 어휘에서 4-6개의 움직임을 섞고, 각 릴마다 다른 순서로 사용하십시오. YouTube는 반복되는 템플릿을 비진정 콘텐츠로 취급합니다.
5. 사운드 및 음성
아래 "사운드"를 참조하십시오. 음악과 음향 효과는 비트 시간에 Bus에 배치됩니다. 음악은 음성 아래 −9dB, 효과는 −5dB로 덕킹됩니다. 그 다음 리미터, loudnorm을 거쳐 −14 LUFS로 조정됩니다. 각 음성 라인은 다음 라인이 시작되기 전에 종료됩니다.
6. 파이프라인 모듈
pipeline/promo.py는 하나의 Made-in-code 릴(SLUG, COMPOSITION, BEATS_JSON, 해당 music/sfx)에 연결되어 있습니다.
두 번째 릴을 처음 빌드할 때는 파일을 복사하지 말고 일반화하십시오:
- 공유 파트(
load_copy,voiceover,soundtrack,_master,render,filmstrip,final)를 릴 구성을 받는 모듈(slug, 컴포지션 ID, 비트 경로, 해당 릴의music(b)및sfx(b))로 이동하십시오. promo.py를 Made in code용 얇은 구성으로 유지하고 CLI에--reel <slug>를 제공하십시오.- 녹음기에 대해서도 동일하게 수행하십시오:
pipeline/recorder.pyProject는 slug를 받고,pipeline record --reel <slug>가 작동하여 Voice-over Recorder 앱이 모든 릴에 음성을 넣을 수 있습니다.
테스트가 통과하는지 확인하고, 보고서에 이 변경을 수행했다고 말하십시오.
7. 전체 렌더링 전 필름스트립 검토
핵심 비트 스틸(행당 6개, --filmstrip)을 A:\claude-workspace\screenshots\demon-studio\<slug>\로 렌더링하고 직접 확인하십시오. 확인 사항:
- 텍스트를 읽을 수 있고 안전 영역 내에 있으며 데바나가리가 너무 작지 않은지;
- 빈 순간(카드가 0.6초 동안 비어 있으면 깨져 보이므로 약 0.4초 내에 텍스트 시작);
- 긴 마지막 줄이 가장자리에 닿지 않고 레이어 효과가 정렬되는지.
수정하고 스틸을 다시 렌더링한 다음 비디오를 렌더링하십시오.
8. 렌더링, 아웃트로, 최종 파일
믹스를 빌드한 다음 각 스크립트를 렌더링하십시오. 그런 다음 final():
- 플랫폼 아웃트로를 추가합니다:
O.render_outro(platform, script, keyword=..., reward=...), 세 번째 글머리 기호 "Comment KEYWORD: reward" 포함; - 두 비디오를 결합하고 하나의 사운드트랙을 전체에 걸쳐 마스터링합니다;
- H.264 CRF 18, BT.709 limited range, AAC 320k 48 kHz, +faststart로 인코딩합니다.
9. 확인 후 보고
- 형식 (
ffprobe): 1080×1920, 30 fps, yuv420p, BT.709, AAC 48 kHz 스테레오, 길이 = 릴 + 아웃트로. - 음량: 모든 최종 파일에서 −14 ±1 LUFS 및 true peak ≤ −1 dBTP.
- 오디오 존재: ffmpeg로 초당 RMS 확인.
- 아웃트로 프레임: 헤드라인, 카드, 탭, 팔로잉/구독됨, 키워드 글머리 기호.
- 테스트:
uv run python -m pytest -q통과. 새 릴에 대한 테스트 추가:- 화면의 코드가 실제인지;
- 비트가 순서대로 있는지;
- props가 두 스크립트 모두에 유효한지;
- 모든 음성 라인이 다음 라인보다 0.05초 먼저 끝나는지;
- 사운드트랙이 전체 길이 동안 실행되고 마지막 0.4초는 무음인지;
- 키워드에 보상이 있는지.
일반 언어로 보고:
- 게시할 4개의 파일, 링크 포함;
- 릴을 비트별로 짧은 목록으로;
- 확인한 사항과 확인할 수 없는 사항(들은 수 없으므로 재생해야 함);
- 미결 결정: 보상 승인, 커버 프레임.
VS Code 미리보기가 이러한 파일을 무음으로 재생할 수 있다는 점을 상기시키십시오 ("오디오가 없는 이유?"). VLC, Windows Media Player 또는 Chrome에서 제대로 재생됩니다.
모션 어휘 (MadeInCode.tsx 코드)
하나의 히어로 객체가 릴을 주도합니다 (빨간 공). 다른 모든 것은 그 위치에 반응하여 인과 관계를 제공합니다: 공이 지나가면 텍스트가 나타납니다.
경로
- 진자.
ballAt:x = 540 − SWING·cos(t·TURN),y는 줄의 원 위 (stringY),TURN = π / pass이고 1.5초 왕복.PendulumString은 부드러운 그림자가 있고 컷 후 피벗에 스냅됩니다. - 홉.
hop(a, b, u, h)는4·h·u·(1−u)를 뺀 직선입니다: 정점 높이h의 실제 포물선. 착지점의 계단 아래로 체인 홉.Easing.out(Easing.back(1.5))로 최종 안정을 완화하십시오. - 벽으로 비행. 쿼드 이즈인, 작은
sin(u·π)호 추가. - 글라이드.
lensAt: 키프레임을 통한 Catmull-Rom, 첫 번째 세그먼트에서 이즈인, 마지막 세그먼트에서 이즈아웃. - 모션 블러 흔적.
Trail: 경로의 마지막 0.09초를 샘플링하고 SVGfeGaussianBlur아래에ceil(길이 / 5 px)개의 원(최대 48개)을 그리고, 꼬리 쪽으로 수축 및 페이드 (0.16·(1−k)^1.4). 복사본이 겹쳐져 하나의 혜성처럼 보이며, 구슬처럼 보이지 않습니다.
텍스트
- 객체를 따르는 와이프.
SceneSwing/SwingText: 각 캡션은 공의 x에서clip-path: inset()으로 클리핑된 전체 프레임 레이어입니다. 새 캡션은 공 뒤에 표시되고, 이전 캡션은 공 앞에 표시되며, 방향은 각 통과마다 번갈아 나타납니다. - 착지 시 스탬프.
StackLine: 라인이 착지 비트에 정확히springAt(c, at, SPRING.stamp)으로 팝됩니다.
충격 및 생동감
- 스쿼시 및 스트레치.
squashAt: 착지 후 0.14초 동안,sx += 0.3·sin및sy −= 0.26·sin,transform-origin: 50% 100%사용. 벽 충돌은 반대 방향으로 늘어납니다. - 잔물결. 접촉 지점에서 0.45초에 걸쳐 자라는 평평한 타원형 링.
- 버스트. 14개의 반짝임과 점,
random()으로 시드되어 렌더가 정확히 반복됩니다. 한 번의 큰 순간(키워드)에만 사용하십시오. - 흔들기 및 맥동.
wiggle(c, at, dur, hz, amp)는 회전을 흔듭니다;pulse(c, at, dur, amount)는 스케일을 범프합니다. 펄스를 함께 곱하고 마지막에 매초 부드러운 펄스를 추가하여 카드가 계속 숨 쉬도록 합니다. - 샤인. 기울어진 흰색 그라데이션 바가 필을 한 번 가로지릅니다.
씬
- 라이트에서 나이트로. 공이 종이 위로
NightBackdrop패널을 끕니다. 앞쪽 가장자리는 기울어진 선(panelEdge/edgeX, 기울기 완화 0 → 14° → −6°)으로, 나이트 레이어를 다각형으로 클리핑하는 데 사용됩니다. - 종이로 돌아가기. 강한 비트에서 컷백.
- 카메라 푸시인. 씬당 3-6%는 괜찮지만, 확대경이 있는 씬에서는 절대 안 됩니다.
포커스 및 공개
- 공에서 렌즈로.
lensRadius/Lens: 공이 빨간색 링(스프링)으로 팽창하고, 유리로 채워지고, 손잡이가 자라며, 나머지는 어두워지는 동안 회색 코드 레이어 위로 글라이드합니다. 그런 다음 공개 단어가 유리 내부에서 팝되고 (Easing.in(Easing.back(1.4))) 다시 공으로 닫힙니다. - 확대. 유리 내부에서 동일한 레이어를
transform-origin이 렌즈 중심에 있는ZOOM(2.1)으로 확장하여 그립니다. 기본 레이어가 움직이면(카메라 푸시), 확대된 복사본이 정렬에서 벗어납니다. - 화면의 코드.
code-lines.ts에서 가져옵니다: 이 릴 자체 소스의 그대로의 라인, 테스트에 의해 동기화 유지, 렌즈 내부에서만 색상 강조.
CTA 변형
- 형태.
Morph는 세 개의 스프링으로 하나의 둥근 직사각형을 만듭니다: 너비sW, 높이sH(더 느슨하게, 그래서 흔들림) 및 카드sC.w = 60 + 840·sW + 20·sC,h = hPill + 430·sC, 반경은 필에서 52로 이동합니다. - 시퀀스. 공 → CTA 텍스트가 위로 슬라이드되는 필 → 흔들기 및 샤인 → 카드. 카드는 MessageCircle + "comment karo"를 잡고, 그 다음 버스트와 함께 스케일 1.7에서 1로 찍힌 190px 기울임꼴 키워드, 그런 다음 포스트 라인.
- 엔딩.
Brand잠금(엠블럼, Anton 워드마크, 모노 태그), 나이트로 페이드, 마지막 0.4초 정지.@handle워터마크가 전체 시간 동안 왼쪽 상단에 위치합니다.
사운드 (pipeline/synth.py, pipeline/audio.py)
S.Bus(seconds)는 스테레오 타임라인입니다:
add(clip, at, gain_db, pan)는 클립을 배치합니다.mix(other, db)는 두 버스를 합산합니다.duck_under(key, depth_db)는 다른 버스 아래에서 사이드체인 덕킹합니다.fade_out(start, end)및peak().
매번 비트 JSON을 읽으십시오. 규칙: 모든 시각적 비트는 소리를 가지며, 빠른 움직임은 공기를 얻습니다. 각 우쉬에 고유한 seed를 부여하고 작은 소리는 ±0.15-0.7로 팬합니다.
| 시각적 요소 | 사운드 | 게인 dB |
|---|---|---|
| 빠른 통과 또는 비행 | whoosh(dur, lo, hi, peak, seed), 가장 빠르게 움직이는 지점에서 최고조, 방향으로 팬 | −11 ~ −16 |
| 극단 통과, UI 틱 | tick(freq, dur) | −24 |
| 컷, 줄 스냅 | snap() + riser(dur) 다음 히트로 | −13 / −17 |
| 큰 히트(벽, 키워드) | impact() | −9 / −10 |
| 착지 | thud(150, 50, 0.4) + pop(900+80·i, 300), 각 착지마다 상승 | −8 / −13 |
| 조명 켜짐, 완료 | ting(Hz): 1318.5, 1568, 1760, 2093, 2637 | −13 ~ −15 |
| 팽창, 스트레치, 변형 | boing(f0, f1, dur) | −10 ~ −14 |
| 공개, 반짝임, 샤인 | shimmer(base, gap) | −13 ~ −22 |
| 수축, 닫힘 | zip_down() | −14 |
| 흔들림 | rattle() | −13 |
음악 120 BPM, A단조 Am F C G, 2초 마디(1.5초 왕복 = 3비트, 따라서 모션과 음악이 일치).
- 마디당
pad, 시청자가 읽거나 볼 때 더 조용하고 어둡게. - 8분음표의 Karplus-Strong 아르페지오
pluck, 두 옥타브 위. - 모션 악센트 및 빌드의 4-on-the-floor에
kick. - 나이트 씬에서만
hat및sub. - 워드마크 아래 최종
pad.
음성
- AI 음성: Edge TTS 7.3.1,
hi-IN-MadhurNeuralat +8% (hi-IN-SwaraNeural은 여성 옵션).build/voice/에 캐시되며 스크립트 텍스트만 전송됩니다. - 자체 음성:
voiceover(mode="auto")는 녹음기 테이크(audio/voice-take.json)를 선호하고, 그 다음audio/my-voice.*(pipeline/ownvoice.py로 일시 정지에서 컷된 하나의 테이크), 그 다음 AI 음성입니다.--voice ai|own으로 강제 지정합니다. - 라인: 각 라인은 2-6 단어이고 비트에서 시작합니다. 모든 클립을 측정하십시오: 다음 라인보다 ≥ 0.05초 전에 종료되어야 하며, 마지막 라인은
fadeOut전에 종료되어야 합니다. 그렇지 않으면 단어를 줄이십시오. 하이패스 80 Hz, 노멀라이즈 −3 dB, 릴리즈 0.2 s.
렌더 환경
studio/CLAUDE.md를 참조하십시오. 요약:
uv run python -m pipeline.promo render --reel <slug>모든 파일을 빌드합니다;uv run python -m pipeline.promo filmstrip --reel <slug>스틸을 생성합니다;uv run python -m pytest -q테스트를 실행합니다.
보상
키워드가 있는 각 릴에는 reward.md의 보상이 필요합니다. 사용자가 승인할 때까지 초안으로 유지하십시오. 보상은 일반적으로 DM에서 제공되는 실제 결과물(예: 할인 코드, 독점 콘텐츠 링크)입니다.