Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion docs/getting-started/add-existing-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,16 @@ tags:

If you already have a Godot project, you can bring it into **Godot Launcher** instead of starting fresh.

Click **Add** in the `Projects` screen and select the folder containing your project’s `project.godot` file.
You can add projects in two ways:

![Projects View showing Add button](/img/screenshots/screen_projects_view_dark.webp)

- **Add button**: Click **Add** in the **Projects** screen and select the folder containing your project’s `project.godot` file.

![Projects View - Drop Overlay](/img/screenshots/screen_projects_drop_overlay_dark.webp)

- **Drag and drop**: Open the **Projects** screen and drag one or more `project.godot` files onto the window. Each project imports automatically, and a progress indicator shows how many remain when adding multiple items.

Once added, your project appears in the **Projects** section, ready to launch with the most compatible installed Godot Editor.

:::info
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/create-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ You can create a new project and start editing in seconds, or choose to add an e

## Add an Existing Project

Already have a Godot project? Click **Add**, pick the folder that contains `project.godot`, and the launcher will register it without moving any files. The project then appears in your **Projects** list, ready to launch with the best matching editor.
Already have a Godot project? Drag its `project.godot` file (or several at once) into the **Projects** screen, or click **Add** and pick the folder that contains `project.godot`. The launcher registers each project without moving any files and shows progress while importing multiple items. Every project then appears in your **Projects** list, ready to launch with the best matching editor.

For version-selection rules, Mono handling, and integration details, visit [Add an Existing Project](/getting-started/add-existing-project).

Expand Down
46 changes: 35 additions & 11 deletions docs/getting-started/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ On first launch, the launcher matches your operating system language automatical

> **System Requirements:** Windows 10 or later (64-bit)

> **Filename:** `Godot_Launcher-x.y.z-win.exe`
> **Filename:** `Godot_Launcher-x.y.z-win_x64.exe`

![Godot Launcher Setup UI - windows](../../static/img/win-installer-ui.webp)

Expand All @@ -55,36 +55,60 @@ If you did not choose to run Godot Launcher at the end of the installation, you

**System Requirements:** macOS 10.15 Catalina or later

**Filename:** `Godot_Launcher-x.y.z-mac.universal.dmg`
**Filename:** `Godot_Launcher-x.y.z-mac_universal.dmg`

![Godot Launcher Setup UI - macOS dmg](/img/dmg-installer-ui.webp)

For macOS Godot Launcher is distributed as a universal `.dmg`. Run the `.dmg` file and drag the `Godot Launcher` to the `Applications` folder when the dmg opens.

Once done, Godot Launcher can be opened from the Applications folder.


---

### Linux (AppImage)
### Linux

**System Requirements:** Modern 64-bit distribution (Ubuntu 20.04+, Fedora 36+, Arch-based, etc.)

**Available packages (1.8.0+):**
- AppImage (`Godot_Launcher-x.y.z-linux_x64.AppImage`)
- Debian/Ubuntu `.deb` (`Godot_Launcher-x.y.z-linux_x64.deb`)
- Fedora/RHEL `.rpm` (`Godot_Launcher-x.y.z-linux_x64.rpm`)

#### AppImage

:::info
AppImage builds include most dependencies — Make sure `FUSE` is available on your system.
AppImage builds include most dependencies — make sure `FUSE` is available on your system.
:::

> Filename: `Godot_Launcher-x.y.z-linux.x86_64.AppImage`
Make the `.AppImage` executable by using the GUI or by running:

```bash
chmod +x Godot_Launcher-x.y.z-linux_x64.AppImage
```

Then run it directly by double-clicking the file or executing:

For Linux, the Godot Launcher is distributed as an AppImage.
Make the `.AppImage` executable by using the GUI or by
running:
```bash
./Godot_Launcher-x.y.z-linux_x64.AppImage
```

#### Debian / Ubuntu (.deb)

Install the `.deb` from the download page:

```bash
chmod +x Godot_Launcher-x.y.z-linux.x86_64.AppImage
sudo apt install ./Godot_Launcher-x.y.z-linux_x64.deb
```

Then, you can run it directly by double-clicking the file or executing:
> If `apt` warns about missing dependencies, run `sudo apt --fix-broken install` to resolve them.

#### Fedora / RHEL (.rpm)

Install the `.rpm` from the download page:

```bash
./Godot_Launcher-x.y.z-linux.x86_64.AppImage
sudo dnf install ./Godot_Launcher-x.y.z-linux_x64.rpm
```

> On older RHEL-based distributions using `yum`, replace `dnf` with `yum`.
13 changes: 7 additions & 6 deletions docs/getting-started/launcher-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The **Godot Launcher** includes a configurable **Settings** section that lets yo

## Projects Tab

![Settings - Projects Tab](/img/launcher-settings-projects-ui.webp)
![Settings - Projects Tab](/img/screenshots/screen_settings_projects_dark.webp)

The **Projects** tab allows you to define the default location where new Godot projects are created.

Expand All @@ -34,7 +34,7 @@ Adding existing projects will not move them to this location

## Installs Tab

![Settings - Installs Tab](/img/launcher-settings-installs-ui.webp)
![Settings - Installs Tab](/img/screenshots/screen_settings_installs_dark.webp)

