사용 시기
다음과 같은 경우 이 스킬을 사용하세요:
- 코드로 프로그래매틱 영상 만들기 (생성형 AI 영상이 아님)
- 데이터 기반 영상 콘텐츠 제작 (차트, 통계, 개인화 영상)
- 템플릿 + 데이터로 영상 일괄 제작
- 애니메이션 소셜 콘텐츠 (TikTok, Reels, Shorts) 만들기
- 정밀 제어가 필요한 제품/설명 영상 만들기
빠른 시작
1. 새 프로젝트 만들기
python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video
2. 컴포지션 작성하기
src/Composition.tsx 파일을 편집하세요. 이 파일이 React 컴포넌트로 정의된 영상입니다.
3. 스튜디오에서 미리보기
python3 Skills/remotion/scripts/remotion_cli.py studio my-video
4. MP4로 렌더링
python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4
핵심 개념
컴포지션
컴포지션은 영상의 해상도, 길이, FPS를 정의합니다:
<Composition
id="MyVideo"
component={MyComponent}
durationInFrames={300} // 30fps 기준 10초
fps={30}
width={1920}
height={1080}
/>
프레임 기반 애니메이션
모든 애니메이션은 반드시 useCurrentFrame()을 사용해야 합니다. CSS 애니메이션은 금지됩니다.
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
시퀀스
<Sequence>를 사용해 요소가 나타나는 타이밍을 조절합니다:
<Sequence from={30} durationInFrames={60}>
<Title />
</Sequence>
규칙 참조
자세한 패턴은 다음 파일들을 참조하세요 (상위 Remotion 스킬에서 로드됨):
| 규칙 | 설명 |
|---|---|
references/animations.md | 프레임 기반 애니메이션 기본 |
references/timing.md | 스프링, 이징, 보간 곡선 |
references/compositions.md | 컴포지션, 스틸, 폴더 정의 |
references/sequencing.md | 요소 타이밍 및 순서 지정 |
references/videos.md | 비디오 임베딩 - 트림, 볼륨, 속도 |
references/audio.md | 오디오 처리 - 가져오기, 트림, 볼륨 |
references/assets.md | 이미지, 폰트, 정적 파일 |
references/transitions.md | 장면 전환 |
references/text-animations.md | 타이포그래피 애니메이션 패턴 |
references/charts.md | 데이터 시각화 패턴 |
references/display-captions.md | TikTok 스타일 자막 |
CLI 명령어
# 프로젝트 관리
python3 Skills/remotion/scripts/remotion_cli.py new <이름> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <이름>
python3 Skills/remotion/scripts/remotion_cli.py render <이름> [--composition ID] [--output 경로]
python3 Skills/remotion/scripts/remotion_cli.py list
# 렌더링 옵션
--composition ID # 렌더링할 특정 컴포지션 (기본값: 첫 번째)
--output PATH # 출력 파일 경로 (기본값: out/video.mp4)
--fps N # FPS 재정의
--width N # 너비 재정의
--height N # 높이 재정의
--codec CODEC # h264, h265, vp8, vp9, prores (기본값: h264)
일반 패턴
페이드 인/아웃
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
스프링 애니메이션 (자연스러운 움직임)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // 부드럽고 바운스 없음
});
요소 지연 등장
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
데이터 기반 영상
type VideoProps = { title: string; stats: number[] };
export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
// props 기반 애니메이션
};
// Root.tsx:
<Composition
id="DataVideo"
component={DataVideo}
defaultProps={{ title: "Q4 실적", stats: [10, 20, 30] }}
// ...
/>
Zo와의 통합
일괄 렌더링
/zo/ask를 사용해 여러 영상을 병렬 렌더링합니다:
for row in data:
# 각 호출은 다른 props로 렌더링
await render_video(row)
출력 위치
프로젝트는 Zo의 사이트 시스템과 일관성을 위해 Sites/<프로젝트명>/에 저장됩니다.
렌더링된 영상은 Sites/<프로젝트명>/out/에 출력됩니다.
제약 사항
- CSS 애니메이션 없음 - 올바르게 렌더링되지 않습니다
- Tailwind 애니메이션 클래스 없음 - 같은 문제
- 프레임 기반만 가능 - 모든 움직임은
useCurrentFrame()에서 비롯되어야 함 - CPU 집약적 - 렌더링에 시간이 걸리며 복잡한 영상일수록 더 오래 걸림
- Node.js 필요 - Remotion은 Node 환경을 필요로 함 (Zo에 이미 포함됨)