🎬 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
```

---

※ script_20250608_xxxxxx.mp4が作成できないときは、OPEN AIのAPIに問題が発生している場合が多い。

参考: [Rate limit may be lower depending on user’s OpenAI plan](https://github.com/receptron/mulmocast-cli/issues/477)

## 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/)