# SynapseRack

> SynapseRack is a node-based VJ / realtime visual performance application for Windows and macOS. This file indexes the official documentation for AI assistants (llms.txt convention). Full content: /llms-full.txt

## Documentation (Japanese, canonical)

- [Hapコーデックとは](https://synapserack.com/ja/docs/about-hap-codec/)
- [Apps SDK（プラグイン開発）](https://synapserack.com/ja/docs/apps-sdk/): JavaScriptでSynapseRackを操作する自作アプリ（プラグイン）を書く仕組み。AppHubからの作り方、アプリフォルダの場所、APIの概観、実行・リロード・コンソール、MCPサーバーまでを実装に沿って解説します。
- [会場の音に反応させる（AudioReactive）](https://synapserack.com/ja/docs/audio-reactive/): マイクやループバックで拾った会場の音を信号に変えて、レイヤーの不透明度やエフェクトの強さを自動で動かす方法。AudioReactive ノードの Bass と Hit を使った実例を、繋ぎ方の図つきで解説します。
- [音楽に合わせる（Beat Sync）](https://synapserack.com/ja/docs/beat-sync/): SynapseRack で映像を曲に合わせる方法の入口。全体のBPMを決める Global Tempo、レイヤーの Beat Sync、拍に乗るノード、Ableton Link や MIDI Clock などの外部同期を、実装に沿って整理します。
- [お問い合わせ](https://synapserack.com/ja/docs/contact/)
- [クロスフェードループ](https://synapserack.com/ja/docs/crossfade-loop/): ループの継ぎ目のカット割れを、クリップの終わりと始まりを重ねて隠す機能。Layer ウィンドウ下段のトグル1つで効きます。重なる長さ・効く素材・素材ごとの記憶を、実装に沿って解説します。
- [よくある質問(FAQ)](https://synapserack.com/ja/docs/faq/): 対応OS・使える動画フォーマット・素材の保存場所・表示言語・無料版の制限・ライセンス認証・レガシー表記の意味など、SynapseRackでよく聞かれることをまとめました。
- [Fx Editor（カスタムエフェクト .srfx）](https://synapserack.com/ja/docs/fxeditor/): ブラウザでGLSLシェーダーを書き、.srfx として書き出して SynapseRack の CustomFx フォルダに入れると、自分だけのエフェクトノードになります。Webエディタの使い方から、アプリ側の読み込み・ホットリロード・制約までを実装に沿って解説します。
- [ドキュメント](https://synapserack.com/ja/docs/intro/)
- [キーボードマッピング](https://synapserack.com/ja/docs/keyboard-mapping/): パソコンのキーを画面のUIに割り当てる機能。MIDIと同じアサインモード（Setting → MidiMapping）の中で、青いUIをクリックして赤にし、そのままキーを叩けば紐付きます。押している間だけ効く挙動と、割り当てられないキーについて。
- [Shader(.hlsl)ファイルを読み込む](https://synapserack.com/ja/docs/load-shader/): レイヤーで直接再生できる .hlsl シェーダー素材の仕組み。置き場所・書き方・渡される値をまとめます。現在エフェクトを自作するなら Fx Editor（.srfx）が推奨経路で、.hlsl 直置きは初期からある従来方式です。
- [Spout / Syphon / NDI を読み込む、出力する](https://synapserack.com/ja/docs/load-spout/): 他のアプリとリアルタイムに映像をやり取りする方法。Media Browser の Spout | Syphon / NDI 行からの受信、受信ノードと送信ノード、常時出ている本体の出力（SynapseRackMain）までを、実装に沿って解説します。
- [映像・画像ファイルを読み込む](https://synapserack.com/ja/docs/load-video/): 映像・画像をSynapseRackに取り込む方法。OSからのドラッグ&ドロップ（落とす場所で挙動が変わる）、MediaBrowserでの整理・検索・自然言語検索、対応フォーマットと再生可否バッジを、実装に沿って解説します。
- [MIDIマッピング](https://synapserack.com/ja/docs/midi-mapping/): MIDIコントローラーのつまみやパッドを、画面のUIへ直接割り当てる機能。Setting → MidiMapping でアサインモードに入り、青くなったUIをクリックして赤にし、動かしたいコントローラーを触るだけで紐付きます。使うデバイスの選択、MIDI Inspector の読み方、解除の仕方まで。
- [Group(グループ)](https://synapserack.com/ja/docs/module/group/): SynapseRackのGroupノード3種のリファレンス。ノードグラフを入れ子のサブグラフとして畳み、Group In / Group Out で境界の出入口を作る方法を説明します。
- [Math(計算)](https://synapserack.com/ja/docs/module/math/): SynapseRackのMathノード全16種のリファレンス。四則演算・丸め・補間の一覧に加えて、Triggerが再送信であること、Divideのゼロ除算、Lerpのクランプなど実装からしか分からない挙動をまとめています。
- [Operation(判定と制御)](https://synapserack.com/ja/docs/module/operation/): SynapseRackのOperationノード全11種のリファレンス。論理演算・IFFilter・Counter・Switch・Randomの一覧と、真偽の境界が1.0であることやCounterがLoop OFFではクランプされないことなど、実装からしか分からない挙動をまとめています。
- [Output(出力)](https://synapserack.com/ja/docs/module/output/): SynapseRackのOutputノード5種のリファレンス。MasterOutput / MasterResolution でマスター映像と解像度をグラフへ引き込み、MediaOut / SpoutSender / NDISender で外へ出す方法を説明します。
- [UI](https://synapserack.com/ja/docs/module/ui/): SynapseRackのUIノード全3種のリファレンス。Slider / Button / Toggle の使い方と、入力ポートがUIそのものを動かす双方向の作りになっていることを説明します。
- [Variable(変数)](https://synapserack.com/ja/docs/module/variable/): SynapseRackのVariableノード全6種のリファレンス。Float / Int / String と、それぞれの配列版の使い方。Triggerによる再送信と、Index が剰余でラップする挙動をまとめています。
- [OBSに出力する](https://synapserack.com/ja/docs/obs/): SynapseRackの映像をOBSへ取り込む方法。マスター出力は常に Spout（Windows）/ Syphon（macOS）で SynapseRackMain という名前で流れているので、OBS側にプラグインを入れて選ぶだけです。SpoutSenderノードで途中の絵を別名で送る方法も説明します。
- [OSCの入出力](https://synapserack.com/ja/docs/osc-input-output/): スマホやTouchDesigner等からSynapseRackを操作し、逆にSynapseRackから値を送るための設定。受信したアドレスを一覧から選んで画面のUIに割り当てる手順と、OSCノードで自由に配線する方法。
- [プロジェクターに出力する](https://synapserack.com/ja/docs/projector/): SynapseRackの映像をプロジェクターや外部ディスプレイへ出す方法。同梱の出力ウィンドウ、ウィンドウの切り離し（F10）、Spout / Syphon / NDI での他アプリ連携という3つの出口を、実装に沿って整理します。
- [ショートカット一覧](https://synapserack.com/ja/docs/shortcuts/): F10のウィンドウ切り離しや、数値フィールドの右ドラッグスクラブのような「知らないと気づけない操作」を1ページに集めました。キーボードショートカットと、暗黙のマウス操作を実装に沿ってまとめています。
- [VJ素材を読み込むパス(Source Directory)を指定する](https://synapserack.com/ja/docs/source-directory/): SynapseRack が作業データを置くフォルダ（SainaWorks/SynapseRack）の場所と中身。Settings.json の parentPath を書き換えて、別ドライブや外付けSSDへ移す手順を、実装に沿って解説します。
- [利用規約(Terms of Use)](https://synapserack.com/ja/docs/terms-of-use/)
- [4Layer構成でVJをしよう！](https://synapserack.com/ja/docs/tutorial/4layer/): 起動した瞬間から素材が入っていて、再生ボタンひとつでVJが始まるチュートリアル。素材の入れ替え、テンポ同期、エフェクト、MIDI、保存まで一通り体験します。
- [Widget Panel](https://synapserack.com/ja/docs/widget-panel/): 自分だけの操作画面を組むウィンドウ。空白を右クリックしてウィジェットを置き、Assign でノードのパラメータを指して紐付け、Freeze して演奏する——という一連の操作を、実装に沿って解説します。
- [Media Browser](https://synapserack.com/ja/docs/window/contents-browser/): 映像素材のライブラリ。フォルダ・タグ・検索で素材を探し、クリックやドラッグでレイヤーへ流し込みます。Spout / Syphon / NDI もここに並びます。
- [Global Tempo](https://synapserack.com/ja/docs/window/global-tempo/): SynapseRack 全体が参照する BPM と拍を管理するウィンドウ。タップテンポ、±1／÷2／×2、拍頭へのリセットが並びます。
- [Group Layer](https://synapserack.com/ja/docs/window/group-layer/): 複数のレイヤーをまとめて1枚として扱うためのレイヤー。中身を合成した結果に、さらに合成モードと不透明度をかけられます。
- [Layer](https://synapserack.com/ja/docs/window/layer/): 映像1枚ぶんを扱うウィンドウ。合成モード、不透明度、再生トランスポート、速度、Beat Sync、クロスフェードループが1枚に収まっています。
- [Layer Hierarchy](https://synapserack.com/ja/docs/window/layer-hierarchy/): レイヤーとグループの並び順・入れ子・削除を扱うウィンドウ。並びがそのまま合成順で、上が奥・下が手前です。
- [Layer Property](https://synapserack.com/ja/docs/window/layer-property-editor/): Layer / Group Layer ウィンドウの下端「Property」を開くと出てくるパネル。位置・回転・スケールと矩形マスクを数値で指定します。
- [Node Editor](https://synapserack.com/ja/docs/window/node-editor/): ノードを置いて繋ぐウィンドウ。パン・ズーム・選択・接続・グループ化のすべての操作を、実装のとおりにまとめました。
- [OSC Monitor](https://synapserack.com/ja/docs/window/osc-monitor/): 受信した OSC メッセージを最新30件まで、アドレス・値・型で表示するウィンドウ。配線が届いているかを確かめる用途に使います。
- [Preview](https://synapserack.com/ja/docs/window/preview/): 全レイヤーを合成したマスター出力を、縦横比を保ったまま確認する表示専用ウィンドウ。解像度は Setting → GlobalSettings で決まります。

## Node Reference

- [3D](https://synapserack.com/ja/docs/nodes/3d/): 29 nodes. Point-cloud based 3D scenes: generation, deformation, materials, cameras and rendering.
- [Audio](https://synapserack.com/ja/docs/nodes/audio/): 5 nodes. Audio analysis from mic or file: levels, bands and onsets to drive visuals.
- [Color](https://synapserack.com/ja/docs/nodes/color/): 10 nodes. Generate, split, combine and adjust colors.
- [Composite](https://synapserack.com/ja/docs/nodes/composite/): 5 nodes. Blend, crossfade, mask and switch between textures.
- [Field](https://synapserack.com/ja/docs/nodes/field/): 9 nodes. 2D vector fields (optical flow, noise) and field-driven distortion.
- [Fx](https://synapserack.com/ja/docs/nodes/fx/): 11 nodes. Core texture effect nodes: applying Fx chains, grading and compositing.
- [FxShader](https://synapserack.com/ja/docs/nodes/fxshader/): 76 nodes (+205 legacy). The shader effect library. Chain them via FxIn/FxOut ports.
- [Generator](https://synapserack.com/ja/docs/nodes/generator/): 7 nodes. Generate visuals from scratch: gradients, noise, SDF shapes, text.
- [Group](https://synapserack.com/ja/docs/nodes/group/): 3 nodes. Group nodes for reuse, with group input/output ports.
- [I/O](https://synapserack.com/ja/docs/nodes/io/): 17 nodes. External I/O: MIDI, OSC, DMX/ArtNet and more.
- [Layer](https://synapserack.com/ja/docs/nodes/layer/): 12 nodes. Access and control layers: opacity, visibility and more.
- [Math](https://synapserack.com/ja/docs/nodes/math/): 16 nodes. Numeric math: arithmetic, rounding, interpolation.
- [Operation](https://synapserack.com/ja/docs/nodes/operation/): 11 nodes. Logic and flow control: comparison, branching, triggers.
- [Output](https://synapserack.com/ja/docs/nodes/output/): 5 nodes. Final outputs: external windows, Spout/Syphon senders.
- [ProFx](https://synapserack.com/ja/docs/nodes/profx/): 6 nodes. High-quality premium effects.
- [Record](https://synapserack.com/ja/docs/nodes/record/): 11 nodes. Frame buffer record/playback and time-based effects (datamosh, time displacement).
- [Signal](https://synapserack.com/ja/docs/nodes/signal/): 16 nodes. Signal generation (LFO, easing, ADSR) and processing (smooth, remap).
- [Source](https://synapserack.com/ja/docs/nodes/source/): 10 nodes. Input sources: video, images, webcam, NDI/Spout receivers, WebView.
- [Tempo](https://synapserack.com/ja/docs/nodes/tempo/): 5 nodes. Tempo sync: Ableton Link, tap tempo, step sequencer.
- [UI](https://synapserack.com/ja/docs/nodes/ui/): 3 nodes. UI controls you can place on panels: buttons, sliders.
- [Variable](https://synapserack.com/ja/docs/nodes/variable/): 6 nodes. Hold and pass values across the graph.