-
-
Notifications
You must be signed in to change notification settings - Fork 158
Install
This page describes how to install Cardinal on a variety of systems.
If you rather build Cardinal from source, please follow this document instead.
Cardinal releases have official builds for Linux, macOS and Windows.
You can find these under https://github.com/DISTRHO/Cardinal/releases.
NOTE: at the time of writing, there are no official Cardinal releases yet.
You can find builds for pretty much any recent Cardinal commit at https://github.com/DISTRHO/Cardinal/actions/workflows/build.yml
Just click on any successful build, and scroll to the bottom to find the builds.
(note the canvas-like area in the middle prevents mouse wheel scrolling)
A GitHub account is required in order to download these builds.
The easiest way to install on Linux is to move the plugin folders to their respective user folder.
For LV2 this is ~/.lv2, for VST2 it is ~/.vst and for VST3 it is ~/.vst3.
Create the (hidden) folders if they do not exist yet, and move the respective Cardinal folders in there.
Make sure to move the complete folder (e.g. CardinalFX.vst) and not its contents.
It is important to leave the folder structure intact.
Cardinal macOS builds are in the usual pkg installer format, so there is nothing to copy or move like in other platforms.
Simply download the pkg file, right-click on it and select "install".
During the install setup you can choose to install any combination of LV2, VST2 and/or VST3.
There is no uninstall step, but you can simply remove the plugins from /Library/Audio/Plug-Ins.
Note:
The macOS builds are not signed or notarized.
The notarization is not needed when installing plugins from a pkg because, unlike manual copying, macOS will not place binaries installed from a pkg under "quarantine".
As long as you are able to run the installer, the plugins should run.
Note: The Windows builds are not signed, so Windows will say they are from an "untrusted developer".
Alternatively you can find Cardinal packaged in a few software repositories.
These do always not come from Cardinal developers directly, but are still somewhat supported.
Patches are welcome for fixing system-specific bugs, as long as they do not break compatibility with everything else.
Available as FreeBSD port, simply run pkg install cardinal to install it.