MojiCraft

✨ MojiCraftの特徴

🖥️ 必要スペック

MojiCraftは一般的なPCで動作します。高価なPCは不要です！

📋 対応OS

💻 文字起こしのみ使う場合

🤖 文字起こし + AI要約を使う場合

⏱️ 音声の長さと処理時間の目安

🚀 かんたん3ステップ

MojiCraftは3ステップで使えます。むずかしい設定は不要！

📁 MojiCraftのフォルダ構成 - ダウンロードして展開したらそのまま使える

📦 ダウンロード

お使いのOSに合ったパッケージをダウンロードしてください。

🍎 macOSセットアップ

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install whisper-cpp

🪟 Windowsセットアップ

whisper-cliとffmpegが同梱されているので、追加インストールは不要です 🎉

1. ダウンロード＆展開

MojiCraft-v2.2.0-windows-amd64.zip を右クリック →「すべて展開」

2. 起動

展開したフォルダの中の mojicraft.exe をダブルクリック。

3. 使い始める！

コマンドプロンプトが開いてMojiCraftが起動します。「1_音声ファイル」にファイルを入れるだけ！

🐧 Linuxセットアップ

ffmpegは同梱されていますが、whisper-cliの別途インストールが必要です。

1. whisper.cppのビルド

git clone https://github.com/ggerganov/whisper.cpp.git
cd whisper.cpp
cmake -B build
cmake --build build --config Release
sudo cp build/bin/whisper-cli /usr/local/bin/

2. MojiCraftの展開＆起動

tar xzf MojiCraft-v2.2.0-linux-amd64.tar.gz
cd MojiCraft
./mojicraft

👋 はじめての起動

MojiCraftを初めて起動すると、以下のウェルカム画面が表示されます。

🎉 初回起動時のウェルカム画面 - 使い方がすぐわかる

起動したら、あとは「1_音声ファイル」フォルダにファイルを入れるだけ。MojiCraftが自動的に検出して文字起こしを開始します 🎧

🎧 文字起こしの流れ

MojiCraftは「ウォッチモード」で動作します。起動しておくと、入力フォルダを定期的にチェックして、新しいファイルを自動で処理します。

🔄 ファイル処理中の画面 - ffmpeg変換→文字起こし→AI要約→保存まで全自動

⌨️ キー操作

監視モード中は、以下のキーが使えます：

⚙️ 設定メニュー

監視中に s を押すか、./mojicraft --configure で設定メニューを開けます。

⚙️ 設定メインメニュー - 4つのカテゴリに分かれています

📋 基本設定

Whisperモデル、認識言語、スキャン間隔などを変更できます。

📋 基本設定 - Whisperモデルや言語の変更はここから

🤖 AI要約設定

AI要約のON/OFF、使用するモデル、要約プロンプトの変更ができます。

🤖 AI要約設定 - OllamaやOpenAI APIの設定はここから

📁 フォルダ設定

入力・出力・アーカイブフォルダのパスを変更できます。

📁 フォルダ設定 - フォルダの場所を自由に変更可能

🩺 環境診断（--doctor）

環境に問題がないか自動チェックできます。セットアップ後や、問題が起きたときに実行してください。

./mojicraft --doctor

🩺 全チェック通過！whisper-cli、ffmpeg、Ollamaすべて検出

問題がある場合はこのように表示されます：

⚠️ 警告がある場合 - 解決方法もあわせて表示されます

チェック項目

• ✅ whisper-cli（音声認識エンジン）の検出
• ✅ whisperモデルファイルの検出とサイズ確認
• ✅ ffmpeg（動画変換ツール）の検出
• ✅ Ollamaの検出
• ✅ Ollamaサーバーの稼働状態
• ✅ AIモデルのインストール状態
• ✅ config.jsonの読み込みと検証

🤖 AI要約とは

MojiCraftは文字起こしに加えて、AI要約機能を搭載しています。長い文字起こし結果を、AIが自動で要約してくれます。

📥 Step 1: Ollamaのインストール

AI要約を使うには、まずOllamaをインストールします。Ollamaは、あなたのPC上でAIモデルを動かすための無料ツールです。

🍎 macOSにOllamaをインストール

方法1: 公式サイトからダウンロード（おすすめ 👈）

1. ollama.com にアクセス
2. 「Download for macOS」ボタンをクリック
3. ダウンロードされた Ollama-darwin.zip をダブルクリックで展開
4. 出てきた Ollama.app を「アプリケーション」フォルダにドラッグ＆ドロップ
5. 「アプリケーション」フォルダから Ollama.app をダブルクリックで起動

✅ 起動確認： 画面上部のメニューバーにラマ 🦙 のアイコンが表示されれば成功！Ollamaはバックグラウンドで動き続けます。

💡 初回起動時に「開発元が未確認〜」と表示されたら、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックしてください。

方法2: Homebrewでインストール（上級者向け）

brew install ollama

インストール後、Ollamaサーバーを起動：

ollama serve

