remotion-cli

Remotion CLI

npx remotion ... としてコマンドを実行するか、プロジェクトで定義されている場合はパッケージスクリプトを使用します。CLI には Node.js 18 以降が必要です。また、レンダリング操作には Chrome／Chromium のインストールが必要です（または npx remotion install-executables を使用してください）。

開発の流れ

1. スキャフォールド： npx create-video@latest を実行するか、テンプレートをクローンします。非対話型の場合：npx create-video@latest --blank ./my-project。
2. 作成： /remotion-core を使用してコンポジションを作成します。
3. 編集時の迅速なフィードバック： npm run dev を実行すると、localhost:3000 で Remotion Studio が開きます。
4. Studio で確認： タイムラインをスクラブし、すべてのフレームがレンダリングされることを確認します。npx remotion compositions src/index.ts ですべてのコンポジションを確認します。
5. ドラフトをレンダリング： 非決定性のバグを検出するため、まず --concurrency=1 を使用します。
6. ユーザーとプレビュー： Studio を開いて URL を渡し、修正するか最終版をレンダリングするかを尋ねます。
7. 承認後にのみレンダリング： 納品には高品質のコーデックを使用します。
8. 出力を確認： ファイルが存在し、空でなく、ffprobe で想定どおりの長さであることを確認します。

# Dev server (fast live preview)
npm run dev
# OR
npx remotion studio src/index.ts

# List all registered compositions
npx remotion compositions src/index.ts

# Draft render (fast, lower quality)
npx remotion render src/index.ts MyComposition out/draft.mp4 --concurrency=1

# Final render (high quality)
npx remotion render src/index.ts MyComposition out/final.mp4 --codec=h264 --crf=18

# Verify output
ffprobe -v error -show_format -show_streams out/final.mp4

Remotion Studio

画面	タイミング	目的
Studio（npm run dev）	作成中	フレームのライブプレビュー、タイムラインのスクラブ、props エディター
Studio の Input Props パネル	いつでも	コンポジションの props を編集し、リアルタイムの結果を確認
Studio のレンダーボタン	承認後	ブラウザーからローカルレンダリングを開始

Studio はデフォルトで localhost:3000 で実行されます。レンダリング前の主なレビュー画面です。

render コマンドのオプション

用途	コマンド
ローカルでの高速な反復	npx remotion render ... --concurrency=1 --quality=draft
ローカルでの最終納品（H.264）	npx remotion render ... --codec=h264 --crf=18
ローカルでの最終納品（ProRes）	npx remotion render ... --codec=prores --prores-profile=4444
1 フレームから静止画を作成	npx remotion still ... --frame=30
コンポジションのサイズを上書き	npx remotion render ... --width=1920 --height=1080
FPS を上書き	npx remotion render ... --fps=60
長さを上書き	npx remotion render ... --frames=0-150
入力 props を渡す	npx remotion render ... --props='{"title":"Hello"}'
JSON ファイルから props を渡す	npx remotion render ... --props=./props.json

AWS Lambda レンダリング

# Install Lambda package
npm install @remotion/lambda

# Deploy Lambda function (run once per AWS account/region)
npx remotion lambda functions deploy --memory=3009 --timeout=120

# Create a site (upload bundle to S3)
npx remotion lambda sites create --site-name=my-video-site

# Render via Lambda (fast, parallel)
npx remotion lambda render my-video-site MyComposition --region=us-east-1

# Check render progress
npx remotion lambda renders progress <render-id> --region=us-east-1

Lambda コマンドを実行する前に、references/lambda.md をお読みください。Lambda には IAM ロール、S3 バケット、環境変数（AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION）が必要です。

エージェントの規約

• 非決定性のバグを見つけやすくするため、デバッグ時は --concurrency=1 を使用します
• レンダリングの失敗を調査する際は --log=verbose を使用します
• Studio で正しく見えるという理由だけでレンダリングしてはいけません。必ずユーザーの承認を待ってください
• レンダリング前に npx remotion compositions src/index.ts を使用して、すべてのコンポジションが登録されていることを確認します
• バッチレンダリングには、CLI 呼び出しをループさせるのではなく、Node.js API（renderMedia、renderFrames）を使用します
• 一部のコマンドでは --log=json で JSON 出力を利用できます

remotion.config.ts

永続的なデフォルト値を設定するには、プロジェクトのルートに remotion.config.ts を配置します。

import {Config} from '@remotion/cli/config';

Config.setVideoImageFormat('jpeg');
Config.setOverwriteOutput(true);
Config.setConcurrency(4);
Config.setCodec('h264');
Config.setCrf(18);

コマンドを実行する前に、対応するリファレンスを読む

用途	リファレンス
studio、render、still、コーデックのオプション	references/render-options.md
lambda functions、lambda sites、lambda render	references/lambda.md
カスタムデプロイ向けの bundle	references/bundle.md
upgrade、install-executables、doctor	references/upgrade-misc.md
compositions、--props、calculateMetadata	references/compositions.md

コンポジション変数と calculateMetadata については、/remotion-core → references/calculate-metadata.md もお読みください。メディアアセットには /remotion-media を使用します。Lambda のデプロイとコストの最適化については、references/lambda.md をお読みください。