# 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