118 lines
3.5 KiB
Markdown
118 lines
3.5 KiB
Markdown
# Blender VoiceVox Plugin
|
||
|
||
Blender 5.0 向けの VoiceVox 音声合成と字幕表示を統合したアドオンです。
|
||
|
||
## 機能
|
||
|
||
- **音声合成**: VoiceVox エンジンを使用してテキストから音声を生成
|
||
- **字幕表示**: 生成した音声と同期する字幕をシーケンサーに追加
|
||
- **カスタマイズ可能**: 話者、話速、音高、抑揚、音量などを調整可能
|
||
- **自動統合**: 生成した音声と字幕を自動的にシーケンサーに追加
|
||
|
||
## 必要なものeee
|
||
|
||
- Blender 5.0 以上
|
||
- VoiceVox エンジン（ローカルで実行中であること）
|
||
- https://voicevox.hiroshiba.jp/ からダウンロード
|
||
- デフォルトでは `127.0.0.1:50021` で動作
|
||
|
||
## インストール
|
||
|
||
### 開発環境のセットアップ（Nix + direnv）
|
||
|
||
```bash
|
||
# direnv を許可
|
||
direnv allow
|
||
|
||
# 開発環境に入る（自動的に有効化されます）
|
||
# または手動で: nix develop
|
||
```
|
||
|
||
### Blender へのインストール
|
||
|
||
1. このディレクトリ全体を Blender のアドオンフォルダにシンボリックリンク:
|
||
```bash
|
||
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 でのテスト
|
||
|
||
```bash
|
||
# バックグラウンドでテスト
|
||
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
|