Motion ワークスペース
このワークスペースは、mg CLI(pnpm mg <コマンド>)を通じて Remotion で反復可能なモーショングラフィックスをレンダリングします。デザインはテンプレートとしてコードで記述され、ジョブ固有の値はすべて JSON に格納されます。テキスト、色、フォントの変更は JSON の編集と pnpm mg render だけで完結し、コードを変更する必要はありません。
ディレクトリ構成
mg.json ワークスペースの動画デフォルト(fps, サイズ)
brand/house.tokens.json ハウストークン:ベースカラー、フォント、イージング、時間、セーフエリア
brand/fonts/ brand/logos/ ハウストークンが参照するファイル
clients/<client/>
client.json 表示名、オプションの動画オーバーライド
brand/tokens.json クライアントのオーバーライド(ハウスとディープマージ)
brand/fonts/ brand/logos/
brand/variants/<variant>/ 名前付きの代替ルック:tokens.json、fonts/、logos/
templates/<name>/index.tsx クライアント専用テンプレート、ID "<client>/<name>"
projects/<project>/
project.json { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
tokens.json プロジェクト専用オーバーライド(オプション)
tokens.lock.json フリーズ時に存在:レンダリングはライブチェーンを無視
fonts/ logos/ assets/ プロジェクトファイル;プロパティはアセットを "asset:<パス>" で参照
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ 出力、git-ignored;manifest.json がバージョンを追跡
ツールキットコード(エンジン、ハウステンプレート、これらのスキル)は node_modules/motion-toolkit にあり、package.json で固定されています。そこで編集しないでください。ハウステンプレートの変更はツールキットリポジトリで行います。
ハウステンプレート
すべてのハウステンプレートには look プロパティがあります:minimal(クリーン、細いウェイト、ブラーライズ、パネルなし)、bold(太い大文字、単色ブロック、スプリングポップ)、corporate(パネル、アクセントバー、マスクリビール)。デフォルトの "brand" は look トークンを使用するため、クライアントは brand/tokens.json("look": "minimal")で一度スタイルを設定します。
| ID | 用途 |
|---|---|
lower-third | 名前と役職のストラップ、オプションでロゴ |
title-card | チャプターまたはセクションタイトル、オプションでキッカーとサブタイトル;オーバーレイまたは全画面 |
callout | 映像内のポイント(フレーム比率の x, y)からラベルへの線 |
end-card | エンディングカード:ロゴ、ヘッドライン、CTA、URL、0~2個のYouTubeエンドスクリーンスロット |
kinetic-text | 引用文や声明を単語ごとに表示;*単語* で強調 |
logo-sting | 短いアニメーションロゴリビール(イントロ/アウトロ) |
counter | ラベル付きで数字をカウントアップ(value、prefix、suffix、decimals) |
social-handle | プラットフォームアイコン+@ハンドルを隅に表示(YouTube、Instagram、TikTok、X、LinkedIn…) |
typewriter | タイプライターまたはキーボード音を伴ってテキストを1キーずつ入力(レンダリングのオーディオに反映) |
corner-branding | 任意の隅に永続的なロゴバグ、オプションで LIVE などのタグ |
pnpm mg new-shot … --template <ID> で、すべてのプロパティをデフォルト値で書き出します。各プロパティの意味は node_modules/motion-toolkit/templates/<ID>/index.tsx 内の .describe() テキストに記載されています。
トークンチェーン
ツールキット → ハウス → クライアント → バリアント(project.json の "brand" がある場合) → プロジェクト tokens.json → ショットプロパティ。ツールキット層はデフォルト(look、mono フォント、タイピング sounds)のみを提供します。オブジェクトはキーごとにマージされ、null は継承されたキーを削除し、最も具体的な層が優先されます。"extends": "none" はクライアントとバリアントをスキップします。フォント、ロゴ、サウンドファイルは、それらを持つ最も具体的な層の fonts/、logos/、sounds/ フォルダから検索されます。
ルール
- すべての表示値はショットプロパティまたはトークンから取得されます。テンプレート内にハードコードされた色、フォント、px単位のサイズ、タイミングは禁止です。
- プロジェクトはデータを保持し、コードは保持しません。新しいデザインはテンプレート、新しいジョブはショットファイルを含むプロジェクトです。
- 値を、それを所有する最も低い層に配置します:1ショット → ショットプロパティ;1プロジェクト → プロジェクト
tokens.json;クライアントの複数プロジェクト → バリアント;クライアント全体 → クライアントトークン。 tokens.lock.jsonを手動で編集しないでください。納品済みプロジェクトはフリーズされています。変更はmg rebrand(motion-renderを参照)でのみ行います。- JSON またはテンプレートを編集した後は、レンダリング前に必ず
pnpm mg checkを実行し、報告された問題を修正してください。 - すべての視覚的な変更は、完了報告前に
motion-qa手順で確認してください。 mg rebrand --applyを実行する前、およびフリーズされたプロジェクトで使用されているクライアント/バリアントトークンを編集する前には、ユーザーに確認を取ってください。- レンダリングまたは doctor チェックが失敗した場合は、コードを変更する前に
pnpm mg doctorを実行してください。
ルーティング
| タスク | 参照先 |
|---|---|
| 新しいクライアント、バリアント、ロゴ、フォント、カラーパレット | motion-brand |
| 新しいプロジェクトまたはショットの作成;既存ショットのテキスト/色変更 | motion-project |
| 新しいテンプレート、またはテンプレートのアニメーションの変更 | motion-template、次に motion-style |
| モーションの感触:イージング、タイミング、スタガー、セーフエリア | motion-style |
| レンダリング、プリセット、バージョン管理、納品、ブランド変更の適用 | motion-render |
| 納品前の出力チェック | motion-qa |
コマンド
pnpm mg templates テンプレートID一覧
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <ID> すべてのプロパティがデフォルトのショットファイル
pnpm mg new-template <client> <name> スターターテンプレート
pnpm mg check [<client> | <client>/<project>] レンダリングせずにすべて検証
pnpm mg render <client>/<project> [shot…] 未変更ショットはスキップ;--force、--preset
pnpm mg still <client>/<project> [shot…] チェッカーボード上でPNGを確認(デフォルトですべてのショット)
pnpm mg studio <client>/<project> ライブプレビュー;Studioの「保存」でショットファイルを書き込み
pnpm mg deliver <client>/<project> レンダリング、検証、フリーズ、最終ファイルを deliver/<日付>/ にコピー
pnpm mg rebrand <client | client/project> [--apply] 納品済み作品へのブランド変更
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor 環境、mg check、スモークレンダリング