Communitygithub.com

tinh2/skills-hub-registry

Remotion(React)을 사용해 프로그래매틱 방식의 비디오를 제작합니다. 컴포지션, 애니메이션, 시퀀싱, 전환, 오디오/비디오 임베딩, 스프링 물리, 텍스트 애니메이션, ElevenLabs TTS 음성 해설, FFmpeg 통합, 자막, Three.js 3D, 차트 및 렌더링을 다룹니다. 공식 Remotion 모범 사례를 기반으로 합니다.

skills-hub-registry란 무엇인가요?

이 스킬은 개발자가 React 구성 요소를 사용하여 프로그래매틱 방식의 동영상을 만들 수 있는 강력한 프레임워크인 Remotion을 사용하기 위한 포괄적인 가이드와 모범 사례를 제공합니다. 이 스킬은 기본 프로젝트 설정, 컴포지션 정의, `useCurrentFrame()`과 `interpolate()`를 사용한 필수 애니메이션 기술, 그리고 자연스러운 물리 기반 모션을 위한 스프링 애니메이션과 같은 핵심 개념을 다룹니다. `Sequence`와 `Series`를 사용한 시퀀싱, `@remotion/transitions`를 사용한 전환 및 오버레이, `<Audio>` 및 `<OffthreadVideo>`를 사용한 미디어 임베딩에 대해 자세히 설명합니다. 또한 ElevenLabs TTS를 사용한 음성 해설 생성, FFmpeg 통합, `staticFile()`을 사용한 자산 로딩에 대한 지침도 포함되어 있으며, 최종 렌더링 명령어도 제공합니다. Cursor, Claude Code, Codex 등 AI 코딩 도우미를 위해 설계된 이 스킬은 CSS 애니메이션 금지, 자산 로딩을 위한 항상 `staticFile()` 사용, 더 나은 렌더링 성능을 위해 `<OffthreadVideo>` 사용 등 중요한 규칙을 적용하여 안정적이고 성능이 뛰어난 동영상 제작을 보장합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/tinh2/skills-hub-registry/tree/HEAD/build/remotion

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

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

문서

Remotion -- React로 비디오 만들기

이 스킬은 Remotion 코드 작업 시 사용하세요. Remotion을 사용하면 React 컴포넌트로 프로그래매틱 방식의 비디오를 만들 수 있습니다.

프로젝트 설정

npx create-video@latest my-video
cd my-video
npm start        # 브라우저에서 미리보기
npm run render   # MP4로 렌더링

컴포지션

<Composition>은 크기, FPS, 지속 시간을 가진 렌더링 가능한 비디오를 정의합니다.

import { Composition } from "remotion";
import { MyVideo } from "./MyVideo";

export const RemotionRoot = () => (
  <Composition
    id="MyVideo"
    component={MyVideo}
    durationInFrames={300}
    fps={30}
    width={1920}
    height={1080}
    defaultProps={{ title: "Hello World" } satisfies MyVideoProps}
  />
);

defaultProps 타입 안전성을 위해 interface 대신 type 선언을 사용하세요.

사이드바에서 컴포지션을 구성하려면 <Folder>를 사용하세요. 단일 프레임 출력(썸네일, OG 이미지)에는 <Still>을 사용하세요.

애니메이션

모든 애니메이션은 반드시 useCurrentFrame()을 사용해야 합니다. CSS 전환과 Tailwind 애니메이션 클래스는 금지됩니다. 올바르게 렌더링되지 않습니다.

import { useCurrentFrame, useVideoConfig, interpolate } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

스프링 애니메이션

스프링은 자연스러운 움직임을 제공합니다. 0에서 1로 애니메이션됩니다.

import { spring, useCurrentFrame, useVideoConfig } from "remotion";

const frame = useCurrentFrame();
const { fps } = useVideoConfig();

const scale = spring({ frame, fps });
// 설정 포함:
const smooth = spring({ frame, fps, config: { damping: 200 } }); // 튕김 없음
const snappy = spring({ frame, fps, config: { damping: 20, stiffness: 200 } });
const bouncy = spring({ frame, fps, config: { damping: 8 } });
const heavy  = spring({ frame, fps, config: { damping: 15, stiffness: 80, mass: 2 } });

