Communitygithub.com

Remotion: コードで動画を作る

React コンポーネントを使ってプログラムで動画を構築、デバッグ、レンダリングします。Remotion(React ベースの動画フレームワーク)を利用します。

Remotion: コードで動画を作る とは?

このスキルは、React コンポーネントを動画フレームに変換するフレームワーク **Remotion** の操作を支援します。Remotion では、フレーム番号(`frame`)を唯一の時間軸とし、`useCurrentFrame()` を使ってアニメーションを駆動します。CSS トランジションや `setTimeout` はレンダリング時に非決定的な動作を引き起こすため使用しません。スキルは、`src/Root.tsx` での Composition 登録、`<Sequence>` によるタイムスライス、`<AbsoluteFill>` によるレイアウト、`interpolate` や `spring` を使ったアニメーション、CLI または `@remotion/renderer` / Lambda を使ったレンダリングまでをカバーします。また、`<OffthreadVideo>` の推奨や `delayRender()` / `continueRender()` の正しい使い方など、実践的なベストプラクティスも提供します。このスキルは、コードベースの動画作成、既存 Remotion プロジェクトの変更・デバッグ、Remotion エラーのトラブルシューティングに最適です。AI 動画生成(Veo, Sora, Runway, HeyGen)や ffmpeg による既存動画編集には使用しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbdelrhmanAlquran/claude-skills/tree/HEAD/remotion

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Remotion

Remotion は React コンポーネントを動画に変換します。JSX を記述すると、Remotion が固定の fps でフレームごとにコンポーネントを呼び出し、生成されたフレームを MP4(または他の形式)に結合します。

コアの考え方

Remotion はフレーム番号と空白のキャンバスを提供します。あなたの React コンポーネントがそのフレームに何を描画するかを決定します。

従来の命令型アニメーションタイムラインはありません。時間は 数値(frame)であり、コンポーネントはその数値と props の純関数です。そのため、アニメーションは useCurrentFrame() で駆動する必要があります。CSS トランジションや setTimeout はレンダリング中に非決定的になり、ちらつきや同期ずれを引き起こします。

このスキルを使うべき時

  • ユーザーが Remotion プロジェクト(remotion.config.ts または package.json 内の @remotion/*)を持っていて、Composition の構築、変更、デバッグをしたい場合
  • ユーザーが「Remotion で動画を作ろう / コードで / プログラムで」と言った場合
  • ユーザーが Remotion のエラーを貼り付けたり、interpolate、spring、Sequence、useCurrentFrame、Composition などについて質問した場合
  • ユーザーが既存の Remotion プロジェクトをレンダリングしたい、または Lambda レンダリングをセットアップしたい場合

使用すべきでない時

  • AI モデル(Veo, Sora, Runway, Kling, HeyGen)で動画を生成する場合 → video スキルを使用
  • 既存の動画ファイルを編集(カット/トリム/結合)する場合 → ffmpeg を使用(Remotion ではありません)
  • ライブ配信 → Remotion はオフラインレンダリングのみ

ワークフロー

  1. プロジェクトを検出またはスキャフォールドします。

    • 新規プロジェクト: npx create-video@latest(対話形式 — Hello World、Blank、JavaScript、TikTok などのテンプレートを選択)
    • 既存: remotion.config.ts、src/Root.tsx、package.json 内の @remotion/cli を確認。Remotion のメジャーバージョンに注意 — API は進化しており、適切なドキュメント URL は https://www.remotion.dev/docs(最新)またはバージョン固定のページになります。
  2. Composition を見つけるか作成します。 Composition は src/Root.tsx で <Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} /> を使って登録します。id は CLI がレンダリング時に名前指定するものです。

  3. useCurrentFrame + useVideoConfig を使用してコンポーネントを構築し、時間とメタデータを扱います。<AbsoluteFill> でレイアウトを構成し、<Sequence> で時間をスライスします。

  4. Studio でプレビュー: npx remotion studio(自動リロード)。フレームを単独で「テスト」しようとしないでください — Studio を開いてください。

  5. レンダリング: npx remotion render <CompositionId> [output.mp4]。デフォルトのコーデックは H.264 / MP4 です。フラグとプログラム API については references/rendering.md を参照してください。

クイック API リファレンス

詳細についてはリンク先のファイルを参照してください — タスクで必要になったときにのみ読み込んでください。

トピックファイル
Composition、フック、Sequence、AbsoluteFill、レイアウトreferences/core-concepts.md
interpolate、spring、Easing、スタガリング、一般的なアニメーションパターンreferences/animation.md
レンダリング: CLI フラグ、@remotion/renderer、Lambda、コーデック、propsreferences/rendering.md
音声/動画/画像: <Audio>、<Video>、<Img>、<OffthreadVideo>、キャプションreferences/media.md
プロジェクト設定、ファイル規約、remotion.config.tsreferences/project-setup.md
一般的なパターン: タイピングアニメーション、ローワーサード、データ駆動、パララックスreferences/patterns.md

厳格なルール

  1. useCurrentFrame() でアニメーションさせます。 setTimeout、requestAnimationFrame、CSS transition は絶対に使用しないでください。レンダリング中は各フレームがヘッドレスブラウザで独立してレンダリングされるため、これらはちらつきます。
  2. durationInFrames は必須で、整数でなければなりません。 合計秒数 = durationInFrames / fps。
  3. コンポーネントは純粋に保ちます。 トップレベルの副作用、決定論的シードなしの Math.random() は禁止 — 同じフレームは常に同じピクセルを生成しなければなりません。
  4. レンダリング中にフェッチしないでください。 delayRender() / continueRender() を使用してデータ読み込み中にフレームの準備ができるのをブロックするか、事前にフェッチして props で渡します。
  5. 可能な場合は <Video> ではなく <OffthreadVideo> を使用して、レンダリング中の動画読み込みを非ブロッキングにします(より高速、メモリ使用量が少ない)。
  6. 動的データは --props(CLI)または inputProps(Studio/プログラム)で渡し、ファイルを編集しないでください。

よくあるエラー

エラー / 症状原因修正
MP4 と Studio プレビューでモーションがちらつく / 一致しないCSS トランジションまたはフレーム駆動でないアニメーションを使用したinterpolate(frame, ...) または spring({ frame, fps }) に置き換える
「Composition not found」ID のタイポまたは <Composition> 登録の欠落src/Root.tsx を確認
レンダリングがハングする保留中の delayRender() が continueRender() を呼び出していない未解決の Promise を見つけ、try/finally を追加
長い動画でメモリ不足<Video> がフレームをメモリに保持している<OffthreadVideo> に切り替える
音声が同期しない音声ファイルの fps 不一致、または開始フレームが間違っている<Audio> を <Sequence from={...}> でラップ

確認

変更を行った後は、必ず以下を実行してください:

  • npx remotion studio を実行し、タイムラインをスクラブして、複数のフレーム(開始、中間、終了)で変更が正しく見えることを確認する
  • プログラムによる変更の場合は、短いテストセグメントをレンダリングする: npx remotion render <id> out.mp4 --frames=0-60
  • 型チェック: プロジェクトが TypeScript の場合は npx tsc --noEmit

これらを行わずに成功を主張しないでください。コードがコンパイルできることと、動画が正しく見えることは別です。

関連スキル