852wa / JIZURA

# JIZURA 字面 — 文字PV自動構成ツール
**English edition:** Open the app · English guide　／　**Bahasa Indonesia**：Buka · Panduan　**Tiếng Việt**：Mở · Hướng dẫn　**繁體中文**：開啟　**简体中文**：打开　**한국어**：열기 · 한국어 가이드
英語版 AE パネル：ScriptUI · CEP
歌詞を入れると、文字PV（リリックモーション）でよく使われる表現を組み合わせてカットを自動で組み立て、MP4 に書き出すブラウザアプリです。レイアウト・動き・装飾・つなぎ・仕上げを 860 の小さな部品（と 27 のスタイル）として持ち、その組み合わせを毎回変えるので、シードを変えれば何度でも別の構成になります。After Effects 用のパネル（スクリプト版と、ブラウザ版の画面をそのまま使える CEP 版）も付属しています。
**バージョン：v0.9.0**（変更の記録は CHANGELOG.md）
**▶ ブラウザで使う： **　／　AE パネル：JIZURA_AE.jsx（スクリプト版。リンク先を右クリック →「名前を付けてリンク先を保存」）・JIZURA_CEP.zip（CEP 版）
- インストール不要。歌詞・曲・書き出しはすべてブラウザの中で処理され、サーバーには送信されません（外部から読み込むのは Google Fonts のフォントだけで、今の構成で使う書体だけを読み込みます）。
- おまかせボタン（キー `R`）で、押すたびにスタイル・雰囲気・動き・配色・構成がまるごと変わります。
- 画面比 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / 4:5 / 21:9、720p〜4K、24 / 30 / 60fps。
- 曲を読み込むと拍を検出してカットを合わせます。タップでの手動同期もできます。
- MP4（曲入り）・連番PNG・透過PNG で書き出し。背景を**グリーンバック / ブラックバック**（白い文字と演出だけ）にして、合成用の素材としても書き出せます。After Effects で編集できる構成データ（JSON）も書き出せます。
| ファイル | 中身 |
|---|---|
| `index.html` | ブラウザ版の本体（ビルド済み・1ファイル）。GitHub Pages ではこれが開きます。ダウンロードしてローカルで開いても使えます |
| `JIZURA_AE.jsx` | After Effects 用のパネル・スクリプト版（ビルド済み） |
| `JIZURA_CEP.zip` | After Effects 用のパネル・CEP 版（ビルド済み。展開してインストール用のファイルを実行） |
| `src/` `app/` | ブラウザ版のソース（エンジン・表現パック・UI） |
| `ae/` | AE パネルの生成エンジンのソース |
| `cep/` | CEP 版パネルの外枠（manifest・AE との橋渡し・インストール用ファイル） |
| `docs/EXPRESSION_PACKS.md` | 表現部品（パック）を追加する人向けのガイド |
 動作環境 
- **MP4 書き出し**：WebCodecs に対応したブラウザ（Chrome / Edge 推奨。Safari 16.4 以降・Firefox 130 以降も WebCodecs に対応していますが、H.264 で書き出せるかはブラウザと OS によります）。対応していない環境でも、プレビューと連番PNG書き出しは使えます。
- スマホでも使えます（iPhone は iOS 16.4 以降の Safari、Android は Chrome）。長い曲を高い解像度で書き出すときは PC をおすすめします。
- フォントは Google Fonts から、使う書体だけを必要なときに読み込みます（オフラインのときは PC のフォントで代用）。
 利用について（出力物の権利とライセンス） 
- このツールで作った**動画や画像（出力物）の権利は、作った人に帰属します**。商用・非商用を問わず自由に使えます。
- 使った歌詞や曲の権利は、それぞれの権利者に帰属します。
- ツール本体は MIT ライセンスで公開しています。詳しくは LICENSE を見てください。
- 入力した歌詞や曲は、ブラウザの中だけで処理され、サーバーには送信されません。
- アプリ画面でも、右上の「利用について」ボタン（かんたんモードでは書き出しボタンの下のリンク）から同じ内容を確認できます。
 おまかせ（かんたんモード） 
右上の「かんたん / 詳細」で画面を切り替えられます。最初はかんたんモードで開きます（スマホでは「スマホ」モード。下の「スマホモード」を見てください）。
- **おまかせで作る**（キーボードの `R` でも可）：押すたびに次をまとめてランダムに決め直し、頭から再生します。
 - スタイル（直前と同じものは出ません）
 - 雰囲気（グリッチ / しっとり / ポップ / グラフィック / エディトリアル / エモーショナル / 全部入り。「ホラーの演出も使う」がオンのときはホラーも）。雰囲気ごとに、動きの強さ・グリッチの量・使うレイアウトや登場・退場の手法が変わります。
 - 見出しや明朝枠の書体
 - 配色（ときどき、アクセント色とズレ色A/Bもランダムになります）
 - カット構成（シード）
- **◀ 前の案 / 次の案 ▶**：おまかせで出した案を行き来できます。気に入った案に戻ってから書き出せます。
- **ここだけ変える**：今の案を活かしたまま、一部だけを振り直します。
 - スタイル / 配色（アクセント・ズレ色A/B）/ 雰囲気（動きと使う手法）/ 構成（レイアウトと動きの組み合わせ）
- 歌詞・曲・タイミング・書き出し設定は、おまかせでは変わりません。行リストで鍵をかけた行もそのまま残ります。
 ランダムで使う演出の範囲 
おまかせボタンの下（詳細モードでは「手法」タブの上）にあるチェックで、おまかせ・シャッフル・行ごとの再抽選で選ばれる演出を決められます。
- **追加分の演出も使う**（初期状態：オフ）：オフのときは、最初の公開版の演出（356部品・スタイル12種）だけを使います。オンにすると、あとから追加した演出（351部品・スタイル12種・書体6種）も候補になります。
- **和風の演出も使う**（初期状態：オン）：提灯・はがき・障子・扇・家紋・青海波・桜の花びらなどの和風グラフィックと、和風のスタイル（サクラ・墨と朱）です。オフにすると選ばれなくなります。この判定は、追加分のチェックのあとに適用されます。
- **文字PV系の部品を使う**（初期状態：オン）：最初の公開版の部品から派生した、線・数字・字組みだけで見せる部品（50）です。絵やモチーフではなく、文字そのものを主役にします（大字挟み・見切れ大文字・十字組・ルビ振