Polyrhythm MIDI Generator / JUCE-First Build

Poly-Phase
Blender

JUCE のプラグインホストと React WebUI を一体化し、Base と Compound の 2 つの時間軸をクロスフェードしながら扱うポリリズム・シーケンサー。演奏面、編集面、strict host diagnostics までを一つの導線にまとめています。

Open Repository Read Manual View UI Spec

Runtime: JUCE + React/Vite Plugin processor and WebUI editor in one build.
Output: MIDI Generator Two loops, one blended event stream.
Host Path: Ableton + Debug Host Direct load checks before DAW scan.
Current Focus: WebUI VST3 Legacy runtime branches are archived.

Base

Compound

Blend

Operator Flow

Host Tempo / Internal Clock

Auto・Host・Internal の切替から時間基準を決め、DAW transport または standalone clock を受けます。

Base / Compound Pattern

2 系統の 8-lane drum sequencer が独立に走り、16/24 step と groove を別々に保持します。

Crossfader / Density

演奏時は X と Density を主軸にし、どちらのレイヤーが勝つかを確率的に調整します。

MIDI Out / Bundle Diagnostics

生成された MIDI をホストへ送りつつ、bundle 側は codesign と moduleinfo を別系統で検査します。

Current State

Surface

Performance / Edit / Settings の各画面で、縦に長くなる情報は二段目タブへ再編成済みです。

Deployment

verify script と system install script を分離し、privilege escalation を copy step に限定しています。

Diagnostics

Debug host は Load と Bundle を分離表示し、Repair Bundle まで含めた完全版の checker として動きます。

Direction

JUCE + WebUI を正本にし、過去の runtime branches は archive へ退避しています。

Latest FIL Surface

One page, four focused views

長い説明を一枚に積み上げるのではなく、役割ごとに view を切り替える構成にしています。primary action は常に明確なボタン、補助情報は隣接 view に逃がす方針です。

Core Motion

Two clocks, one blended stream

Base は基準クロック、Compound は ratio によって速度が変わる複合クロックです。両者のイベントを blend し、最終的な MIDI stream を生成します。

Operator Priority

Crossfader-first instrument

演奏時の中心は Crossfader X と Density です。Base / Compound のどちらが勝つかを UI の中央で扱い、automation にもそのまま割り当てやすい設計にしています。

Loop Policy

Independent or Mutual Reset

自由に回り込む Independent と、短い周期で両者を再同期する Mutual Reset を切り替え、フェージングとハードなリセット感を分離しています。

Output Model

MIDI-only by intent

このプロジェクトは音を鳴らすのではなく、8-lane drum map の MIDI を外部 instrument へ送る generator として成立させています。

Musical Skeleton

Ratio defines re-alignment

Ratio

4:3 / 5:4 / 7:4

A:B で表記し、decimal ではなく rational relation として扱います。

Phase

Drift and re-alignment

Compound が ratio に従って進み、位相差が周期的に戻ることでポリリズムの骨格を作ります。

Blend

Probability and density

クロスフェーダーで勝者を選び、Density で最終出力量を絞るため、演奏的な変化を少数パラメータで作れます。

Performance

Motion / Blend / Output

Performance は演奏中の主タスクに合わせ、transport 系・blend 系・output 系を二段目タブへ整理しました。常時見るべき情報だけを front に残しています。

Edit

Workflow / Base / Compound

Edit では step grid を役割別に分け、操作列と pattern 本体を同じ view に押し込まないようにしています。scroll-heavy な領域は local tabs へ移しました。

Settings

Routing / Runtime / About

Runtime 情報や host diagnostics は Settings の隣接 view へ分離し、演奏時の情報面と debug 面を混ぜない構成にしています。

Interaction

Explicit action surfaces

リンクや補助機能は plain text にせず、明確な action surface として表示します。FIL の monochrome UI でも押せるものが一目で分かることを優先しています。

Current UI Contract

Screen roles

Performance

Live transport and blend

Mode, Ratio, Crossfader, Density, output note map をライブ面として扱います。

Edit

Pattern programming

Base / Compound の 8-lane grid、genre generator、groove、presets を集約します。

Settings

Host and bundle state

routing と runtime を並列に見せつつ、演奏面からは切り離した view として扱います。

Processor

JUCE plugin core

PluginProcessor が host transport、parameter、MIDI event generation を受け持ちます。分類・bus layout・bundle metadata もここに接続しています。

Editor

Resource-served WebUI

PluginEditor は file direct load ではなく resource provider で SPA を配信し、JUCE 内で同一 origin の WebUI を成立させます。

Frontend

React/Vite control surface

WebUI は operator-facing surface として設計し、store と host bridge を通して state を保ちます。asset path は plugin 内配信に合わせて相対化済みです。

Diagnostic Path

DAW before DAW

専用 debug host で scan・instantiate・editor create・bundle diagnostics を先に通し、DAW 固有の不透明さを減らします。

Build Graph

Runtime chain

React / Vite build

`webpage/polyphase-blender/dist` に WebUI を生成し、plugin editor が読み込める状態にします。

JUCE CMake build

VST3 bundle と debug host app を build し、必要に応じて system install まで進めます。

Bundle diagnostics

moduleinfo strict JSON、codesign、host role、editor creation を app 内で切り分けます。

DAW validation

Ableton Live の scan と open を最後に確認し、plugin classification と bus layout を host 観点で詰めます。

One-shot

verify-webui-vst3.sh

WebUI build、CMake configure、VST3 build、system install を一度に回す入口です。権限昇格は install step に限定します。

Checker App

PPB Plugin Debug Host

Load と Bundle を分けて表示し、strict host で落ちる問題を DAW 外で先に見つけるための完全版 checker として使います。

Repair

Bundle fixups in app

codesign や moduleinfo の不整合は app から Repair Bundle を実行して修正し、そのまま再読込できます。

Host Reality

Ableton-aware classification

plugin classification、bus layout、scan cache を Live の実挙動に合わせて詰めることで、readable でも開けない bundle を減らしています。

Primary Commands

Build, check, install

./scripts/verify-webui-vst3.sh

./scripts/run-plugin-debug-host.sh "/Library/Audio/Plug-Ins/VST3/Poly-Phase Blender.vst3"

sudo ./scripts/install-system-vst3.sh "/Users/you/path/to/Poly-Phase Blender.vst3"

Deployment Logic

What gets checked first

Bundle

codesign / moduleinfo

strict host に受け入れられるかを、editor 描画以前に判定します。

Load

scan / instantiate / editor

DAW なしで instance 作成と UI mount まで通してから、本番 host へ渡します。

Host

Live scan and open

最後に Ableton Live で scan / insert / open を確認し、host 固有の癖だけを残します。

Documentation

Project entry points

開発者向け導線と運用者向け導線を分け、repo・manual・UI spec・concept summary を明示的に開けるようにしています。

Open GitHub Repository

Open README Open Manual

Open UI Spec Open Concept Note

Operational Route

Recommended verification path

開発中は debug host で bundle を確定し、その後で system install と DAW scan に進むのが最短です。白画面や codesign 破損はこの順序でほぼ切り分けられます。

Open verify script

Open debug host script Open install script

Poly-PhaseBlender