Skip to main content
Install the Vibrai M4L device, Python remote script, and Ableton templates.

​
Command line

​
install device

Install the Vibrai Max-for-Live device + JS bridge into Live’s User Library
​
--force
Overwrite an existing install whose files differ from the source.
​
--source
[[advanced]] Override the source directory (test/debug use).
​
--dest
[[advanced]] Override the destination directory (test/debug use).
​
--user
Install into <name>‘s home directory instead of the current user’s. Used by the macOS .pkg postinstall to deposit files into the real installing user’s Ableton User Library when running as root.

​
install remote-script

Install the Vibrai Python remote script into Live’s User Library
​
--force
Overwrite an existing install whose files differ from the source.
​
--source
[[advanced]] Override the source directory (test/debug use).
​
--dest
[[advanced]] Override the destination directory (test/debug use).
​
--user
Install into <name>‘s home directory instead of the current user’s. Used by the macOS .pkg postinstall to deposit files into the real installing user’s Ableton User Library when running as root.

​
install templates

Install the Vibrai Starter and Vibrai Demo Ableton templates into Live’s User Library (always overwrites)
​
--source
[[advanced]] Override the source directory (test/debug use).
​
--dest
[[advanced]] Override the destination directory (test/debug use).
​
--user
Install into <name>‘s home directory instead of the current user’s. Used by the macOS .pkg postinstall to deposit files into the real installing user’s Ableton User Library when running as root.

​
install all

Install the M4L device, the Python remote script, and the Ableton templates
​
--force
Overwrite existing installs whose files differ from the source.
​
--user
Install into <name>‘s home directory instead of the current user’s. Used by the macOS .pkg postinstall to deposit files into the real installing user’s Ableton User Library when running as root.

​
MCP tools

​
install_device

Copy the bundled vibrai.amxd Max-for-Live device + JS bridge files into the user’s Ableton User Library. By default refuses to overwrite a modified install — pass force=true to clobber. Run once after installing the .mcpb extension; then open Ableton Live and drag vibrai.amxd onto a track. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.
​
force
Boolean
Overwrite an existing install whose files differ from the source (default false)
​
source_override
String
[advanced] Test-only override for the source directory
​
dest_override
String
[advanced] Test-only override for the destination directory

​
install_vibrai_remote_script

Copy the bundled Vibrai Python remote script into Live’s User Library Remote Scripts directory. By default refuses to overwrite a modified install — pass force=true to clobber. After install, restart Live and enable ‘Vibrai’ under Preferences → Link/Tempo/MIDI → Control Surface. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.
​
force
Boolean
Overwrite an existing install whose files differ from the source (default false)
​
source_override
String
[advanced] Test-only override for the source directory
​
dest_override
String
[advanced] Test-only override for the destination directory

​
install_templates

Copy the bundled “Vibrai Starter” (blank, bridge preloaded on a Return track) and “Vibrai Demo” (a ready-to-play loop) Ableton Live Set templates into your Ableton User Library’s Templates/Vibrai folder. Always overwrites — templates are refreshed on every install/update and are not meant to be hand-edited in place. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.
​
source_override
String
[advanced] Test-only override for the source directory
​
dest_override
String
[advanced] Test-only override for the destination directory

​
install_all

Install the Max-for-Live device, Python remote script, and Ableton templates in one call — equivalent to install_device + install_vibrai_remote_script + install_templates run in sequence. Stops at the first failure (each step must succeed before the next runs). Templates always overwrite regardless of force. Returns per-target results (device, remote_script, templates).
​
force
Boolean
Overwrite existing device/remote-script installs whose files differ from the source (default false). Templates always overwrite regardless of this flag.