Initial SE Palette add-on

README.md

@@ -0,0 +1,46 @@
+# SE Palette for Blender
+
+Blender 5.x の Video Sequencer へ、フォルダ内の効果音をワンタッチで挿入するアドオンです。VSEのNサイドバーに常駐します。専用のVSE Areaを作り、そのサイドバーを幅いっぱいに広げればSE専用エリアとして使えます。
+
+## 機能
+
+- MP3 / WAV / FLAC / OGG / M4A / AAC をフォルダから自動一覧化
+- 各SEのメインボタンを押すだけで、現在のシークバー位置へ挿入
+- 再生ボタンでタイムラインへ追加せずに試聴、同じボタンの再押下で停止
+- SEごとに表示名、Blender組み込みアイコン、任意のPNG/JPEGアイコンを設定
+- 名前検索、音量指定、配置チャンネル指定
+- 1〜10列から選べるカード型グリッドレイアウト
+- 同じ時間帯に音がある場合は、上の空きチャンネルへ自動配置
+- 任意で挿入後にシークバーをSE末尾へ移動
+
+初期SEフォルダは `/home/hare/Assets/SE/` に設定されています。
+
+## インストール
+
+1. Blenderの `Edit > Preferences > Get Extensions` を開く
+2. 右上メニューから `Install from Disk...` を選択
+3. ビルド済みの `se_palette-1.3.0.zip` を選択
+4. Video EditingワークスペースでVideo Sequencerを開く
+5. `N` キーでサイドバーを開き、`SE Palette` タブを選択
+
+`Unable to parse the manifest` と表示される環境では、マニフェストを使わない
+`se_palette-legacy-1.3.0.zip` を `Install from Disk...` から選択してください。
+
+## 試聴について
+
+試聴用のOpenALデバイスはアドオン内で1つだけ生成し、繰り返し再利用します。以前の版で
+`Buffer generation failed while starting playback with OpenAL` が発生した場合は、1.0.2以降へ
+更新後にBlenderを一度再起動してください。引き続き再生できない場合は
+`Preferences > System > Sound` のAudio Deviceを確認してください。
+
+## 使い方
+
+1. 上部でSEフォルダを選び、更新ボタンを押す
+2. SE名のボタンで挿入、右側の再生ボタンで試聴
+3. 歯車ボタンから表示名・組み込みアイコン・カスタム画像を編集
+
+編集内容はSEフォルダ内の `.se_palette.json` に保存されます。カスタム画像を指定すると組み込みアイコンより優先されます。
+
+## ライセンス
+
+MIT License