Blender VoiceVox Plugin

Blender 5.0 向けの VoiceVox 音声合成と字幕表示を統合したアドオンです。

機能

• 音声合成: VoiceVox エンジンを使用してテキストから音声を生成
• 字幕表示: 生成した音声と同期する字幕をシーケンサーに追加
• カスタマイズ可能: 話者、話速、音高、抑揚、音量などを調整可能
• 自動統合: 生成した音声と字幕を自動的にシーケンサーに追加

必要なものeee

• Blender 5.0 以上
• VoiceVox エンジン（ローカルで実行中であること）
  • https://voicevox.hiroshiba.jp/ からダウンロード
  • デフォルトでは 127.0.0.1:50021 で動作

インストール

開発環境のセットアップ（Nix + direnv）

# direnv を許可
direnv allow

# 開発環境に入る（自動的に有効化されます）
# または手動で: nix develop

Blender へのインストール

1. このディレクトリ全体を Blender のアドオンフォルダにシンボリックリンク:

   ln -s $(pwd) ~/.config/blender/5.0/scripts/addons/blender-voicevox-pl
   

2. または、Blender の UI からインストール:

   • Edit > Preferences > Add-ons
   • Install ボタンをクリック
   • このディレクトリを zip 化したファイルを選択

3. アドオンを有効化:

   • "VoiceVox TTS & Subtitles" を検索
   • チェックボックスをオンにする

使い方

1. VoiceVox エンジンを起動

   • VoiceVox アプリケーションを起動するか
   • VoiceVox エンジンをコマンドラインで起動

2. Blender でシーケンスエディタを開く

   • ウィンドウタイプを "Video Sequencing" に変更

3. VoiceVox パネルを開く

   • サイドバー（N キー）の "VoiceVox" タブをクリック

4. 接続をテスト

   • "Test Connection" ボタンをクリックして VoiceVox に接続できるか確認

5. 音声と字幕を生成

   • テキストを入力
   • 話者や音声パラメータを調整
   • "Generate Speech & Subtitle" ボタンをクリック

開発

プロジェクト構成

.
├── __init__.py       # アドオンのエントリーポイント
├── operators.py      # ユーザー操作の実装
├── panels.py         # UI パネルの定義
├── properties.py     # プロパティの定義
├── voicevox.py       # VoiceVox API 連携
├── subtitles.py      # 字幕管理
├── flake.nix         # Nix 開発環境設定
└── README.md         # このファイル

Blender でのテスト

# バックグラウンドでテスト
blender --background --python-expr "import bpy; bpy.ops.preferences.addon_enable(module='blender-voicevox-pl')"

# GUI でテスト（開発用）
blender

トラブルシューティング

VoiceVox に接続できない

• VoiceVox エンジンが起動しているか確認
• ホスト・ポート設定が正しいか確認（デフォルト: 127.0.0.1:50021）
• ファイアウォールがブロックしていないか確認

音声ファイルが生成されない

• 出力ディレクトリの書き込み権限を確認
• VoiceVox エンジンのログを確認

字幕が表示されない

• シーケンスエディタで正しいチャンネルを表示しているか確認
• レンダー設定で字幕のストリップが有効になっているか確認

ライセンス

MIT License

作者

Your Name