Skip to content
DOCS

Import or clone a project

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

Import a project folderLink to this section

Click Import Project (the arrow under +), or press ⌘O (Ctrl+O on Windows), then Browse… to your project's folder.

Your project stays where it is. Studio adds its own .freqlab folder inside it for chats, versions and build settings.

Studio detects the framework and fills in the form. Check it, then click Import Project:

  • Framework: NIH-plug, JUCE (with its version), iPlug2, or Custom Cargo (Rust) / Custom CMake for any other project.
  • Plugin UI: detected from the files. If you're not sure, leave it on Not sure.
  • Display name, Plugin type and an optional Description.
  • Build formats. For a CMake project, Update CMakeLists.txt when build formats change lets Studio edit the formats line for you; otherwise your CMakeLists.txt decides.
  • Git mode (what it is): shows changes since your last commit and adds the Git tab. It's on for a repository that already has commits.

What Studio changesLink to this section

  • Keeps Studio's own files (.freqlab/, .claude/, a CMake project's build/) out of git through .git/info/exclude. It never edits your .gitignore.
  • If the folder isn't a git repository, runs git init (without making a commit).
  • Edits CMakeLists.txt only if you changed formats with the switch on.

Notices you might seeLink to this section

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 Studio doesn't supportStudio uses the closest one it has; builds still use your project's own JUCE
Submodules are missingClick Set Up Submodules, or follow the notice when Studio can't set them up itself
Doesn't build a CLAP pluginIt builds for your DAW, but Studio's preview needs CLAP. The notice says how to add it for your framework

A project can't be imported twice, under a name another project already uses, or from a folder named like another project (rename the folder first).

Clone from a Git URLLink to this section

From the start page, or 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. The Import window then picks the new folder: check the form and click Import Project.

Click Sign in with GitHub to pick from your repos to choose from your own and your organizations' repositories instead. Only clone code you trust: building a project runs its code.