원시 영상에서 릴스로 (Reel from raw video)
두 개의 릴스에서 검증됨: Linux Day 2 및 Linux Day 1 (효과음 포함). library/Reel.tsx는 Day 1 릴스입니다. 그 패턴을 복사하세요. 새로운 스타일을 발명하지 마세요.
macOS 및 Linux / Windows WSL에서 작동합니다. 설정: 저장소의 README.md를 참조하세요.
엄격한 규칙
- 모든 오버레이는
work/words.txt초 단위로 시간을 맞춥니다. 시간을 절대 추측하지 마세요. src/(library)에 있는 컴포넌트만 사용합니다. 라이브러리 컴포넌트가 비트(beat)에 맞지 않을 때만 새 컴포넌트를 추가합니다.- 얼굴을 명확히 유지합니다. 안전 영역(1080x1920):
- 상단 태그 및 타이틀: y 90~400.
- 얼굴 및 목: y 약 450~1350. 여기에는 전체 화면 타이틀 카드(최대 3초)만 가능합니다.
- 그 외 모든 것은 목 아래(셔츠의 첫 번째 단추)로 배치: y 1360~1880.
Panel은BELOW_NECK(1360)에서 시작합니다.fit을 사용하여 긴 패널을 1880까지 끝나도록 크기를 조정합니다. - 각 새 비디오의 목선을 찾습니다: y-그리드가 있는 프레임을 캡처하여 확인합니다.
ui.tsx에서BELOW_NECK을 업데이트합니다.
- 사용자가 채팅에서 요청하지 않는 한 전체 비디오를 렌더링하지 마세요.
scripts/stills.sh를 사용하여 확인합니다. 후크가RENDER_OK=1없이remotion render를 차단합니다. - 사용자에게 묻지 않고 어떤 것도(모델, 폰트, 음악, 사운드 팩) 다운로드하지 마세요.
- 디버깅하기 전에
reference/known-problems.md를 읽으세요. - OpenCode에서 플러그인
~/.config/opencode/plugins/reel-from-raw는 Claude 후크(렌더 차단, 타입 검사, 스틸 미리 알림)와 동일한 작업을 수행합니다. 시트 이미지를 읽기 도구로 엽니다. 모델이 이미지를 볼 수 없으면 사용자에게 시트를 확인하도록 요청하세요.
범위 규칙(정확히 따릅니다)
- 사용자가 요청한 것만 수행합니다. 요청에 필요한 파일과 값만 변경합니다.
- 검사(타입 검사, 스틸 검사, 후크 또는 플러그인의 미리 알림)는 검사일 뿐입니다. 이 파일 또는
reference/style-spec.md의 규칙을 위반하는 것만 수정합니다. 검사 때문에 스타일을 변경하거나, 컴포넌트를 추가하거나, 장면을 추가하거나, 텍스트, 타이밍 또는 볼륨을 변경하지 마세요. - 다른 것을 변경해야 한다고 생각되면 한 줄로 사용자에게 알리세요. 변경하지 마세요.
- 비디오 작업 중에는
~/.claude/skills/reel-from-raw/(이 스킬)를 편집하지 마세요. 비디오 프로젝트만 편집합니다. - 생성한 테스트 파일(예:
src/__probe.ts)은 완료 전에 삭제해야 합니다.
작업 흐름 (새 비디오)
각 단계를 실행합니다. 각 스크립트는 성공 시 OK:를 출력합니다. ERROR가 발생하면 중지하고 수정합니다.
| # | 단계 | 명령어 / 동작 |
|---|---|---|
| 1 | 프로젝트 생성 | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (예: ~/Coding/motion-videos/<name>). 라이브러리, 사운드 파일 및 후크를 복사하고 npm 패키지를 설치합니다(또는 $REEL_SEED에서 복제). |
| 2 | 전사 | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (영어만 있으면 en 사용). 그런 다음 reference/glossary.md로 오청을 수정합니다. |
| 3 | 무음 제거 | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. --start/--end를 사용하여 잘못된 시작 또는 꼬리를 제거합니다. |
| 4 | 비트 시트 | reference/beat-sheet-prompt.md를 따릅니다. work/beats.md를 작성합니다. 사용자가 계획을 승인하려면 보여줍니다. |
| 5 | 빌드 | src/Reel.tsx는 Day 1 릴스입니다. 비트 시트에서 다시 작성합니다. Root.tsx에서 id(예: LinuxDay3)와 실제 handle을 설정합니다. 릴스에서 사용하지 않는 장면 컴포넌트를 삭제합니다. At 및 r() 헬퍼를 유지합니다. |
| 6 | 타입 검사 | 자동: 후크가 각 편집 후 tsc --noEmit을 실행합니다. 보고된 모든 오류를 수정합니다. |
| 7 | 시각 검사 | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto를 실행한 다음 모든 out/stills/sheet*.jpg를 읽습니다. 또한 비트 프레임을 확인합니다: stills.sh <dir> 120,450,.... reference/style-spec.md와 대조하여 확인합니다. 수정하고 반복합니다. |
| 8 | 사운드 검사 | 효과음은 컴포넌트와 함께 제공됩니다("효과음" 참조). public/sfx/typing.wav 및 public/sfx/pop.wav가 있는지 확인합니다. 사용자가 요청하지 않는 한 표 외부의 사운드를 추가하지 마세요. |
| 9 | 미리보기 | 프로젝트에서 npx remotion studio --no-open --port <free>를 실행하는 launch.json 항목을 추가합니다. 사용자에게 URL http://localhost:<port>를 제공합니다. 사용자는 그곳에서 사운드를 듣습니다. |
| 10 | 렌더링(요청 시에만) | RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle (백그라운드에서 실행, 90초에 약 3-5분 소요). |
효과음
src/sfx.tsx는 모든 사운드를 보유합니다. SFX는 사운드를 나열합니다. <Sfx src at volume frames name>은 현재 시퀀스에서 at 프레임에서 하나의 사운드를 재생합니다.
SFX의 키 | 출처 | 인터넷 필요 |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (remotion.media의 파일) | 예, Studio 및 렌더링용 |
pop | public/sfx/pop.wav (코드로 생성) | 아니요 |
typing | public/sfx/typing.wav (scripts/make-typing-sound.py로 생성) | 아니요 |
라이브러리 컴포넌트는 이미 이러한 사운드를 재생합니다. 수동으로 추가하지 마세요.
| 순간 | 파일 (프로젝트 내) | 사운드 | 볼륨 |
|---|---|---|---|
| 후크 타이틀 / 서브 칩 | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| Day 타이틀 카드 | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| 명령어 목록 칩 | scenes/Intro.tsx (CommandList) | 칩당 pop | 0.36 |
| 명령어 태그 / 명령어 이름 | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| 메모장 줄 | scenes/Commands.tsx (NoteCard) | 줄당 typing | 0.6 |
| 하단 패널 표시 | ui.tsx (Panel) | pop | 0.48 |
| 터미널 명령어 입력 | ui.tsx (Terminal) | 각 명령어 줄에 typing | 0.6 |
| 라이트 릭 | Reel.tsx | whoosh | 0.48 |
| 완료 배지 / 팔로우 클릭 | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
volume이 없는 모든 <Sfx> | sfx.tsx (기본값) | - | 0.42 |
볼륨은 0(무음)에서 1(전체)까지입니다. 모든 사운드를 음성 아래로 유지합니다.
일반적인 요청 (정확한 레시피)
| 사용자 요청 | 정확히 이렇게 수행 |
|---|---|
| "모든 효과음을 N% 증가/감소" | <Sfx 줄의 모든 volume={x}와 sfx.tsx의 기본값을 (1 ± N/100)로 곱합니다. 소수점 2자리로 반올림합니다. CutVideo.tsx는 건드리지 마세요(음성입니다). 변경 전후에 grep -rn "<Sfx" src를 실행하고 변경된 값을 보여줍니다. |
| "키보드/타이핑 사운드 볼륨만 변경" | src={SFX.typing}이 있는 줄만 변경합니다(ui.tsx Terminal 및 scenes/Commands.tsx NoteCard). |
| "특정 사운드 X만 변경" | 위 표에서 해당 행을 찾습니다. 해당 volume만 변경합니다. |
| "키보드 사운드가 약함/새로 만들기" | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav. 먼저 이전 파일의 복사본을 보관합니다. 사용자가 다른 느낌을 요청하는 경우에만 스크립트의 숫자를 편집합니다. |
| "사운드 제거" | 해당 <Sfx .../> 줄을 삭제합니다. |
| "렌더링 전에 어디서 들을 수 있나요?" | Studio(9단계). 재생 또는 Space를 누릅니다. Studio는 각 저장된 편집 후 자동으로 다시 로드됩니다. |
| "직접 렌더링하려면 어떻게 하나요?" | 터미널: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle. Studio UI: 렌더 버튼(타임라인 위 막대 오른쪽 끝) → 비디오 탭 → 출력 이름 설정 → 비디오 렌더링. 진행 상황은 Jobs 탭에 표시됩니다. OpenGL 설정은 이미 angle입니다. |
| "렌더링해줘" | 10단계, RENDER_OK=1 포함. 그런 다음 출력 파일의 전체 경로를 제공합니다. |
| "핸들 변경" | Root.tsx defaultProps.handle. |
타이밍 작동 방식
src/timeline.ts:CUTS(제거된 원시 초),out(sec)은 원시 초를 출력 프레임에 매핑합니다.<At from={rawSec} to={rawSec} name="...">는 해당 말하는 범위에 대한 블록을 표시합니다.r(t0, t)는 블록 내에서 프레임 지연을 제공합니다. "t에서 단어가 말해질 때 이걸 팝업"과 같은 용도입니다.CutVideo는 세그먼트당 줌 1.0 / 1.14를 번갈아 적용합니다(각 컷에 펀치인). 더 많은 줌을 추가하지 마세요.
라이브러리 맵
| 파일 | 내보내기 | 용도 |
|---|---|---|
theme.ts | DISPLAY (Anton), SANS (Inter), MONO, 색상 C, extrude() | 모든 텍스트 및 색상. 새 글꼴이나 색상 없음. |
sfx.tsx | SFX, Sfx | 효과음 (위 참조) |
ui.tsx | Pop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal | 스프링 팝인, 하단 절반 패널, 타이핑된 터미널 |
scenes/Intro.tsx | Hook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak | 오프닝, 섹션 전환 |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard | 섹션당 하나의 주제: 상단 태그, Panel의 시각 자료 |
scenes/Commands.tsx (Day 2, 하드코딩된 텍스트) | IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch | 재사용하기 전에 텍스트에 대한 props 추가 |
scenes/Outro.tsx | DayDone({day}), NextDay({day, commands, at}), FollowCard({handle}) | 종료 (NextDay는 선택 사항) |
Reel.tsx | Reel | 전체 Day 1 릴스. 구조의 예로 사용합니다. |
텍스트를 변경할 때 크기, 색상 및 애니메이션을 유지합니다.