Remotion — React로 비디오 만들기은(는) 무엇을 하나요?
출처: remotion-dev/remotion · 43.6k ⭐ · v4.x · 🟢 2026년 활발히 개발 중 NPM:
remotion·@remotion/cli·@remotion/player·@remotion/lambda문서: https://www.remotion.dev/
1. 핵심 개념
- 비디오는 프레임 단위로 렌더링되는 React 컴포넌트 시퀀스입니다.
frame번호(0 → N)와 빈 캔버스가 주어지며, 나머지는 CSS / SVG / Canvas / WebGL로 구성합니다.- Remotion은 React를 일련의 PNG/JPEG 프레임으로 컴파일한 후, FFmpeg를 통해 MP4로 인코딩합니다.
2. 사용 시기
- 프로그래매틱 비디오 생성 (설명 비디오, 개인화 비디오 광고, 데이터 기반 비디오)
- 연말 리캡 / 통계 비디오 (GitHub Unwrapped, Spotify Wrapped 등)
- 텍스트 + 데이터로 제작된 마케팅 설명 비디오 (AE/Premiere에서 수동 편집하지 않음)
- 코드로 생성되는 개발자 도구 / 튜토리얼 비디오
사용하지 말아야 할 때
- 실사 비디오 편집 (Premiere / Final Cut 사용)
- 전통적인 모션 그래픽 (After Effects가 더 효율적임)
- 일회성 비디오 — 오버헤드가 가치를 상회함
3. 설치 (새 프로젝트)
npx create-video@latest my-video
cd my-video
npm install
npm start # Remotion Studio 실행
제공되는 템플릿
- Hello World
- TypeScript
- JavaScript
- React 18 / 19
- Audiogram
- Stargazer (GitHub 스타 애니메이션)
- Three.js
- Empty
기존 프로젝트에 추가
npm install remotion @remotion/cli
src/Root.tsx 생성:
import { Composition } from 'remotion';
import { MyVideo } from './MyVideo';
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
defaultProps={{ title: 'Hello' }}
/>
);
};
remotion.config.ts에서 루트 등록:
import { Config } from '@remotion/cli/config';
Config.setEntryPoint('./src/index.ts');
4. 핵심 개념
<Composition />
비디오를 정의합니다: 어떤 컴포넌트를 렌더링할지, 지속 시간, FPS, 해상도, 기본 속성을 지정합니다.
useCurrentFrame()
현재 프레임 번호(0부터 시작)를 반환합니다. 모든 애니메이션은 이 값을 기반으로 합니다:
import { useCurrentFrame, useVideoConfig, interpolate } from 'remotion';
export const MyVideo: React.FC<{ title: string }> = ({ title }) => {
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: 'clamp' });
return (
<div style={{ flex: 1, backgroundColor: '#0a0a0f', color: 'white', opacity, display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
<h1 style={{ fontSize: 120 }}>{title}</h1>
</div>
);
};
interpolate(frame, [from, to], [startVal, endVal], options)
프레임 번호를 모든 값(위치, 불투명도, 배율, 색상 등)에 매핑합니다.
spring(...)
자연스러운 모션 곡선:
import { spring, useCurrentFrame, useVideoConfig } from 'remotion';
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const scale = spring({
frame,
fps,
config: { damping: 100, stiffness: 200, mass: 0.5 },
});
<div style={{ transform: `scale(${scale})` }}>Content</div>
<Sequence from={f} durationInFrames={n}>
컴포넌트가 특정 프레임 f에서 시작하도록 오프셋:
import { Sequence } from 'remotion';
<Sequence from={0} durationInFrames={60}><Intro /></Sequence>
<Sequence from={60} durationInFrames={120}><Scene1 /></Sequence>
<Sequence from={180} durationInFrames={90}><Outro /></Sequence>
<Audio src={...} />
import { Audio } from 'remotion';
import bgMusic from './music.mp3';
<Audio src={bgMusic} volume={0.5} />
<Img src={...} /> / <Video src={...} />
이미지/비디오 클립을 타임라인에 임베드합니다.
staticFile('...')
public/ 디렉토리의 파일 참조 — Remotion이 경로를 처리합니다:
import { staticFile } from 'remotion';
<Img src={staticFile('logo.svg')} />
5. 렌더링
로컬 렌더링 (CLI)
npx remotion render MyVideo out/video.mp4
npx remotion render MyVideo out/video.mp4 --props='{"title":"Hello"}'
npx remotion render MyVideo out/video.mp4 --quality=high --codec=h265
Remotion Studio (미리보기 + 타임라인)
npm start # http://localhost:3000 실행
Remotion Player (React 앱에 임베드)
import { Player } from '@remotion/player';
import { MyVideo } from './MyVideo';
<Player
component={MyVideo}
durationInFrames={150}
fps={30}
compositionWidth={1920}
compositionHeight={1080}
inputProps={{ title: 'Hello' }}
controls
style={{ width: '100%' }}
/>
Remotion Lambda (클라우드 렌더링)
배치/서버 측 렌더링용:
npm install @remotion/lambda
AWS Lambda 함수 설정, Remotion 배포:
npx remotion lambda functions deploy
npx remotion lambda sites create
npx remotion lambda render MyVideo --input-props='{"title":"User 123"}'
6. 예제 — 데이터 기반 비디오
개인화된 "Year in Review" 비디오 생성:
import { Composition } from 'remotion';
import { YearInReview } from './YearInReview';
export const RemotionRoot = () => (
<Composition
id="Recap"
component={YearInReview}
durationInFrames={8 * 30} // 30fps에서 8초
fps={30}
width={1080}
height={1920} // 세로 (모바일)
defaultProps={{
user: { name: 'Alice', stats: { commits: 1284, prs: 42, reviews: 89 } },
}}
/>
);
각 사용자별 렌더링:
for user in $(cat users.json); do
npx remotion lambda render Recap --input-props="$user"
done
7. 가격 / 라이선스
| 티어 | 대상 | 가격 |
|---|---|---|
| 개인 / 팀 ≤ 3명 | 개인, 소규모 회사 | 무료 (MIT 유사) |
| 회사 ≤ 10명 | 소규모 스타트업 | 무료 |
| 대규모 회사 | 10명 초과 | $100/월 + $25/좌석 |
| Editor Starter | Remotion으로 나만의 비디오 편집기 구축 | $600 (일회성) |
| Lambda | 클라우드 렌더링 | 렌더링 당 지불 (비디오 1분당 약 몇 센트) |
공식 조건은 https://www.remotion.dev/docs/license 참조.
8. 금지 사항
- ❌ 실시간 비디오 재생 엔진에 Remotion 사용 금지 — 파일 렌더링용으로 설계, 라이브 스트리밍용 아님
- ❌ 번들에 100MB 이상의 실제 비디오 파일 포함 금지 — 대용량 미디어는
staticFile()로 별도 호스팅 - ❌ Remotion 컴포넌트 내에서
setTimeout,setInterval,requestAnimationFrame사용 금지 — 결정성은useCurrentFrame()으로만 보장 - ❌ 렌더링 중 데이터 가져오기 금지 — 미리 가져와서
inputProps로 전달 - ❌ 필요 이상으로 많은 프레임을 가진 컴포넌트 렌더링 금지 — 각 프레임은 렌더링 시간 소모
- ❌ 팀 3명 초과 시 라이선스 없이 상용 Lambda 렌더링 전송 금지
- ❌ 직접
Math.random()사용 금지 — 출력이 결정적이지 않음. Remotion의random()을 시드와 함께 사용 - ❌ CSS 트랜지션으로 애니메이션 금지 — Remotion은 프레임 단위로 렌더링; CSS 트랜지션 적용 안 됨.
interpolate()+ frame 사용
9. 실행 전 체크리스트
- [ ] remotion + @remotion/cli 설치
- [ ] src/Root.tsx에 <Composition />으로 비디오 정의
- [ ] 모든 애니메이션이 useCurrentFrame()으로 구동 — setTimeout/setInterval 없음
- [ ] 무작위 값은 Remotion의 random()을 시드와 함께 사용 (Math.random 아님)
- [ ] 폰트 로딩: useFont 또는 <link>를 <head>에 추가
- [ ] 오디오 파일은 <Audio>로 적절한 볼륨/트림 설정
- [ ] 프로덕션용: Lambda 또는 remotion render CLI로 렌더링
- [ ] 가격 확인 — 팀 규모에 맞는 티어 선택
- [ ] 각 Composition에 대해 inputProps 타입 지정 (TypeScript)
- [ ] 전체 렌더링 전에 짧은 미리보기 테스트 렌더링
10. 다이얼 핏
비디오 디자인에 전적으로 의존 — Remotion은 프레임워크이지 시각 라이브러리가 아닙니다.
11. DesignDNA와의 통합
Remotion은 DesignDNA의 브랜드 DNA와 잘 결합됩니다: DESIGN.md 토큰(색상, 폰트, 간격)을 생성된 비디오의 시각적 언어로 사용합니다. 예:
import { tokens } from '../design-md/stripe/tokens';
<div style={{ color: tokens.colors['stripe-purple'], fontFamily: tokens.typography.families[0] }}>
Stripe 브랜드 인트로
</div>
이렇게 하면 "연말 리캡" 비디오가 브랜드 시각적 정체성과 일치합니다.
12. 대안
| 시나리오 | 대안 |
|---|---|
| 전통적인 비코드 비디오 | Adobe After Effects / Premiere |
| 데이터 시각화 비디오 | D3 + 화면 녹화 OR Remotion + D3 |
| 애니메이션 React 컴포넌트 (전체 비디오 아님) | Framer Motion · Motion · React Bits (스킬 참조) |
| 인터랙티브 웹 애니메이션 | Lottie · GSAP |