The **Installs** tab lets you choose where Godot editor versions are stored.

Expand All @@ -56,7 +56,7 @@ The button have a 1 minute cooldown to prevent your from hitting the GitHub API

## Appearance Tab

![Settings - Appearance Tab Showing the Language Picker](/img/godot-launcher-language-selector.webp)
![Settings - Appearance Tab Showing the Language Picker](/img/screenshots/screen_settings_appearance_dark.webp)

The **Appearance** tab lets you customize the look and feel of the launcher interface.

Expand Down Expand Up @@ -87,7 +87,7 @@ Found a string that needs polish or want to help add a new locale? Follow the [t

## Behavior Tab

![Settings - Behavior Tab](/img/launcher-settings-behavior-ui-win.webp)
![Settings - Behavior Tab](/img/screenshots/screen_settings_behavior_dark.webp)

The **Behavior** tab defines how the launcher behaves when launching projects or starting with your system.

Expand Down Expand Up @@ -116,7 +116,7 @@ The **Behavior** tab defines how the launcher behaves when launching projects or

## Tools Tab

![Settings - Tools Tab](/img/Godot_Launcher_1-6-0_Settings_tools_UI.webp)
![Settings - Tools Tab](/img/screenshots/screen_settings_tools_dark.webp)

The **Tools** tab manages integration with development tools like Git and Visual Studio Code.

Expand All @@ -141,11 +141,12 @@ The launcher uses this information to configure external editor support, also fo

## Updates Tab

![Settings - Updates Tab](/img/launcher-settings-updates-ui.webp)
![Settings - Updates Tab](/img/screenshots/screen_settings_updates_dark.webp)

The **Updates** tab controls how the launcher checks for updates.

- **Automatically check for updates**: Enabled by default.
- **Prerelease updates**: Toggle this if you want the launcher to download beta builds instead of only stable releases. Beta updates may change more often and can be less stable. You can switch back to stable at any time.
- **Manual Check**: Click **Check for updates** to check immediately.

:::tip
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/system-tray.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ When the Godot Launcher is running, it places an icon in your system tray. This

## Launcher Behavior Settings

> ![Launcher Settings - Behavior Tab](/img/launcher-settings-behavior-ui.webp)
> ![Launcher Settings - Behavior Tab](/img/screenshots/screen_settings_behavior_dark.webp)
> _Image: Behavior tab in settings affecting system tray options_

You can customize how the launcher interacts with the system tray under **Settings > Behavior**.
Expand Down
4 changes: 2 additions & 2 deletions docs/guides/using-git-with-godot-launcher.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ git version 2.39.5 (Apple Git-154)
### Create a New Godot Project With Git

When Git is detected the `New Project` UI shows an option to enable Git:
![Godot Launcher - New Project With Git UI](/img/launcher-new-project-ui.webp)
![Godot Launcher - New Project With Git UI](/img/screenshots/screen_projects_new_project_dark.webp)

:::info
You can see if Git is detected in `Settings` → `Tools`. [More info here](/getting-started/launcher-settings/#tools-tab)
Expand Down Expand Up @@ -88,7 +88,7 @@ Replace this placeholder with the finalized overflow menu capture when ready.
If Git is not installed, Godot Launcher still creates your project, but shows a warning. Git features are disabled, and no Git repository is initialized.

This is what the UI looks like when Git is missing:
![Godot Launcher - New Project No Git UI](/img/godot-launcher-new-project-no-git-ui.webp)
![Godot Launcher - New Project No Git UI](/img/screenshots/screen_projects_new_project_no_git_dark.webp)

:::info
To get the most out of version control in Godot, [install Git using this guide](/guides/install-git).
Expand Down
5 changes: 3 additions & 2 deletions docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,19 +12,20 @@ Welcome to the official Godot Launcher documentation.

**Godot Launcher** is a standalone app to streamline editor downloads, manage multiple versions, and automate new project setups — so you can focus on building great games.

![Godot Launcher - Create project UI](/img/launcher-new-project-ui.webp)
![Godot Launcher - Create project UI](/img/screenshots/screen_projects_new_project_dark.webp)

---

## Features at a Glance

- **Drag-and-Drop Project Import** – Drop one or many `project.godot` files into the Projects list to add them quickly with visible progress.
- **Git & VSCode Integration** – Instant Git setup and ready-to-use VSCode configurations.
- **Project Tool Toggles** – Enable Visual Studio Code integration or initialize Git from any project overflow menu.
- **Godot Version Management** – Easily install, switch, and prototype with multiple Godot versions.
- **Per-Project Settings** – Isolated editor configurations to avoid conflicts across projects.
- **System Tray Access** – Quickly open projects with a single click from the system tray.
- **Multilingual Interface** – Detects your OS language and lets you switch between 14 supported locales from settings.
- **Automatic Updates** – Stay up to date with one-click upgrades.
- **Update Control** – Stay up to date automatically or opt into prerelease builds from Settings when you want to test changes early.
- **Cross-Platform Support** – Windows ready, with Mac and Linux support coming soon.
- **Free & Open Source** – Forever free and community-driven.

Expand Down
12 changes: 6 additions & 6 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Empty file added static/img/screenshots/.gitkeep
Empty file.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.