⚠️ Homebrewでインストールした場合、MojiCraftを使う前に必ず ollama serve を別のターミナルウィンドウで起動しておいてください。公式アプリ版なら自動でバックグラウンド起動するので不要です。

インストール確認

ターミナルを開いて以下を実行：

ollama --version

✅ バージョンが表示されればインストール完了！

ollama --version

curl -fsSL https://ollama.com/install.sh | sh

ollama --version

systemctl status ollama

🧠 Step 2: AIモデル（Qwen3）のダウンロード

Ollamaをインストールしたら、次にAIモデルをダウンロードします。MojiCraftのおすすめは Qwen3:4b です。

ダウンロード手順

1. ターミナル（コマンドプロンプト）を開く

• 🍎 macOS: Spotlight（Cmd + Space）で「ターミナル」と検索して開く
• 🪟 Windows: スタートメニューで「cmd」または「PowerShell」と検索して開く
• 🐧 Linux: Ctrl + Alt + T でターミナルを開く

2. 以下のコマンドを入力してEnter

ollama pull qwen3:4b

3. ダウンロードが始まる

約2.5GBのダウンロードが始まります。回線速度によって数分〜十数分かかります。

⏳ ダウンロード中 - プログレスバーで進捗がわかります

4. 「success」と表示されたら完了！

🎉 「success」が出ればダウンロード完了！

5. インストール確認（任意）

ダウンロードしたモデルが正しくインストールされているか確認するには：

ollama list

📋 qwen3:4b が表示されればOK

6. 動作テスト（任意）

モデルが正しく動くかテストしてみましょう：

ollama run qwen3:4b "こんにちは！自己紹介して"

💬 日本語で返答が来ればAIモデルは正常に動作しています

📊 モデル比較表

他のモデルを使いたい場合は、以下を参考にしてください。

🔧 Step 3: MojiCraftでAI要約を有効にする

Ollamaとモデルの準備ができたら、最後にMojiCraftの設定でAI要約をONにします。

設定手順

1. 設定メニューを開く

MojiCraft起動中に s + Enter を押すか、以下のコマンドを実行：

./mojicraft --configure

2. 「2. AI要約」を選んで y で有効化

メインメニューで 2 を入力 → 「LLM要約を有効にしますか？」に y を入力。

✅ 「2. AI要約」を選んで「y」で有効化

3. モデル設定を確認

デフォルト設定のままでOKです。変更は不要！

⚙️ プロバイダー「ollama」、モデル「qwen3:4b」になっていればOK

4. 保存して終了

Enterで戻って、メインメニューで s を入力して保存。

🩺 設定後の動作確認

すべてが正しく設定されているか、環境診断で確認しましょう：

./mojicraft --doctor

🩺 Ollamaサーバー起動中 + モデル検出済み = 準備完了！

⚠️ よくあるトラブル

「Ollama server: not running」と表示される場合

❌ Ollamaが起動していない場合の表示

解決方法：

• 🍎 macOS（公式アプリ版）: アプリケーションフォルダから Ollama.app をダブルクリック。メニューバーにラマ 🦙 アイコンが出ればOK
• 🍎 macOS（Homebrew版）: 別のターミナルで ollama serve を実行
• 🪟 Windows: スタートメニューから「Ollama」を検索して起動。タスクトレイにラマ 🦙 アイコンが出ればOK
• 🐧 Linux: sudo systemctl start ollama を実行

「Ollama model: qwen3:4b not installed」と表示される場合

モデルのダウンロードがまだ完了していません。以下を実行してください：

ollama pull qwen3:4b

📄 対応フォーマット

🎵 そのまま処理できるフォーマット

🎬 ffmpegで自動変換されるフォーマット

💻 コマンド一覧

🔍 トラブルシューティング

🍎 macOSで「開けません」と表示される

macOSのセキュリティ機能（Gatekeeper）により、初回起動時にブロックされることがあります。

対処法1: 「MojiCraftを起動」アプリを使う

同梱の「MojiCraftを起動.app」をダブルクリックすると、初回のみ自動でセキュリティ属性を解除します。

対処法2: システム設定から許可

1. 「システム設定」→「プライバシーとセキュリティ」を開く
2. 「"mojicraft"は開発元が未確認のため〜」の横にある「このまま開く」をクリック

対処法3: ターミナルでコマンド実行

xattr -cr /path/to/MojiCraft

🔧 whisper-cliが見つからない

MojiCraft起動時にエラーが出る場合、環境診断を実行してください：

./mojicraft --doctor

whisper-cliのインストール状態が確認できます。Apple Silicon Macとwindows版は同梱されているので、通常は問題ありません。

🤖 AI要約が動かない

1. Ollamaが起動しているか確認（メニューバー/タスクトレイにラマアイコン 🦙）
2. モデルがダウンロード済みか確認：ollama list
3. MojiCraftの設定でAI要約がONになっているか確認
4. ./mojicraft --doctor でOllamaの状態を確認

📝 その他の問題

./mojicraft --doctor を実行すると、環境の問題を自動診断します。
ログは mojicraft.log に記録されています。

❓ よくある質問