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'sbuild/) 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.txtonly if you changed formats with the switch on.
Notices you might seeLink to this section
| Notice | What to do |
|---|---|
| Couldn't tell which JUCE version | Pick the right one under Framework |
| A Projucer project | Add a CMakeLists.txt first (JUCE's CMake guide shows how), then import |
| A JUCE version Studio doesn't support | Studio uses the closest one it has; builds still use your project's own JUCE |
| Submodules are missing | Click Set Up Submodules, or follow the notice when Studio can't set them up itself |
| Doesn't build a CLAP plugin | It 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:
- Paste the Repository URL (HTTPS or SSH). For a private repository, git asks you to sign in.
- Check the Folder name and where to Clone into.
- 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.