Skip to content
DOCS

The Studio window

Find your way around Studio: the header, the activity bar, the projects list, each project's home page and the start page.

The layoutLink to this section

  • Header, across the top (see The header).
  • Activity bar, down the left: New Plugin (+) and Import Project, then the three views: Projects, Editor and Agent.
  • Sidebar: your projects.
  • The view you've chosen fills the rest.

Studio always opens on Projects.

The headerLink to this section

ControlWhat it does
TourTakes a guided tour (see Take the tour)
Start Preview / Stop PreviewLoads your built plugin into Studio so you can hear it (shown once a project is open)
ControlsOpens the Plugin Controls panel: audio sources, meters, validation and debugging tools (shown once a project is open)
LibraryGuides, DSP recipes and design assets, for you and the agent (see The Library)
Cloud Build & DistributeBuilds signed macOS and Windows versions in the cloud (needs a Freqlab account)
Share & ImportSaves a project as a zip to share or move, or imports one
AboutVersion, links and licenses
BellNotifications: finished cloud builds, marketplace news and more
GearSettings. A dot on it means an update is available (see Settings, Updates)

Library, Share & Import and Settings wait while a build is running.

The start pageLink to this section

With no project open, the start page offers New Plugin, Import Project, Clone from URL and Open Shared Zip, links to the Freqlab sites, and the project you opened last.

Your projectsLink to this section

The sidebar lists every project. Sort it with the sort button: Recently opened, Recently updated, Recently built, Name, Newest or Oldest.

Each card shows the date that matches the sort, and badges while something is happening: Working (the agent), Building, Switching (a version or branch change), or the number of messages waiting to send to the agent.

Hover a card for Open in Editor, Open Agent Chat, project settings and delete.

Missing projectsLink to this section

If an imported project's folder has moved, its card is struck through and marked Missing (or Can't read, if Studio can't read its settings file). For a missing project, click the relocate icon on the card and pick its new folder. Either kind can be removed from the list.

Deleting a projectLink to this section

  • A project Studio made: its folder moves to the Trash (Recycle Bin on Windows), where you can restore it. Its built plugins and agent chat logs are deleted.
  • An imported project is removed from Studio, with Studio's own files and its saved versions. Your source files stay where they are, unless you also check Also move the project folder to the Trash (Recycle Bin on Windows).

Before moving a folder to the Trash, Studio checks git and warns you about uncommitted or stashed changes, unpushed commits, or other worktrees that use the repository. For a project Studio made, it checks only in Git mode. For an imported project it also warns when its git history isn't on a remote, so the copy in the Trash would be the only one.

A project's home pageLink to this section

Click a project in the sidebar to open its home page:

  • The framework and interface, and the description (click it to edit, up to 280 characters).
  • Open in Editor to write the code yourself, and Open Agent Chat to have the agent write it (or Set Up an Agent if you haven't).
  • Version: the version you're on, how many files have changed since, and History.
  • Build: whether this version is built, its formats, and Open Build Folder.
  • Git (in Git mode): the branch, whether it's up to date with the remote, and what's waiting to be committed.
  • Cloud (when signed in): the latest cloud build and View.

The project menuLink to this section

The ⋮ button (More actions) at the end of the action bar, after Publish to DAW, has: Open Folder, Open in External Editor, Project Settings…, Agent & Model (once an agent is set up; marked Override when the project uses its own agent), Mark Version…, Version History… and Delete Project. It waits while a build runs.

ShortcutsLink to this section

New Plugin is ⌘N (Ctrl+N on Windows), Build is ⌘B (Ctrl+B) and the command palette is ⇧⌘P (Ctrl+Shift+P). See Keyboard shortcuts for the rest and to change them.