マニュアル

audio-bars — 音声ビジュアライザ

audio に wav を渡すと波形そのものに同期し、渡さなければ bpm で拍を作ります。中央の円は低域に反応して拡大し、拍で跳ねます。

主な入力値 audio（既定は空）／style（bars / mirror / wave、既定 bars）／ bars（既定 56・2〜512）／ring（既定 true）／ bpm（既定 120）／duration（既定 8）

$ movo skill render audio-bars --set style=mirror --set bars=32 \
    --set bpm=120 --set duration=3 --width 640 --height 360 --fps 12 \
    --background '#0a0a12' -f gif -o audio-bars.gif

counter-stat — 数字カウンター

from から to まで数字が回ります。 3 桁区切りは separator、単位は suffix で付きます。 見出しと下線が一緒に出るので、実績や統計をそのまま置けます。

主な入力値 label（既定「総再生数」）／from（既定 0）／ to（既定 12345）／suffix／ separator（既定 true）／size（既定 120）

$ movo skill render counter-stat --set label=総再生数 --set to=12345 \
    --set suffix=回 --set size=280 --set duration=3 --from 0.25 \
    --width 640 --height 360 --fps 12 --background '#0b0b10' -f gif -o counter-stat.gif

cutin-title — 集中線カットイン

集中線が内側から開きながら、文字が四方から集まります。 線は lineCount 本まで増やせて、脈は bpm に同期します。 サビ前の 1〜3 秒に置くための短いカットです。

主な入力値 text（必須・既定「サビ」）／bpm（既定 174）／ lines（既定 true）／lineCount（既定 180・4〜2000）／ textSize（既定 140）／background（既定 #12081c）

$ movo skill render cutin-title --set text=サビ --set bpm=174 \
    --set lineCount=120 --set duration=2.5 \
    --width 480 --height 270 --fps 10 -f gif -o cutin-title.gif

flash-cut — フラッシュカット

画面いっぱいの色が不透明度 1 から 0 へ落ち、同時に 220 本の線が外へ散ります。 他の映像に重ねて使うトランジションで、単体で描くと最後は透明です （この GIF は --background で下地を敷いています）。

主な入力値 color（既定 #ffffff）／ duration（既定 0.6・0.05 以上）／lines（既定 true）

$ movo skill render flash-cut --set duration=1 \
    --width 640 --height 360 --fps 20 --background '#12081c' -f gif -o flash-cut.gif

glitch-overlay — グリッチのオーバーレイ

9 本の帯が乱数で跳ね、色収差とノイズが全画面に重なります。 interval 秒ごとに発作的に暴れ、shake で画面ごと揺れます。 切り替えの直前に 1 秒だけ置くのが効きます。

主な入力値 amount（既定 0.6・0〜1）／color（既定 #4cc9f0）／ interval（既定 2・1 以上）／shake（既定 20）

$ movo skill render glitch-overlay --set amount=0.7 --set interval=1 \
    --set duration=1.6 --width 480 --height 270 --fps 12 \
    --background '#101018' -f gif -o glitch-overlay.gif

logo-sting — ロゴスティング

asset に渡したロゴ画像（無ければ text の文字）が 回りながら現れ、後ろの発光が膨らみます。出たあとも脈打ち続けるので、 2〜3 秒の締めのカットとしてそのまま置けます。

主な入力値 asset（宣言済みの素材名）／text（既定 MOVO）／ size（既定 320）／glowColor（既定 #4cc9f0）／ duration（既定 2.5）

$ movo skill render logo-sting --set text=MOVO --set duration=2.5 \
    --width 640 --height 360 --fps 12 -f gif -o logo-sting.gif

lyric-line — 歌詞 1 行（カラオケ塗り）

未塗りの baseColor から fillColor へ、 左から塗られていきます。塗る区間は startAt〜endAt （endAt が 0 なら尺いっぱい）。reading を渡すと下にふりがなが並びます。

主な入力値 text（必須）／reading／size（既定 64）／ baseColor（既定 #5d6790）／fillColor（既定 #ffd166）／ startAt（既定 0.25）／y（中心からの縦位置）

$ movo skill render lyric-line --set text=夜のとばりが降りて \
    --set reading=よるのとばりがおりて --set size=150 --set duration=3 \
    --width 640 --height 360 --fps 12 --background '#0a0a12' -f gif -o lyric-line.gif

lyric-vertical — 縦書きの歌詞

改行ごとに列が増え、右から左へ並びます。塗りは上から下です。 改行は --set では書けないので、--with に JSON で \n を渡してください。

主な入力値 text（必須・改行で列）／size（既定 56）／ fillColor（既定 #4cc9f0）／x（中心からの横位置）／ startAt（既定 0.25）

$ movo skill render lyric-vertical --with '{"text":"静かに\n息をする"}' \
    --set size=140 --set duration=3 --width 640 --height 360 --fps 12 \
    --background '#0a0a12' -f gif -o lyric-vertical.gif

manga-panel — 漫画コマ風

