Communitygithub.com

motion-voice

Papercutリールにナレーションを吹き込み、映像に同期させます。ローカルQwen3-TTS、自身の録音や別のTTS、プレースホルダーの3つの方法に対応。納品ルール、voice.json、キャプション、シーンタイミングをカバーします。「ナレーションをセットアップ」「再吹き込み」「スクリプトのタイミング調整」に使用します。

motion-voice とは?

このスキルは、Papercutリール用のナレーション音声とタイミングデータを生成するためのツールです。各スクリプト行に対応するWAVファイルと、単語ごとの開始・終了時間を記録した `timing_narrator.js` を作成します。3つのパス(ローカルQwen3-TTSによるテキスト読み上げ、自身の録音や別のTTS、プレースホルダー)を提供し、ユーザーの環境や好みに応じて柔軟に対応します。このスキルは `$MOTION_LIB` ライブラリと連携し、`narrate.sh`、`finalize.sh`、`build_vo.py` などのスクリプトを実行することで、キャプション生成やシーンプラン作成までを自動化します。最終的な出力はRemotionベースの動画制作パイプラインで利用され、後続の `motion-build` ステップにシームレスに受け渡されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-voice

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

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

ドキュメント

Papercut ナレーション

後段の工程ではすべて、ナレーションフォルダに voice/final_narrator/<id>.wav(スクリプトの各行につき1つのWAV)と timing_narrator.js(すべての単語の開始時間と終了時間)の2つが必要です。このスキルは、3つの方法のいずれかでこれらを生成し、キャプションとシーンプランを作成します。スクリプトの完全なリファレンスは $MOTION_LIB/core/voice/README.md にあります。

事前確認

  • ライブラリ: $MOTION_LIB、そうでない場合は ~/.config/motion-explainer/config.env の MOTION_LIB= 行、それもない場合は一度だけ確認します。それをエクスポートし、. "$MOTION_LIB/env.sh" で ASR_PY、QWEN_TTS_PY などの設定値をシェルに読み込みます。
  • スキャフォールディングされたプロジェクト(motion-build、ステップ1)で、narration/script.json と video/episode.json(scenes を含む)が存在すること。new_episode.sh が build_timing.py を narration/ にコピーします。
  • ユーザーがすでにTTSをインストールしている場合は、そのまま使用し再構築しません(パスB、またはQwen3-TTSの場合はパスA)。どれでどこで動作するかを一度確認します。それ以外の場合は、どのパスを使用するかを尋ね、それぞれに必要なものを説明します。
パス必要なものインストールモード
A. ローカルQwen3-TTS$MOTION_LIB/core/voice/setup_tts.sh で作成した音声venv(モデルダウンロード 2.3〜4.2 GB)フル
B. 自身の録音または別のTTSASRバックエンド(mlx-whisper または faster-whisper)と、ピッチパス用の librosa + numpy(ASR_PY と QWEN_TTS_PY が指定するPython内)フル、または手動でこれらのパッケージ
C. プレースホルダーffmpeg; --say には macOS標準

必要なものがインストールされていないパスの場合、./install.sh --doctor を実行して motion-setup に引き継ぎます。ASRがない場合、build_timing.py は1秒あたり2.75単語と推定するだけなので、キャプションは実際の音声からずれます。

パスA: ローカルQwen3-TTS

シリーズフォルダから:

cp $MOTION_LIB/core/voice/voice.example.json voice/voice.json     # シリーズごとに一度; 編集してください
$MOTION_LIB/core/voice/narrate.sh voice/voice.json episodes/NN-slug/narration
$MOTION_LIB/core/voice/finalize.sh voice/voice.json episodes/NN-slug/narration episodes/NN-slug/narration/voice/takes/narrator [num.json]
  • voice.json: speaker(CustomVoice: Aiden, Dylan, Eric, Ryan, Serena, Vivian, Sohee, Ono_anna, Uncle_fu)と instruct。推奨: CustomVoice 1.7B、Ryan または Aiden、instruct は "friendly, natural, conversational, like telling a friend; clear pauses between sentences; stress the key word of each line"。takes_per_line はデフォルトで3。tempo は1.0のままにします(他の値には rubberband が必要)。qa_targets でピッチ範囲とASR一致度(0.9)を設定します。
  • スクリプト行には tts(発音を指示するための書き直しテキスト; キャプションは text を保持)と、各行固有の instruct を含めることができます。num.json は数字を単語表現にマッピングします({"13,000": "thirteen thousand"})。これにより、ASRマッチングが数字で失敗するのを防ぎます。
  • TTSプロセスは一度に1つ実行します。1.7Bモデルはメモリを多く消費します。
  • finalize.sh はすべてのテイクに対してASRとピッチを実行し、行ごとに1つを選び、トリミングし、ラウドネス正規化(-16 LUFS)し、最終テイクに対して再度ASRを実行して timing_narrator.js を書き出します。確認後、修正を voice/picks_override.json({"l3_name": 2})に記述し、SKIP_PICK=1 を指定して再実行します。
  • ボイスデザイン(声を言葉で説明すること)は、narrate.py が駆動しないQwen3-TTSのモードです。別の場所で生成し、パスBを使用してください。

