Communitygithub.com

Remotion — React로 비디오 만들기

Remotion은 React 컴포넌트를 사용하여 프로그래매틱 방식으로 비디오를 생성하는 프레임워크입니다. React, CSS, Canvas, SVG를 활용하여 설명 비디오, 개인화 광고, 데이터 기반 비디오 등을 만들 수 있습니다.

Remotion — React로 비디오 만들기란 무엇인가요?

Remotion은 React 기반의 프로그래매틱 비디오 생성 프레임워크로, GitHub에서 43.6k 스타를 받은 활발한 오픈소스 프로젝트입니다. 개발자는 친숙한 React 컴포넌트와 JSX 문법을 사용하여 비디오를 제작할 수 있으며, useCurrentFrame() 훅으로 프레임 단위 애니메이션을 제어합니다. 주요 기능으로는 Composition을 통한 비디오 설정, interpolate()와 spring()을 활용한 자연스러운 모션, Sequence를 사용한 타임라인 구성, 그리고 Audio/Img/Video 컴포넌트를 통한 미디어 삽입이 포함됩니다. 로컬 렌더링 외에도 Remotion Player를 통해 React 앱에 비디오를 임베드하거나, Remotion Lambda를 사용하여 클라우드에서 대규모 배치 렌더링을 수행할 수 있습니다. 이 도구는 설명 비디오, 개인화 광고, 연말 리캡(예: GitHub Unwrapped)과 같은 데이터 기반 콘텐츠 제작에 이상적이며, 실시간 비디오 재생이나 CSS 트랜지션 사용과 같은 일반적인 실수를 피해야 합니다. 개인 및 소규모 팀(3인 이하)에게는 무료이며, 라이선스에 따라 추가 기능이 제공됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tiantangcao1980-web/DesignDNA-Skills/tree/HEAD/designdna/skills/remotion

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 StarterRemotion으로 나만의 비디오 편집기 구축$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

관련 스킬