写真を網点と輪郭線で漫画化し、コマ枠が手描きの震えつきで引かれ、 集中線が回り、吹き出しが飛び出します。levels が階調数、 dotSize が網点の大きさです。 素材を使うので、宣言済みの名前を渡せるプロジェクト JSON から呼びます。

主な入力値 asset（空ならトーンだけ）／text（空で吹き出しが消える）／ levels（既定 4・2〜12）／dotSize（既定 5）／ lines（既定 true）／frame（既定 true）

{
  "movoVersion": "1.0",
  "project": { "name": "manga-panel", "seed": 3 },
  "video": { "width": 400, "height": 225, "fps": 8, "duration": 1.6, "background": "#f5f2ea" },
  "assets": { "susuki": "assets/free/susuki.png" },
  "scenes": [{ "use": [{ "skill": "manga-panel", "with": {
    "asset": "susuki", "text": "CLIMAX", "levels": 4, "dotSize": 5, "duration": 1.6
  } }] }]
}

$ movo render manga-panel.json -f gif -o manga-panel.gif

night-sky — 夜空

topColor から bottomColor への縦のグラデーションに、 stars 個の粒を撒いた背景です。ほかのスキルの下に敷いて使います。

主な入力値 topColor（既定 #05060f）／ bottomColor（既定 #243b7a）／ stars（既定 140）／duration（既定 8）

$ movo skill render night-sky --set stars=160 --set duration=4 \
    --width 560 --height 315 --fps 10 -f gif -o night-sky.gif

photo-slide — 写真のスライド

素材名を並べるだけで、1 枚 each 秒のケン・バーンズと overlap 秒のクロスフェードでつなぎます。film でフィルム調、 caption で下にキャプションが出ます。尺は「枚数 × each」で決まります。

主な入力値 assets（宣言済みの素材名・カンマ区切り）／each（既定 3）／ overlap（既定 0.6）／film（既定 true）／caption

{
  "movoVersion": "1.0",
  "project": { "name": "photo-slide", "seed": 3 },
  "video": { "width": 400, "height": 225, "fps": 8, "duration": 1.4, "background": "#0b0b10" },
  "assets": { "susuki": "assets/free/susuki.png", "tree": "assets/free/tree.png" },
  "scenes": [{ "use": [{ "skill": "photo-slide", "with": {
    "assets": ["susuki", "tree"], "each": 1.0, "overlap": 0.4,
    "film": true, "caption": "秋の記録"
  } }] }]
}

$ movo render photo-slide.json -f gif -o photo-slide.gif

physics-drop — 物理で落とす

床と壁が静的な剛体、玉が動的な剛体で、 当たり判定を実際に解いて跳ねます。restitution が反発、 gravity が重力です。キーフレームでは書けない散らばり方になります。

主な入力値 count（既定 5・1〜40）／radius（既定 48）／ restitution（既定 0.7・0〜1）／gravity（既定 1400）／ walls（既定 true）

$ movo skill render physics-drop --set count=7 --set restitution=0.75 \
    --set duration=3 --width 640 --height 360 --fps 15 \
    --background '#101018' -f gif -o physics-drop.gif

split-screen — 分割画面

画面を columns×rows に割り、panels に書いた コンポジション名を各マスに敷けます（書かなかったマスは colors の色）。 merge の時刻に全マスが中央へ寄って 1 枚になります。

主な入力値 columns（既定 2・1〜8）／rows（既定 1・1〜8）／ panels／colors／seam（継ぎ目の太さ・既定 8）／ merge（既定 0 で統合しない）／zIndex（既定 -10）

$ movo skill render split-screen --set columns=3 --set rows=2 \
    --set merge=2.4 --duration 4 --width 640 --height 360 --fps 12 \
    -f gif -o split-screen.gif

title-card — タイトルカード

帯が横に開き、その上にタイトルとサブタイトルが乗ります。帯を斜めの光が走り、 出たあともゆっくり呼吸します。align で左寄せと中央を選べます。

主な入力値 title（必須）／subtitle／ cardColor（既定 #1b2140）／titleSize（既定 96）／ align（left / center、既定 center）

$ movo skill render title-card --set title=Movo \
    --set 'subtitle=JSON から動画をつくる' --set duration=3 \
    --width 640 --height 360 --fps 12 -f gif -o title-card.gif

weather — 天候（雨・雪・桜）

舞い物を 1 行で足します。kind は rain / snow / sakura / confetti / bubble の 5 種類で、 それぞれ速さ・大きさ・回り方が違います。tint の色を オーバーレイで重ねて画面全体の色味も寄せられます。 舞い物が画面を埋めるまで数秒かかるので、この GIF は --from で頭を捨てています。

主な入力値 kind（既定 snow）／rate（既定 0 で種類ごとの既定値）／ tint（既定 #8fb8ff・空で無し）／ tintAmount（既定 0.16・0〜1）／duration（既定 6）

$ movo skill render weather --set kind=sakura --set tint='#ff9ec4' \
    --set tintAmount=0.25 --set rate=90 --set duration=8 --from 4.5 \
    --width 560 --height 315 --fps 10 --background '#2a1430' -f gif -o weather.gif