パスB: 自身の録音または別のTTS

  • 各行のWAVを voice/final_narrator/<id>.wav に配置するか、生のテイクを voice/takes/narrator/<id>_<k>.wav として配置し、上記のように finalize.sh を実行します。
  • 完成した行の場合、文字起こしを行い、voice/chosen_narrator.json を {id: "voice/final_narrator/<id>.wav"} のように書き、narration/ から以下を実行します:
$ASR_PY $MOTION_LIB/core/voice/asr.py voice/final_narrator/*.wav > voice/asr_narrator_final.json
CHOSEN=voice/chosen_narrator.json TIMING_OUT=timing_narrator.js python3 build_timing.py voice/asr_narrator_final.json

パスC: プレースホルダー

narration/ フォルダから:

python3 $MOTION_LIB/core/tools/placeholder_vo.py [--wps 3.0] [--say [VOICE]]

無音のWAV(または --say を指定した場合はmacOSの say 音声)と、script.json のみから単語長に応じて時間を割り当てた timing_narrator.js を書き出します。--wps 3.5 〜 4 で目標のペースに近づきます(デフォルト3.0)。リールを先にビルドしてタイミングを調整し、後で再吹き込みすることができます。WAVを交換し、finalize.sh を再実行し、build_vo.py を再実行すると、単語のキューが追従します。

納品ルール

ナレーションは人間的で、落ち着いて、強調を伴って納品されます。視聴者は一度の視聴で各行を理解できなければなりません。

  • 間合い。 各文の終わりとリストのビートの間("Fine. Fine. Fine.")に実際のポーズを入れます。行間は0.3〜0.4秒から始め(episode.json の gap、デフォルト0.22; gaps は指定した行の後に追加のビートを追加)、耳で判断します。ポーズは文節または句の区切りのみに配置します。フレーズ内の0.2秒のギャップ(例:「コピーして、| 持っていく...」)は遅延として読まれます。ポーズを削る代わりに30秒の上限を使って余裕を持たせ、テンポを遅くして時間を稼ぐことは決してしません。
  • 強調。 各行が頼る1〜2の単語(数字、ひねりのある単語、結論)は、スクリプトのステージングテーブルから取得します。これを行固有の instruct として渡します。
  • トーン。 会話調で少し楽しげに、アナウンサーのようなエネルギーではなく。疑問文は本当の疑問のように、キャッチラインは好奇心旺盛に、CTAは温かく。ナレーターはそれでも冗談は言いません。映像がそれを担います。
  • クローンモデル(指示なし)。 クローンボイス(ref_audio + ref_text、ベースモデル)の場合、操作できるのはテキストとテイクだけです。句読点にポーズを書き込みます(リストのビート間はピリオド、短い疑問文は独立した文として)。1つの連続テイクのシードを複数生成し(SEED_BASE、takes_per_line)、ターゲット単語のピッチ変化が最も大きく、ASRが0.9以上のものを選び、フラットな行だけを個別に取り直し(ONLY=l4_peak)、文の境界でスプライスします。使用権のある音声のみをクローンしてください。
  • スクリプト全体を一度に生成すると、一貫した韻律が得られます: 1テイクを生成し、split_take.py で行ごとに分割し、episode.json で "gap": 0 を設定します。ユーザーが好む場合はシーンごとでも問題ありません。
  • 最初の3行をユーザーに再生してから全体を実行します: ONLY=l1_hook,l2_...,l3_... narrate.sh ...。

キャプションとタイミング

video/ から、episode.json に scenes がある場合:

python3 $MOTION_LIB/core/tools/build_vo.py     # public/vo/voiceover.wav, public/vo/captions.json, src/plan.json を生成
python3 $MOTION_LIB/core/tools/timing_md.py    # STORYBOARD.md のタイミングセクションを生成

captions.json はRemotionの Caption[] です。シーンの境界は単語のタイムスタンプから取得されます。コンポジションの長さは plan.json の durationInFrames です。build_vo.py は1.2秒未満のシーンをフラグします。ライブラリがない場合は、Remotionキャプションスキル(whisper.cpp)または単語タイムスタンプを返す音声認識ツールでWAVを文字起こしします。

キャプションは単語ごとに1つのタグで、1〜3単語のページが、1秒あたり3.5〜4単語の速度で表示されます($MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md、セクション11および13)。

引き渡し

次は motion-build(スタブ、シーン、サウンド、レンダリング)です。これは src/plan.json と video/STORYBOARD.md のタイミングセクションを読み取ります。後でナレーションが変更された場合は、build_vo.py と timing_md.py を再実行します。シーンキャッシュはすべてを再レンダリングします。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-qa

Check a papercut reel's stills against the style DNA and the storyboard. Renders contact sheets at a few timestamps, runs the full checklist, then writes the delivery summary. Use for "QA the reel", "check my scenes look like paper", "is this ready to post".

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

関連スキル