Skip to content
DOCS

Import or clone a project

Bring an existing plugin project into Express where it is, or clone one from a Git URL or your GitHub repositories.

Import a folderLink to this section

Click Import Folder, then Browse… to your project. It stays where it is: nothing is copied or moved.

Express detects the framework (NIH-plug, JUCE and its version, iPlug2, or any other Cargo or CMake project) and whether it's an instrument. Check the form, then click Import Project.

For a CMake project, CMake builds the formats your CMakeLists.txt lists. If Express can find that list, Update CMakeLists.txt when build formats change is on, so changing formats in Express edits that line. Turn it off to leave the file alone; Express then keeps only the formats you check.

NoticeWhat to do
Couldn't tell which JUCE versionPick the right one under Framework
A Projucer projectAdd a CMakeLists.txt first (JUCE's CMake guide shows how), then import
A JUCE version Express doesn't supportExpress uses the closest one it has; builds still use your project's own JUCE
Submodules are missingClick Set Up Submodules
A Cargo workspace with no package of its ownImport the plugin's own folder, or set a build command

A project can't be imported twice, or with a name or folder name another project already uses.

Clone from a Git URLLink to this section

Click Clone from URL… in the Import window:

  1. Paste the Repository URL (HTTPS or SSH). For a private repository, git asks you to sign in.
  2. Check the Folder name and where to Clone into.
  3. Click Clone. Express fills in the Import form for you; if you leave without importing, it asks whether to Keep It or Remove It.

Sign in with GitHub in the Clone window to pick from your own and your organizations' repositories. Only clone code you trust: building a project runs its code.