Skip to content
Filipe Coelho edited this page Feb 14, 2022 · 26 revisions

This page describes how to install Cardinal on a variety of systems.
If you rather build Cardinal from source, please follow this document instead.

Official builds

Download

Cardinal releases have official builds for Linux, macOS and Windows.
You can find these under https://github.com/DISTRHO/Cardinal/releases.

There are builds for Linux, macOS and Windows.
Linux with various architectures (armhf, arm64, i686 and x86_64), macOS with universal builds (arm64 and intel) and Windows 32 and 64bit.

Nightly builds

You can find builds for pretty much any recent Cardinal commit here.
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.

Installation

Linux

The easiest way to install on Linux is to move the plugin bundle to their respective user folder.
For LV2 this is ~/.lv2, for VST2 it is ~/.vst and for VST3 it is ~/.vst3.

Create the format-specific (hidden) folders if they do not exist yet, and move the respective Cardinal bundles in there.
Make sure to move the complete bundles (e.g. CardinalFX.vst) and not their contents.
It is important to leave the bundle folders structure intact.

macOS

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 anyway. 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.

Windows

Cardinal Windows builds do not come as an installer, the plugin bundles need to be moved to their appropriate folder manually.
For LV2 this is %COMMONPROGRAMFILES%\LV2, for VST2 it is %PROGRAMFILES%\VstPlugins and for VST3 it is %COMMONPROGRAMFILES%\VST3.
Where these paths are exactly located depends on the installation, run %COMMONPROGRAMFILES% or %PROGRAMFILES% directly to open them. (Win+R shortcut is your friend here)

Create the format-specific folders if they do not exist yet, and move the respective Cardinal bundles in there.
Make sure to move the complete bundles (e.g. CardinalFX.vst) and not their contents.
It is important to leave the bundle folders structure intact.

Note: The Windows builds are not signed, so Windows will say they are from an "untrusted developer".

Unofficial builds

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.

ArchLinux

Available in AUR as cardinal-git.

FreeBSD

Available as FreeBSD port, simply run pkg install cardinal to install it.

Clone this wiki locally