Hare/blender-voicevox-pl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5 Commits 1 Branch 0 Tags 69 KiB
Python 96.2%
Nix 3.8%
4973220a3f
Go to file
Hare 4973220a3f chore: nix env
2026-02-04 22:08:41 +09:00
__init__.py feat: reference text strip 2026-02-04 21:11:17 +09:00
.envrc init 2026-02-04 19:51:39 +09:00
.gitignore init 2026-02-04 19:51:39 +09:00
flake.lock init 2026-02-04 19:51:39 +09:00
flake.nix chore: nix env 2026-02-04 22:08:41 +09:00
operators_reference.py feat: reference text strip 2026-02-04 21:11:17 +09:00
operators_speaker.py feat: reference text strip 2026-02-04 21:11:17 +09:00
operators.py fix: transform 2026-02-04 21:49:33 +09:00
panels.py feat: UI layout 2026-02-04 21:50:44 +09:00
properties.py feat: reference text strip 2026-02-04 21:11:17 +09:00
README.md init 2026-02-04 19:51:39 +09:00
subtitles.py fix: transform 2026-02-04 21:49:33 +09:00
voicevox.py feat: reference text strip 2026-02-04 21:11:17 +09:00

README.md

Blender VoiceVox Plugin

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

機能

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

必要なものeee

  • Blender 5.0 以上
  • VoiceVox エンジン（ローカルで実行中であること）

インストール

開発環境のセットアップ（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