|
Download SYNC.md from RAM2118/pluginbridge: direct link, hf CLI and curl.
- Browser
- Download file 2.47 kB
-
https://huggingface.co/RAM2118/pluginbridge/resolve/ddb115bf829f00a019effbe2c307028edd9a0d27/SYNC.md
- Command line
-
hf download hf://RAM2118/pluginbridge@ddb115bf829f00a019effbe2c307028edd9a0d27/SYNC.md
-
curl -L -o SYNC.md https://huggingface.co/RAM2118/pluginbridge/resolve/ddb115bf829f00a019effbe2c307028edd9a0d27/SYNC.md
2.47 kB
| # PluginBridge β Sync File | |
| > HF Claude builds. Claude Code: pull β build β paste error (if any). That's it. | |
| --- | |
| ## Claude Code Rules (TOKEN EFFICIENT MODE) | |
| **Your ENTIRE job is these commands:** | |
| ```bash | |
| cd ~/pluginbridge && git pull | |
| cd build && cmake --build . --config Release 2>&1 | tail -30 | |
| ``` | |
| **If build succeeds:** Reply "β build ok" β nothing else. | |
| **If build fails:** Reply with ONLY the first 3 errors: | |
| ``` | |
| β [filename]:[line] β [one-line error message] | |
| ``` | |
| ## DO NOT: | |
| - Explain errors | |
| - Suggest fixes | |
| - Write code | |
| - Add commentary | |
| ## Architecture (Current) | |
| **Out-of-process hosting.** Two binaries: | |
| 1. `PluginBridge.vst3` β thin shell (audio bridge + MCP server), loaded in Ableton | |
| 2. `PluginBridgeHelper` β standalone exe bundled inside .vst3, hosts the actual plugin | |
| If a plugin crashes β only Helper dies β Ableton survives β UI shows "Reload" button. | |
| ## What Was Ditched | |
| - β In-process plugin hosting (crashed Ableton with some plugins) | |
| - β Plugin scanning via `PluginDirectoryScanner` (triggered NSAlert crashes) | |
| - β `addDefaultFormats()` (deleted in JUCE 8) | |
| - β `juce::Thread::setCurrentThreadPriority()` (removed in JUCE 8) | |
| - β `MSG_NOSIGNAL` (doesn't exist on macOS) | |
| - β `NSApplicationActivationPolicyAccessory` β broke fullscreen, reverted | |
| - β `showAsFloatingPanel()` with objc_msgSend level hacks β broke fullscreen, reverted | |
| - β `NSWindowCollectionBehavior` changes β didn't help, reverted | |
| - β Window level 25 (NSStatusWindowLevel) β unnecessary, reverted | |
| ## What's Working | |
| - β Out-of-process via shared memory + semaphores + Unix socket | |
| - β Crash-safe β plugins that abort() only kill the helper | |
| - β Plugin GUI via `setAlwaysOnTop(true)` β stays in same Space as Ableton (including fullscreen) | |
| - β X button hides GUI (doesn't quit Helper) | |
| - β Toggle GUI via button in PluginBridge panel (Open GUI / Close GUI) | |
| - β Plugin list from filesystem (no binary loading until user selects) | |
| - β Native pthread priority for audio thread | |
| ## Status | |
| **Last push:** 2026-05-16 β Fixed fullscreen issue. Root cause: commit 0632681 replaced `setAlwaysOnTop(true)` with objc_msgSend hacks that broke Space behavior. Fix: restored `setAlwaysOnTop(true)` + kept X button fix. | |
| **Build:** Needs test | |
| **Test:** Pull, build, Ableton fullscreen β Open GUI β should open in same Space. X button should hide (not quit). | |
| **Next:** Sprint 3 β MCP param control from Claude Code (curl tests) | |