Remotion Controls Skill
코드로 비디오 애니메이션을 구동하는 전문 제어 스킬입니다. Remotion은 React 기반의 비디오 제작 프레임워크로, 코드로 모든 프레임을 정밀하게 제어하고 투명 배경 렌더링을 기본 지원합니다.
핵심 기능
| 기능 | 설명 |
|---|---|
| 투명 배경 렌더링 | 알파 채널을 기본 지원하며, WebM(VP9) / MOV(ProRes 4444) 투명 비디오 출력 |
| 코드 정밀 제어 | React/TypeScript로 위치, 확대/축소, 회전, 투명도, 이징 곡선 정밀 제어 |
| API 서비스화 | HTTP API로 애니메이션 지시를 받아 비디오 파일 출력 |
| 템플릿 라이브러리 | 사전 설정 애니메이션 템플릿 (캐릭터 애니메이션, UI 애니메이션, 텍스트 애니메이션, 전환 효과) |
| 품질 관리 | 프레임 레이트, 해상도, 비트레이트, 알파 채널 무결성 자동 검사 |
| 자가 학습 진화 | 렌더링 매개변수와 효과 점수를 기록하여 사전 설정 매개변수 최적화 |
ComfyUI / Blender와의 차별점
| 스킬 | 핵심 강점 | 적용 분야 |
|---|---|---|
| ComfyUI-controls | AI 생성 (이미지/비디오/오디오), 창의성 통제 불가 | 캐릭터 이미지/씬 이미지/특수 효과 비디오 생성 |
| Blender-controls | 3D 애니메이션, 물리 시뮬레이션, 고품질 렌더링 | 3D 캐릭터 애니메이션, 제품 프레젠테이션, 물리 특수 효과 |
| Remotion-controls | 2D 코드 애니메이션, 정밀 제어 가능, 투명 배경 | 템플릿 애니메이션 소재, UI 애니메이션, 텍스트 레이아웃, 2D 캐릭터 애니메이션 |
빠른 시작
1. 종속 항목 설치
cd remotion-project
npm install
2. 투명 배경 비디오 렌더링
# CLI 방식
npx remotion render src/index.ts MyComp out/video.webm --transparent
# API 방식
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent
3. API 서비스 시작
python remotion_controls.py serve --port 8765
투명 배경 렌더링 설명 (검증된 프로세스)
Remotion은 투명 배경을 기본 지원하지만, CLI의 --transparent 인코딩은 알파 채널이 손실됩니다 (WebM VP8/VP9, MOV ProRes 모두 검증 실패).
검증된 올바른 프로세스 (PIT-024):
- PNG 시퀀스 렌더링:
npx remotion render src/index.ts Composition out/frames --sequence(알파 채널이 포함된 PNG 시퀀스 출력) - ffmpeg로 ProRes 4444 합성:
ffmpeg -y -framerate 30 -i out/frames/%04d.png \ -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \ out/animation.mov - 알파 채널 검증:
python verify_animation.py out/animation.mov
컷편집 통합 시 주의 사항 (PIT-024):
add_media_safe로 ProRes 4444 mov를 가져오면 자동으로 H.264 mp4로 트랜스코딩되어 알파 채널이 손실됨 (66MB → 0.07MB)- 수동으로 가져와야 함: mov를 초안 materials 디렉터리에 직접 복사 → VideoMaterial 생성 → materials.videos에 등록 → VideoSegment(material=anim_material) → add_segment
애니메이션 소재 품질 기준
전체 기준은 QUALITY_STANDARD.md를 참조하세요.
적격 애니메이션 소재의 필수 지표:
- 알파 채널 유지 (yuva444p12le)
- ProRes 4444 인코딩 (profile=4)
- 해상도/프레임 레이트/길이가 설정과 일치
- 콘텐츠 커버리지 ≥ 50% (10포인트 샘플링)
- 파일 크기 적절 (≤15MB/초)
자동화 검증:
python verify_animation.py <애니메이션 파일> --duration 20 --width 1080 --height 1920
기본 애니메이션 컴포넌트 라이브러리
remotion-project/src/components/에 위치하며, 모든 컴포넌트는 투명 배경을 지원합니다.
캐릭터 및 모션 컴포넌트
| 컴포넌트 | 설명 |
|---|---|
| CharacterSprite | 캐릭터 스프라이트: 다중 포즈 전환, 위치/확대/회전/투명도 키프레임 애니메이션 |
| MotionPath | 모션 경로: 선형/베지어/탄성/바운스 모션 |
| FlashEffect | 화면 플래시 효과: 빠르게 페이드 인, 천천히 페이드 아웃 |
| ShakeEffect | 진동 효과: 진폭 감쇠 무작위 진동 |
| FadeEffect | 페이드 인/아웃: 제어 가능한 페이드 인/아웃 시간 |
| PopEffect | 팝업 효과: 탄성 확대/축소 팝업 |
| SlideEffect | 슬라이드 효과: 네 방향으로 이징 슬라이드 |
텍스트 애니메이션 컴포넌트 (TextAnimations.tsx)
| 컴포넌트 | 설명 | 적용 분야 |
|---|---|---|
| TextReveal | 문자별 나타나기: 타자기/페이드 인/위로 슬라이드/왼쪽으로 슬라이드 | 내레이션, 대사, 제목 등장 |
| TextPop | 팝업 텍스트: 확대/회전/바운스 | 키워드 강조, 비트 포인트 |
| TextWave | 웨이브 텍스트: 문자별 사인파 부동 | 재미있는 스타일, 배경 음악 리듬 |
| TextGlitch | 글리치 스타일: RGB 분리+떨림 | 테크 감성, 글리치 아트, 전환 |
| TextGradient | 그라데이션 광택: 색상 흐름+스캔 라이트 | 제목, 브랜드명, 고급감 |
| KineticText | 다이나믹 타이포그래피: 여러 줄 조합 애니메이션 | 오프닝 타이틀, 엔딩 크레딧 |
전환 효과 컴포넌트 (TransitionEffects.tsx)
| 컴포넌트 | 설명 | 적용 분야 |
|---|---|---|
| FadeTransition | 페이드 인/아웃 전환 (in/out/inOut) | 일반 전환, 감정적 이행 |
| SlideTransition | 슬라이드 전환 (상하좌우) | 장면 전환, 콘텐츠 교체 |
| ZoomTransition | 확대/축소 전환 (밀어넣기/당기기) | 강조 포인트, 카메라 추진 |
| WipeTransition | 지우기 전환 (상하좌우/대각선) | 창의적 전환, 스타일화 |
| BlurTransition | 블러 전환 (먼저 흐리게 후 선명하게) | 몽환적 이행, 회상 플래시백 |
| GlitchTransition | 글리치 전환 (RGB 분리+스캔 라인) | 테크 감성, 글리치 아트 |
임팩트 효과 컴포넌트 (ImpactEffects.tsx)
| 컴포넌트 | 설명 | 적용 분야 |
|---|---|---|
| PunchImpact | 펀치 임팩트 (충격파+별+화이트 플래시) | 격투, 타격, 충돌 |
| ImpactFlash | 임팩트 플래시 (빠른 화이트 플래시) | 강타, 폭발, 비트 포인트 |
| ParticleBurst | 파티클 버스트 (별/불꽃/파편) | 축하, 폭발, 충격 |
| Shockwave | 충격파 (다중 링 확산) | 에너지 방출, 폭발, 진동 |
| SpeedLines | 속도선 (방사형) | 고속 충격, 질주, 연속타 |
사용 예시:
import { PunchImpact, ParticleBurst, FadeTransition } from "./components";
// 격투 장면
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />
사용 예시:
import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";
<CharacterSprite
poses={[
{ name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
{ name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
]}
width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="맞았어!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="아야!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />
프로젝트 구조
remotion-controls-skill/
├── SKILL.md # 본 파일
├── QUALITY_STANDARD.md # 애니메이션 소재 품질 기준
├── verify_animation.py # 자동화 검증 도구
├── remotion_controls.py # 메인 제어 스크립트 (CLI/API)
├── .env.example # 환경 변수 예시
├── .gitignore
├── capabilities/
│ ├── cap_api_wrapper/ # Remotion API 래퍼
│ ├── cap_animation_renderer/ # 애니메이션 렌더러
│ ├── cap_template_library/ # 애니메이션 템플릿 라이브러리
│ ├── cap_quality_control/ # 품질 관리
│ └── cap_self_evolution/ # 자가 학습 진화
├── remotion-project/ # Remotion 프로젝트
│ ├── src/
│ │ ├── components/ # 기본 애니메이션 컴포넌트 라이브러리
│ │ │ ├── CharacterSprite.tsx
│ │ │ ├── MotionPath.tsx
│ │ │ ├── Effects.tsx
│ │ │ └── index.ts
│ │ ├── AnimationTemplate.tsx # JSON 기반 애니메이션 템플릿
│ │ ├── Root.tsx
│ │ └── index.ts
│ ├── public/ # 정적 소재 (캐릭터/소품 이미지)
│ └── package.json
└── out/ # 렌더링 출력
기능 모듈
cap_api_wrapper — Remotion API 래퍼
render_media(): 비디오 렌더링 (투명 배경 지원)render_still(): 단일 프레임 이미지 렌더링select_composition(): 사용 가능한 Composition 목록 가져오기get_props_schema(): Composition의 Props 정의 가져오기
cap_animation_renderer — 애니메이션 렌더러
- 입력 애니메이션 명령 JSON → 투명 배경 비디오 출력
- 키프레임 애니메이션 지원 (위치/확대/회전/투명도)
- 이징 곡선 지원 (ease-in/ease-out/ease-in-out/linear/spring)
- 다중 레이어 합성 지원
cap_template_library — 애니메이션 템플릿 라이브러리
- 캐릭터 애니메이션 템플릿 (두바오 맞기, 표정 전환 등)
- UI 애니메이션 템플릿 (버튼 클릭, 페이지 전환 등)
- 텍스트 애니메이션 템플릿 (타자기, 페이드 인/아웃, 바운스 등)
- 전환 효과 템플릿 (페이드 인/아웃, 슬라이드, 확대 등)
cap_quality_control — 품질 관리
- 프레임 레이트 검사 (24/30/60fps)
- 해상도 검사 (1080p/4K)
- 알파 채널 무결성 검사
- 비디오 길이와 예상치 비교
- 파일 크기 적절성 확인
cap_self_evolution — 자가 학습 진화
- 렌더링 매개변수와 효과 점수 기록
- 사전 설정 매개변수 최적화
- 모범 사례 문서 생성
- 템플릿 효과 순위표
환경 변수
REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765
ai-video-editor와의 통합
Remotion-controls-skill은 ai-video-editor의 애니메이션 소재 제작 도구로 사용됩니다:
- ai-video-editor의 디렉터 엔진이 애니메이션 명령 출력
- Remotion-controls-skill이 명령을 수신하여 투명 배경 비디오 렌더링
- 투명 배경 비디오가 컷편집 템플릿의 애니메이션 소재 레이어로 사용됨
- 사용자가 배경을 교체하면 애니메이션이 완벽하게 오버레이됨
주의 사항
- Remotion은 Node.js 18+ 환경이 필요합니다.
- 투명 배경 비디오는 WebM 형식을 권장합니다 (컷편집 호환성 우수).
- 긴 비디오 렌더링 시간이 오래 걸리므로, 구간별로 렌더링 후 합성하는 것을 권장합니다.
- 애니메이션에서 CSS 필터 사용을 피하세요 (일부 필터는 투명 배경을 지원하지 않음).