# sd-webui-sound-player

ForgeNeo / reForge向けの小さな音楽再生拡張です。

txt2img / img2img の生成ボタン下に音符ボタンを追加し、クリックすると右下に
`Sound Player` パネルを表示します。設定した音声フォルダ内の `.mp3` / `.wav`
を選んで、WebUI上でそのまま再生できます。

## 対応環境

- ForgeNeo
- reForge

## インストール

この `sd-webui-sound-player` フォルダを、WebUIの `extensions` フォルダに入れて
WebUIを再起動してください。

例:

```text
stable-diffusion-webui/extensions/sd-webui-sound-player
```

## 主な機能

- txt2img / img2img のツールボタン列に音符ボタンを追加
- 指定フォルダ内の `.mp3` / `.wav` ファイルを一覧表示
- サブフォルダ内の音声も読み込み可能
- 再生 / 停止、頭出し、次のファイルへ移動
- リピートON/OFF
- 音量調整、再生位置シーク
- `+` ボタンで複数プレイヤーを追加し、複数音声を同時再生
- 全再生 / 全停止
- 前回選んだフォルダ、音声、リピート、音量、再生位置を記憶
- 起動時に自動再生しない

## 音声フォルダの設定

音声フォルダは、右下の `Sound Player` パネル内で指定できます。
また、WebUIの `Settings > Sound Player` からも設定できます。

初期状態では、拡張フォルダ内の `data/audio` が音声フォルダになります。
配布版には確認用の `sample.mp3` を同梱しているため、インストール直後に
そのまま再生テストできます。

ユーザーは `data/audio` に自分の `.mp3` / `.wav` を追加しても構いません。
別の音楽フォルダを使いたい場合は、パネル内のフォルダボタン、または
`Settings > Sound Player` から任意のフォルダを指定してください。

## 注意

- 対応形式は `.mp3` / `.wav` です。
- ブラウザ上で再生するため、WebUIやブラウザタブを閉じると音声も停止します。
- 大量の音声ファイルを含むフォルダでは、一覧更新に時間がかかる場合があります。
