mulmocastをWindowsで使い倒す！AI動画自動生成スタートガイド

# 🎬 mulmocast（マルモキャスト）完全ガイド【Windows対応】

**mulmocast** は、テキストから自動で画像・音声・動画を生成するクリエイティブAIツールです。

📌 **本記事の目的**
- gitの解説が専門的でありwindowsは特にややこしいため、「具体的な手順をまとめた」
- 初心者のつまずき防止
- トラブル対応＆応用例
- 成果をすぐ出したい人、深く使い倒したい人の両方に対応！

---

## 🌱 全体の流れ（事前知識ゼロでも安心）

1. 環境準備（ffmpeg / Node.js / mulmocast 他）  
2. APIキー設定  
3. AI台本（MulmoScript）作成＆動画化  
4. 日本語字幕・音声対応  
5. トラブル対策  
6. 応用Tips  

---

## 1. 🛠️ 最短セットアップ（無駄なく・つまずかない）

### ✅ ① ffmpeg の導入（音声・動画の職人）

- [Gyan.devのWindows builds](https://ffmpeg.org/)
- `ffmpeg-master-latest-win64-gpl-shared.zip` をダウンロードして解凍（例: `C:\ffmpeg`）

#### ➕ 環境変数にPathを追加

```
C:\ffmpeg\bin
```

- 「環境変数」検索 → `Path` 編集
- 再起動 or ログアウトを忘れずに！

#### ✅ 動作確認

```bash
ffmpeg -version
```

出力例の一部：

```
ffmpeg version N-119884-gfb65ecbc9b-20250613
libavcodec 62.3.101 / libavformat 62.1.100 / ...
```

> 💡 **注意**：「ffmpegが見つからない」原因の8割はPath設定漏れ！

---

### ✅ ② Node.js の導入

- [Node.js公式サイト](https://nodejs.org/)から **LTS版**（例: 20.x）をDL＆インストール

#### バージョン確認

```bash
node -v
npm -v
```

---

### ✅ ③ Git の導入（任意）

- [Git公式](https://git-scm.com/downloads/win)からインストール

```bash
git --version
# 例: git version 2.49.0.windows.1
```

---

### ✅ ④ mulmocast CLI のインストール

```bash
npm install -g mulmocast
```

#### メッセージ例

```text
added 331 packages in 1m
62 packages are looking for funding
...
mulmo --version
# 例: 0.0.14
```

---

### ✅ ⑤ APIキーなどを `.env` に設定

#### フォルダ作成＆`.env`作成（例: `my_project/.env`）

```env
OPENAI_API_KEY=sk-xxxxxx

# 任意で追加
DEFAULT_OPENAI_IMAGE_MODEL=gpt-image-1
ELEVENLABS_API_KEY=elevenlabs-xxxxxx
PATH_BGM=./assets/music/my_bgm.mp3
```

---

## 2. 📝 AI台本スクリプト作成～動画化 実践編

### ✨ A. MulmoScript の作成方法

#### ✅ 1. ChatGPTを使う（推奨）

1. 映像化したい内容のURLや企画を決定  
2. ChatGPTで要約 or 台本生成  
3. 以下のコマンド実行

```bash
mulmo tool prompt -t business
# comic_strips / ghibli_strips / children_book なども選択可
```

4. 生成されたプロンプトをChatGPTに貼り付けて台本生成  
5. 出力スクリプトをコピー  

#### ✅ 2. JSON形式で自作する（上級者向け）

参考: [mulmocast GitHub](https://github.com/receptron/mulmocast-cli/tree/main)

---

### 🎥 B. 動画生成コマンド

```bash
mulmo movie __clipboard
```

> 📌 `__clipboard` = クリップボードの台本を自動読み込み

#### 🎬 出力例（output/フォルダ内）

```
output/
├── images/
├── audio/
├── script_20250608_xxxxxx.json
├── script_20250608_xxxxxx.mp3
├── script_20250608_xxxxxx.mp4
```

---

## 3. 🇯🇵 日本語字幕・音声 対応

### ✅ 字幕を日本語にする

```bash
mulmo movie output/スクリプト名.json -c ja
```

### ✅ 音声を日本語にする

```bash
mulmo movie output/スクリプト名.json -l ja
```

> 英語⇔日本語切り替えも一発！

---

## 4. 🆘 トラブルシューティング

### ❌ ffmpegが見つからない

- **原因**: Path未設定、再起動してない  
- **対応**: Pathを確認、PC再起動

---

### ❌ mulmo コマンドが使えない

- **原因**: npmのグローバルPATHが通っていない  
- **対応**:

```bash
npm config get prefix
# 例: C:\Users\あなた\AppData\Roaming\npm
# → binフォルダをPathに追加
```

---

### ❌ OpenAI エラー

- **原因**: APIキー誤記、権限エラー  
- **対応**: `.env`を再確認（全角・空白に注意）

---

## 5. 💡 応用アイデア

- ナレーション音声＆BGMを差し替え → `.env` or mp3置換  
- スライド動画・ポッドキャスト自動化  
- 子供向け絵本・教育動画にも応用可  
- YouTubeやSNS用コンテンツ
- ビジネス資料・学習教材への展開も  

---

## 6. ✅ まとめ＆次ステップ

- mulmocastは **AIの自動化力** を実感できる最強ツール  
- 一部でも動いたら、もう“惜しい”ところまで来ている！  
- 完成した動画はSNS・ブログ・教材などに展開しよう！

---

## 7. 🔗 参考リンク

- [mulmocast GitHub（公式）](https://github.com/receptron/mulmocast-cli)  
- [日本語ドキュメント（beta1）](https://github.com/receptron/mulmocast-cli/wiki)  
- [ffmpeg Windows builds](https://www.gyan.dev/ffmpeg/builds/)