delay 매개변수를 사용하여 스프링 시작을 지연시킵니다:

const entrance = spring({ frame, fps, delay: 20 });

보간

// 선형 보간 및 클램핑
const opacity = interpolate(frame, [0, 100], [0, 1], {
  extrapolateRight: "clamp",
  extrapolateLeft: "clamp",
});

// 다중 단계 보간
const y = interpolate(frame, [0, 30, 60, 90], [100, 0, 0, -100]);

시퀀싱

Sequence

<Sequence>를 사용하여 요소가 나타나는 시점을 지연시킵니다. 구성 요소를 미리 로드하려면 항상 premountFor를 사용하세요.

import { Sequence } from "remotion";

const { fps } = useVideoConfig();

<Sequence from={1 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Subtitle />
</Sequence>

절대 위치 지정 래퍼를 방지하려면 layout="none"을 사용하세요.

Series

겹침 없이 순차 재생을 위해 <Series>를 사용하세요:

import { Series } from "remotion";

<Series>
  <Series.Sequence durationInFrames={45}><Intro /></Series.Sequence>
  <Series.Sequence durationInFrames={60}><MainContent /></Series.Sequence>
  <Series.Sequence durationInFrames={30}><Outro /></Series.Sequence>
</Series>

음수 offset은 겹치는 전환을 만듭니다:

<Series.Sequence offset={-15} durationInFrames={60}>
  <SceneB />
</Series.Sequence>

전환

npx remotion add @remotion/transitions
import { TransitionSeries, linearTiming } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
import { wipe } from "@remotion/transitions/wipe";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Transition
    presentation={fade()}
    timing={linearTiming({ durationInFrames: 15 })}
  />
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

라이트 릭 오버레이

import { LightLeak } from "@remotion/light-leaks";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Overlay durationInFrames={20}>
    <LightLeak />
  </TransitionSeries.Overlay>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

오버레이는 전환 또는 다른 오버레이와 인접할 수 없습니다.

오디오

npx remotion add @remotion/media
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

// 기본 오디오
<Audio src={staticFile("audio.mp3")} />

// 트리밍 (값은 프레임 단위)
<Audio src={staticFile("audio.mp3")} trimBefore={2 * fps} trimAfter={10 * fps} />

// 볼륨 제어
<Audio src={staticFile("audio.mp3")} volume={0.5} />

// 동적 볼륨 (콜백은 프레임을 받음)
<Audio src={staticFile("audio.mp3")} volume={(f) =>
  interpolate(f, [0, 30], [0, 1], { extrapolateRight: "clamp" })
} />

// 속도 변경
<Audio src={staticFile("audio.mp3")} playbackRate={1.5} />

// 오디오 시작 지연
<Sequence from={1 * fps}>
  <Audio src={staticFile("audio.mp3")} />
</Sequence>

여러 개의 <Audio> 구성 요소는 자동으로 레이어링됩니다.

비디오 임베딩

import { Video } from "@remotion/media";

// 기본 비디오
<Video src={staticFile("video.mp4")} />

// 트리밍 포함
<Video src={staticFile("video.mp4")} trimBefore={2 * fps} trimAfter={10 * fps} />

// 속도, 볼륨, 반복
<Video src={staticFile("video.mp4")} playbackRate={2} volume={0.5} loop />

// 렌더링 성능을 위해 OffthreadVideo 사용
import { OffthreadVideo } from "remotion";
<OffthreadVideo src={staticFile("video.mp4")} />

렌더링 성능을 위해 항상 <OffthreadVideo>를 사용하세요. <Video>는 미리보기 중에만 사용하세요.

ElevenLabs TTS를 사용한 음성 해설

씬별로 음성을 생성한 다음 calculateMetadata를 사용하여 컴포지션의 크기를 동적으로 조정합니다.

오디오 생성

const response = await fetch(
  `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`,
  {
    method: "POST",
    headers: {
      "xi-api-key": process.env.ELEVENLABS_API_KEY!,
      "Content-Type": "application/json",
      Accept: "audio/mpeg",
    },
    body: JSON.stringify({
      text: "어서 오세요.",
      model_id: "eleven_multilingual_v2",
      voice_settings: { stability: 0.5, similarity_boost: 0.75, style: 0.3 },
    }),
  },
);
const audioBuffer = Buffer.from(await response.arrayBuffer());
writeFileSync(`public/voiceover/scene-01.mp3`, audioBuffer);

동적 지속 시간

import { CalculateMetadataFunction, staticFile } from "remotion";

const FPS = 30;
const SCENES = ["voiceover/scene-01.mp3", "voiceover/scene-02.mp3"];

export const calculateMetadata: CalculateMetadataFunction<Props> = async () => {
  const durations = await Promise.all(
    SCENES.map((file) => getAudioDuration(staticFile(file)))
  );
  const totalFrames = durations.reduce((sum, d) => sum + Math.ceil(d * FPS), 0);
  return { durationInFrames: totalFrames };
};

자산

파일을 public/에 배치하고 staticFile()로 참조합니다:

import { staticFile, Img } from "remotion";

<Img src={staticFile("logo.png")} />

미디어 파일에 절대 require() 또는 import를 사용하지 마세요. 항상 staticFile()을 사용하세요.

글꼴

import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();

// 또는 로컬 글꼴
const { fontFamily } = loadFont({
  url: staticFile("fonts/MyFont.woff2"),
  display: "swap",
});

Remotion에서 FFmpeg

FFmpeg는 번들로 제공되며 별도 설치가 필요 없습니다:

bunx remotion ffmpeg -i input.mp4 output.mp3
bunx remotion ffprobe input.mp4

트리밍의 경우 FFmpeg보다는 trimBefore/trimAfter props를 선호합니다. 형식 변환 또는 Remotion이 기본적으로 할 수 없는 작업에는 FFmpeg를 사용하세요.

FFmpeg를 사용하여 트리밍할 때는 프레임이 정지되는 것을 방지하기 위해 반드시 다시 인코딩해야 합니다:

bunx remotion ffmpeg -ss 00:00:05 -i public/input.mp4 -to 00:00:10 -c:v libx264 -c:a aac public/output.mp4

렌더링

# 특정 컴포지션 렌더링
npx remotion render MyVideo output.mp4

# 스틸 프레임 렌더링
npx remotion still MyVideo --frame=100 thumbnail.png

# 사용자 지정 props 사용
npx remotion render MyVideo output.mp4 --props='{"title": "Custom"}'

# 특정 코덱
npx remotion render MyVideo output.webm --codec=vp8

일반적인 패턴

씬 기반 비디오

const SCENES = [
  { component: TitleScene, duration: 90 },
  { component: ProblemScene, duration: 150 },
  { component: SolutionScene, duration: 120 },
  { component: CTAScene, duration: 90 },
];

export const MyVideo = () => {
  let offset = 0;
  return (
    <>
      {SCENES.map(({ component: Component, duration }, i) => {
        const from = offset;
        offset += duration;
        return (
          <Sequence key={i} from={from} durationInFrames={duration}>
            <Component />
          </Sequence>
        );
      })}
    </>
  );
};

배경 음악 + 음성 해설

<>
  {/* 배경 음악 (낮은 볼륨) */}
  <Audio src={staticFile("music/bg.mp3")} volume={0.12} loop />

  {/* 씬 음성 해설 (전체 볼륨) */}
  <Sequence from={0} durationInFrames={scene1Frames}>
    <Audio src={staticFile("voiceover/scene-01.mp3")} volume={1} />
  </Sequence>
  <Sequence from={scene1Frames} durationInFrames={scene2Frames}>
    <Audio src={staticFile("voiceover/scene-02.mp3")} volume={1} />
  </Sequence>
</>

주요 규칙

  1. CSS 애니메이션 금지 -- 모든 움직임은 useCurrentFrame() + interpolate()/spring() 사용
  2. Tailwind 애니메이션 클래스 금지 -- 올바르게 렌더링되지 않음
  3. 자산은 항상 staticFile() -- require() 사용 금지
  4. Sequence는 항상 premountFor로 미리 마운트
  5. 렌더링에는 <OffthreadVideo> 사용 <video> 사용 금지
  6. 지속 시간을 초 단위로 작성하고 fps를 곱하여 사용
  7. defaultProps 타입 안전성을 위해 satisfies 키워드 사용

출처: remotion-dev/skills, remotion.dev

관련 스킬