Skip to main content
Version: 1.13 Beta

Manage Godot Projects

Use the Projects view in Godot Launcher to find and open projects or change how they are organised.

Godot Launcher Projects view in Cards mode with New, Pinned, and Recents groupsGodot Launcher Projects view in Cards mode with New, Pinned, and Recents groups

Choose a project view​

Use the three icons to the left of Search to choose a view:

  • List fits each project on one line, with its name, tags, tool icons, editor version and actions. Long names shorten with an ellipsis.
  • Compact shows two lines, including the project path and last opened time.
  • Cards, the default, shows project details with an Edit in Godot button.

All three views keep the same groups, order, search results, tags and actions. Godot Launcher remembers your choice after you close and reopen the app.

In List and Compact views, select the project icon or name to open it in Godot. In List view, hover or focus the name to see its full name, path and last opened time. Select the folder button, then Copy project path, to copy its location. Compact and Cards keep the copy control beside the path.

Godot Launcher List view with single-line projects and the three view iconsGodot Launcher List view with single-line projects and the three view icons Godot Launcher Compact view showing project paths beneath the namesGodot Launcher Compact view showing project paths beneath the names

Start with an empty Projects view​

You can start creating or adding projects before installing an editor. Select Create project to choose an editor and start a new project. Select From this computer to add a project already on your computer, or From GitHub to connect GitHub and import a repository. When Git is unavailable, From GitHub stays visible but disabled with an explanation; local import remains available.

Empty Projects view with choices to create a project or add an existing projectEmpty Projects view with choices to create a project or add an existing project

Find a project​

Projects appear in one of three groups:

  • New contains projects you have not opened from the launcher.
  • Pinned keeps chosen projects in the order you set.
  • Recents contains projects you opened recently.

The order is based on projects opened from this computer. Activity on another computer does not change it.

Enter part of a project name in Search to filter all three groups. Use Tags beside Search to match any selected tag, then narrow the results with text search. See Project Tags to add or manage tags.

Open or manage a project​

Each project provides its folder, selected tools, and status. In Cards view, use the card actions to:

  • Select Edit in Godot to launch the project with its selected Godot editor.
  • Use the pin button to move the project into or out of Pinned.
  • Select Open Terminal Here to open the project folder in your selected terminal.
  • Use the folder button to open either the project folder or its Godot editor settings folder.
  • Use the settings button to open Project Settings.
  • Use the more-actions button to import or export Godot editor settings, or remove the project from the launcher.

To remove a project, open its more-actions menu and select Remove Project From List. Confirm with Remove if prompted. The project disappears from the list; its project folder stays on disk.

For the meaning of tool and warning icons in each view, see Godot Launcher Project Status Icons.

Open Terminal Here​

Select Open Terminal Here in a project's actions in any project view to open that project's folder in a terminal. Before using it, enable Terminal and choose a detected terminal in Tool Settings.

If the action reports that Terminal is disabled, enable it in Tools. If no supported terminal is available, install one in its system location and select Rescan in the Terminal drawer. See Tool Settings for supported terminals and limitations.

Install a missing editor​

When a project needs an official editor that is not installed, its Godot version shows a warning and the project cannot be opened. Select the download icon labelled Install required editor to download that exact editor. The launcher repairs every listed project that is waiting for the same editor when the download finishes. Custom-built editors cannot be downloaded this way; register the build instead.

Project card offering to install its required Godot editorProject card offering to install its required Godot editor

In List and Compact views, the same warning appears beside the required Godot version. The download action remains available in the row so you can recover without changing views.

Reorder pinned projects​

Drag a pinned project's reorder handle to move it. The handle appears when you hover over the project and stays visible while dragging. The new order is saved on this computer.

You can also reorder with the keyboard:

  1. Focus the reorder button for a pinned project.
  2. Press Space or Enter to pick it up.
  3. Use the arrow keys to move it.
  4. Press Space or Enter to drop it, or Escape to cancel.
Pinning a project and changing its order with the keyboardPinning a project and changing its order with the keyboard

Clear search and tag filters before reordering pinned projects.