Frequently Asked Questions (FAQs)
General Questions
What is Godot Launcher?
Godot Launcher is a free, open source companion app for Godot Engine. It helps manage Godot versions, custom Godot builds, projects, code editors, Git, and per-project editor settings.
Is Godot Launcher affiliated with Godot Engine or the Godot Foundation?
No. Godot Launcher is an independent community project and is not affiliated with, endorsed by, or sponsored by the Godot Engine project or the Godot Foundation.
Is Godot Launcher free?
Yes. Godot Launcher is free and open source under the MIT license. You can use, modify, and contribute to it under that license.
How is Godot Launcher different from downloading Godot manually?
Manual downloads give you the editor files. Godot Launcher keeps your Godot versions, custom builds, project tools, and per-project settings organized in one place.
It can also configure Visual Studio Code or VSCodium and initialize Git.
Does it work offline?
Yes. You can open local projects with installed Godot versions while offline. You need an internet connection to download editors, refresh the release list, or update Godot Launcher.
Which platforms does it support?
Godot Launcher supports Windows 10 or later on x64 and ARM64, macOS 12 Monterey or later on Intel and Apple silicon, and modern Linux distributions on x64 and ARM64.
Can I use Godot 3 with the launcher?
Godot Launcher currently supports Godot 4 and newer. Support for Godot 3 is not included. If you need Godot 3 support, you can discuss that use case in the #launcher-discussions channel on the Godot Launcher Discord server.
Where can I review the source code?
The Godot Launcher source code is available on GitHub. The website, documentation, and main app are maintained as open source project repositories.
Features & Functionality
Can I use custom Godot builds with Godot Launcher?
Yes. Register custom Godot builds and select them for projects like official releases.
How do I add a custom Godot build?
Use the Custom Editor workflow from the Installs view. The custom Godot builds guide covers registering an existing manifest and creating a new custom editor manifest.
Can I manage multiple Godot versions with the launcher?
Yes. Godot Launcher can download and manage multiple Godot versions, and each project can be assigned a compatible editor.
Which code editors does Godot Launcher support?
Godot Launcher supports Visual Studio Code, VSCodium on Windows, macOS, and Linux. It can find either editor and configure Godot to open scripts in it.
Code Editor Settings lets you set a default for new projects. You can also choose a different editor for a project when needed.
Can Godot Launcher initialize Git?
Yes. Godot Launcher can handle Git setup for new Godot projects, including Godot ignore rules, a main branch, and an initial commit. If Git needs your name and email, add them or skip the first commit.
For existing projects, Project Settings initializes Git without adding setup files or creating a commit. See Using Git With Godot Launcher for both workflows.
Does each project keep separate Godot editor settings?
Yes. Each project keeps its own Godot editor settings, so changes in one project do not affect another.
Can I use Godot Launcher with existing projects?
Yes. You can add an existing Godot project and choose which editor should be used for it.
Can I import or export project editor settings?
Yes. The editor settings guide covers importing, exporting, and where project editor settings are stored.
Will the launcher update itself automatically?
Godot Launcher can check for updates automatically, but it does not download them automatically. When an update is available, you choose when to download and restart. Some platforms or package types require a manual update.
Installation & Setup
How do I install Godot Launcher?
Download the latest release from the Godot Launcher download page or from the GitHub releases. The installation guide covers platform-specific setup steps.
Can I install Godot Launcher via winget?
Yes. On Windows you can run these commands from PowerShell or Command Prompt:
How do I know I am downloading an official Godot Launcher build?
Use the Godot Launcher download page or the GitHub releases page to get builds published by the Godot Launcher project.
Windows builds are signed through SignPath. Free code signing provided by SignPath.io, certificate by SignPath Foundation. macOS builds are signed with a Developer ID Application certificate issued to Mario DEBONO and notarized by Apple. Signing for Linux .deb and .rpm packages is planned.
Do I need to install Godot separately?
No. Godot Launcher can download and manage Godot versions for you. You can also register custom Godot builds when needed.
Troubleshooting & Support
I found a bug or need help. Where can I report it?
You can report bugs or feature requests on our GitHub Issues page. Before submitting a new issue, check if it has already been reported.
Can I contribute to the project?
Yes. Contributions are welcome. Start with the CONTRIBUTING.md file and the contributing documentation before opening a pull request.