stereo-motion
README.md
# 立体視ムービーメーカー by ずんだAI
**自分の動画に貼る「立体視の素材」を作る道具です。透過PNGから、背景が透明のまま揺れたり回ったりする左右のペア(平行法・交差法)ができます。ブラウザだけで動きます。**
👉 **使う:https://tashirosmasashis-cell.github.io/stereo-motion/**
- 絵を入れて、動き(左右の揺れ・上下の揺れ・時計回り・反時計回り)を選び、その場で確かめてから書き出せます。**透明のある絵=透明つき素材(透過 WebM/PNG連番)、背景つきの絵=MP4**
- 素材は左右のペアをぴったり切った形で、文字や枠は入れません。1周分を作って、動画の側でくり返し置けます(最後のコマが最初につながる永久ループ)
- **絵はあなたの PC から出ません**。奥行きの推し量りも、毎コマの描画も、動画にまとめるのも、開いたブラウザの中で動きます(サーバーはありません)
- 無料・登録なし・使った記録も取りません
| 左右の揺れ | 上下の揺れ | 時計回り | 反時計回り |
| :--: | :--: | :--: | :--: |
| <img src="docs/sway-x.gif" width="200" alt="左右の揺れ"> | <img src="docs/sway-y.gif" width="200" alt="上下の揺れ"> | <img src="docs/cw.gif" width="200" alt="時計回り"> | <img src="docs/ccw.gif" width="200" alt="反時計回り"> |
<img src="docs/screen.png" width="760" alt="画面:左に見本、右に絵・動き・出す形・書き出しの設定">
## 見方
- **平行法**:遠くを見るように目の力をぬき、左右の絵が3つに見えたら真ん中を見つめます
- **交差法**:寄り目にして左右を重ねます(画面で「交差法」を選ぶと左右が入れ替わります)
目の体操・リフレッシュ用です。視力が回復するという研究の裏付けは見つかっていません。疲れたら休んでください。
## できること
- **動き**:左右の揺れ/上下の揺れ/時計回り(カメラが右→下→左→上と円を描く)/反時計回り/止める
- **大きさ・1周の秒数・立体の強さ(左右のずれ)・回る軸の深さ**(はじめは絵の真ん中あたりの深さ=人物のまわりを回る)
- **いつも永久ループ**:長さは「1周の秒数 × 周回数 × 絵の枚数」でしか決まりません。動画の最後のコマの次が最初のコマにそのままつながるので、くり返し再生してもつなぎ目が出ません
- **絵を何枚でも**入れられます。1枚ごとに決まった周回数を回り、ちょうど回り終えた所で次の絵に替わります
- **縦 1080×1920**(スマホ・ショート動画向け。文字は入れず、動画素材として書き出します)か、**左右に並べただけ**の形
- 設定はページのアドレスに入るので、アドレスを渡せば同じ設定で作れます
- 奥行きの絵を見る・確かめる
## しくみ
1. **奥行き**:[Depth Anything V2 Small](https://huggingface.co/onnx-community/depth-anything-v2-small)(Apache-2.0)を [transformers.js](https://github.com/huggingface/transformers.js) でブラウザの中で動かします(WebGPU、無ければ WASM)。モデル(約27MB)は初回だけ Hugging Face から読み込み、ブラウザに残ります
2. **下ごしらえ**:色の絵のふちに沿って奥行きを整え(ガイド付きフィルタ)、手前の物のふちを少し太らせ、手前の物を取り除いて背景で埋めた絵(隠れていた所の色)を作ります
3. **描画**:WebGL で、出す点ごとに奥行きに沿って光線をたどり、最初に当たる所を描きます。手前の物のふち(奥行きの崖)に当たったら、そこは動いて見えるようになった「隠れていた所」なので、背景の絵から描きます(引き伸ばしが出ません)
4. **書き出し**:同じ描き方で1コマずつ描き、WebCodecs と [Mediabunny](https://github.com/Vanilagy/mediabunny) で MP4 にまとめます(H.264 が作れないブラウザでは WebM)
考え方は [iw3(nunif)](https://github.com/nagadomi/nunif)・[DepthFlow](https://github.com/BrokenSource/DepthFlow)・[stable-diffusion-webui-depthmap-script](https://github.com/thygate/stable-diffusion-webui-depthmap-script) を参考にしました。ありがとうございます。
## AI から使う(MCP)
同じ描き方で、AI のエージェントからも動画を作れます。この PC の Chrome(か Edge)を見えない形で起こして同じ画面を動かすので、手で作った動画と同じ絵になります。絵はどこにも送りません。
**入れ方は1行です**(Node.js が入っていれば、ターミナルに貼るだけ):
```bash
npx -y github:tashirosmasashis-cell/stereo-motion add
```
プログラムを `~/.stereo-motion` に取ってきて、この PC にある **Claude Code・Codex・Antigravity** に自分で登録します(もう入っている AI は触りません)。AI を開き直すと使えます。新しい版にするときも同じ1行です。初回は30秒ほど、奥行きのモデル(約27MB)は最初に使うときに1回だけ読み込みます。
- 要る物:Node.js 22.12 以上・Chrome か Edge・`ffmpeg`(透明のある絵と `view:"single"` のとき。Windows は `winget install ffmpeg`、Mac は `brew install ffmpeg`)
- MCP の口はあなたの PC の中で動きます(HP の住所につなぐ物ではありません)。動画を作る力もあなたの PC の物を使い、だれにもお金はかかりません
<details><summary>手で登録するとき</summary>
```bash
git clone https://github.com/tashirosmasashis-cell/stereo-motion.git
cd stereo-motion
npm install
claude mcp add -s user stereo-motion -- node /path/to/stereo-motion/mcp/server.mjs
```
```toml
# Codex:~/.codex/config.toml
[mcp_servers.stereo-motion]
command = "node"
args = ["/path/to/stereo-motion/mcp/server.mjs"]
```
```json
// Antigravity:~/.gemini/config/mcp_config.json の "mcpServers" に足す
"stereo-motion": { "command": "node", "args": ["/path/to/stereo-motion/mcp/server.mjs"] }
```
組み立てた画面(`dist`)は倉庫に入っているので、`npm run build:page` は画面を直したときだけ要ります。
</details>
道具:
- `make_stereo_video`:絵のパス(1枚以上)と設定(`motion`・`amount`・`period`・`stereo`・`pivot`・`view`・`width`・`cycles`。`seconds` を渡すと近い周回数に丸めます)から、1枚ごとに別の素材を作ってパスを返します。透明のある絵=透過 WebM(VP9・アルファ。`prores:true` で ProRes 4444 の .mov も)、背景つきの絵=MP4。`view` を `single` にすると、左右のペアにせず1枚の絵のまま奥行きでカメラが動く動画(写真の中身は変えずに短い動画にする・HP のショートリールなど)
- `list_motions`:動きの種類とはじめの設定
コマンドで試す:`node mcp/cli.mjs --motion cw --out out.webm image.png`
AI エージェント向けの説明書:[docs/FOR-AI.md](docs/FOR-AI.md)(MCP・この PC だけの HTTP API(`npm run api`・OpenAPI あり)・コマンドは、道具の名前・引数・返事が同じ)。
## 動画に置く(Remotion)
透過 WebM はそのまま置けます:`<OffthreadVideo src={staticFile('stereo.webm')} transparent muted loop />`。画面から作った透明つき PNG 連番の ZIP は、解いて `ffmpeg -framerate 30 -i frames/%04d.png -c:v libvpx-vp9 -pix_fmt yuva420p -auto-alt-ref 0 stereo.webm`(ProRes 4444 なら `-c:v prores_ks -profile:v 4444 -pix_fmt yuva444p10le stereo.mov`)。ブラウザの動画の部品は透明を残して書き出せないので、画面では PNG 連番にしています。
画面の書き出しが使えない環境では、毎コマの絵を受け取って [ffmpeg](https://ffmpeg.org/) でまとめます(ffmpeg が要ります)。
## 永久ループの検査
よくある凡ミス(最後のコマと最初のコマが同じ絵で、くり返すと同じ絵が2コマ続いてカクッと止まる)が起きていないことを、4つの動きで確かめます。
```bash
npm run build:page
npm run check:loop -- image.png
```
書き出した動画のコマ数がちょうど「1周×周回数×枚数」であること・描かない次のコマが最初のコマとまったく同じ(1周がぴったり閉じている)こと・最後のコマから最初のコマへの変わり方が、となり合うコマどうしと同じ大きさであることを見ます。
※ 動画の部品(WebCodecs)が無い古いブラウザでは画面を録画して書き出すので、コマ数がぴったりにならないことがあります(PC の Chrome・Edge・新しい Safari は部品があるのでぴったりです)。
## 手元で動かす
```bash
npm install
npm run dev
```
## ライセンス
MIT(このリポのコード)。奥行きのモデル Depth Anything V2 **Small** は Apache-2.0 です(Base・Large・Giant は商用不可なので使っていません)。Mediabunny は MPL-2.0、transformers.js は Apache-2.0、ONNX Runtime Web は MIT です。
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues