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
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:
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:
PluginBridge.vst3β thin shell (audio bridge + MCP server), loaded in AbletonPluginBridgeHelperβ 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 - β
NSWindowCollectionBehaviorchanges β 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)