【cluster想定】MIDI→OSC Bridge ーcluster live toolkitー

＊本ツールの利用によって生じたいかなる損害(機材故障・データ消失・ライブ事故・精神的苦痛 等)についても、作者は一切の責任を負いません。

＊ソフトエンジニアではない、素人がAIに作らせたツールです。

正直な話、ご自身でAIに作らせた方が良いと思います。

以下にAIでの作らせ方をまとめました。

https://docs.google.com/document/d/1o6RiAqsvR5vT2zQQEadLiIPi1G0QyG_ClJUhaSb_LX8/edit?usp=sharing

＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿

MIDI鍵盤を叩くだけで cluster ワールドのビジュアルがリアルタイムに反応。

ライブ・パフォーマンス・MV撮影に。

【このツールでできること】

cluster の Scriptable Item / PlayerScript と組み合わせて、

PC に接続した MIDI 機器(キーボード・ドラムマシン・DAWなど)の

Note On 信号 を OSC 経由で cluster ワールドにリアルタイム送信します。

シェーダー側で受け取れば、

キックに合わせて床に波紋を出す

音に反応してマーブル模様が脈動する

…など、ワールド演出を MIDI で完全制御できます。

＊専用のシェーダーが必要です。（AIに作ってもらおう）

使い方(ざっくり)

１．MidiToOsc.exe をダブルクリック

２．ウィンドウ上部のドロップダウンで MIDI ポートを選択

３．cluster ワールド側でホスト権（HostSwitch）を取得

４．MIDI鍵盤を叩く → ビジュアル反応!

５．Smoke 波形スライダーでリアルタイム調整（後述のワールドのみの機能）

詳細は同梱の README.md を参照してください。

clusterワールド

以下のワールドで本ツールを利用する事が出来ます。

「ドクドクの部屋」

https://cluster.mu/w/300a5fd3-af49-4585-9072-37b68e0949c7

同梱物

MidiToOsc/

├── MidiToOsc.exe ← 実行ファイル(これだけでOK)

├── README.md ← 使い方

動作環境

・Windows 10 / 11 (64bit)

・MIDI 出力可能な機器(USB-MIDIキーボード等)

・cluster ワールド側で OSC 127.0.0.1:9000 を受信できる構成(Scriptable Item / PlayerScript / OSC 受信実装が前提)

注意事項

・本ツールは cluster 公式アプリではありません。 個人制作のフリーツールです。

・cluster 側で OSC を受信する仕組み(Scriptable Item / PlayerScript)は別途実装が必要です。

・Windows SmartScreen / アンチウイルスが警告を出す場合があります。

PyInstaller でビルドした exe の既知の挙動です。

・動作保証・サポートはありません。 バグ報告は歓迎ですが、対応は時間のあるときに。

ライセンス / 利用規約

全フリー。

以下、自己責任で自由に行ってください:

・個人・商用問わず利用OK

・改変OK / 再配布OK / 同梱OK

・クレジット表記不要(あったら嬉しい程度)

cluster 側の規約変更等で動作しなくなった場合の対応義務もありません。

更新履歴

‐v2.0 (2026-05) PyInstaller化・自動再接続・設定永続化・ログ出力追加

‐v1.0 (初版) MIDI→OSC送信・Smoke波形コントロール

OSC 仕様(開発者向け)

送信先: 127.0.0.1:9000

アドレス　値　内容

/midi　[ch, note, vel(0-1)]　全 Note On

/ripple/speed　float　波の速さ

/ripple/decay　float　持続時間(秒)

/ripple/strength　float　高さスケール

/ripple/maxdist　float　最大距離