diff --git a/docs/getting-started/add-existing-project.md b/docs/getting-started/add-existing-project.md index 470ba44..dab247d 100644 --- a/docs/getting-started/add-existing-project.md +++ b/docs/getting-started/add-existing-project.md @@ -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 diff --git a/docs/getting-started/create-project.md b/docs/getting-started/create-project.md index 4d884d3..bd55a66 100644 --- a/docs/getting-started/create-project.md +++ b/docs/getting-started/create-project.md @@ -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). diff --git a/docs/getting-started/installation.mdx b/docs/getting-started/installation.mdx index a9de9ae..af4f6c6 100644 --- a/docs/getting-started/installation.mdx +++ b/docs/getting-started/installation.mdx @@ -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) @@ -55,7 +55,7 @@ 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) @@ -63,28 +63,52 @@ For macOS Godot Launcher is distributed as a universal `.dmg`. Run the `.dmg` fi 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`. diff --git a/docs/getting-started/launcher-settings.md b/docs/getting-started/launcher-settings.md index b193e9d..15ef136 100644 --- a/docs/getting-started/launcher-settings.md +++ b/docs/getting-started/launcher-settings.md @@ -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. @@ -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. @@ -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. @@ -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. @@ -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. @@ -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 diff --git a/docs/guides/system-tray.md b/docs/guides/system-tray.md index 76f59d6..f83ae18 100644 --- a/docs/guides/system-tray.md +++ b/docs/guides/system-tray.md @@ -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**. diff --git a/docs/guides/using-git-with-godot-launcher.md b/docs/guides/using-git-with-godot-launcher.md index dc79ccc..98f6230 100644 --- a/docs/guides/using-git-with-godot-launcher.md +++ b/docs/guides/using-git-with-godot-launcher.md @@ -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) @@ -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). diff --git a/docs/overview.md b/docs/overview.md index 2d29c7e..47de339 100644 --- a/docs/overview.md +++ b/docs/overview.md @@ -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. diff --git a/package-lock.json b/package-lock.json index 6ff01c1..6851ee8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8704,9 +8704,9 @@ } }, "node_modules/gray-matter/node_modules/js-yaml": { - "version": "3.14.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", - "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "version": "3.14.2", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz", + "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==", "license": "MIT", "dependencies": { "argparse": "^1.0.7", @@ -9848,9 +9848,9 @@ "license": "MIT" }, "node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", "license": "MIT", "dependencies": { "argparse": "^2.0.1" diff --git a/static/img/screenshots/.gitkeep b/static/img/screenshots/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/static/img/screenshots/screen_help_view_dark.webp b/static/img/screenshots/screen_help_view_dark.webp new file mode 100644 index 0000000..a4a6a41 Binary files /dev/null and b/static/img/screenshots/screen_help_view_dark.webp differ diff --git a/static/img/screenshots/screen_help_view_light.webp b/static/img/screenshots/screen_help_view_light.webp new file mode 100644 index 0000000..793028c Binary files /dev/null and b/static/img/screenshots/screen_help_view_light.webp differ diff --git a/static/img/screenshots/screen_installs_new_version_dark.webp b/static/img/screenshots/screen_installs_new_version_dark.webp new file mode 100644 index 0000000..68b9d24 Binary files /dev/null and b/static/img/screenshots/screen_installs_new_version_dark.webp differ diff --git a/static/img/screenshots/screen_installs_new_version_light.webp b/static/img/screenshots/screen_installs_new_version_light.webp new file mode 100644 index 0000000..5ac7450 Binary files /dev/null and b/static/img/screenshots/screen_installs_new_version_light.webp differ diff --git a/static/img/screenshots/screen_installs_view_dark.webp b/static/img/screenshots/screen_installs_view_dark.webp new file mode 100644 index 0000000..52cfc44 Binary files /dev/null and b/static/img/screenshots/screen_installs_view_dark.webp differ diff --git a/static/img/screenshots/screen_installs_view_light.webp b/static/img/screenshots/screen_installs_view_light.webp new file mode 100644 index 0000000..ff6a484 Binary files /dev/null and b/static/img/screenshots/screen_installs_view_light.webp differ diff --git a/static/img/screenshots/screen_projects_drop_overlay_dark.webp b/static/img/screenshots/screen_projects_drop_overlay_dark.webp new file mode 100644 index 0000000..4983ce2 Binary files /dev/null and b/static/img/screenshots/screen_projects_drop_overlay_dark.webp differ diff --git a/static/img/screenshots/screen_projects_drop_overlay_light.webp b/static/img/screenshots/screen_projects_drop_overlay_light.webp new file mode 100644 index 0000000..0af0344 Binary files /dev/null and b/static/img/screenshots/screen_projects_drop_overlay_light.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_dark.webp b/static/img/screenshots/screen_projects_new_project_dark.webp new file mode 100644 index 0000000..efdbc83 Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_dark.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_light.webp b/static/img/screenshots/screen_projects_new_project_light.webp new file mode 100644 index 0000000..21e6dee Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_light.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_git_dark.webp b/static/img/screenshots/screen_projects_new_project_no_git_dark.webp new file mode 100644 index 0000000..cbcae05 Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_git_dark.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_git_light.webp b/static/img/screenshots/screen_projects_new_project_no_git_light.webp new file mode 100644 index 0000000..a540127 Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_git_light.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_tools_dark.webp b/static/img/screenshots/screen_projects_new_project_no_tools_dark.webp new file mode 100644 index 0000000..b9911c2 Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_tools_dark.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_tools_light.webp b/static/img/screenshots/screen_projects_new_project_no_tools_light.webp new file mode 100644 index 0000000..57fe6dc Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_tools_light.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_vscode_dark.webp b/static/img/screenshots/screen_projects_new_project_no_vscode_dark.webp new file mode 100644 index 0000000..bd9b073 Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_vscode_dark.webp differ diff --git a/static/img/screenshots/screen_projects_new_project_no_vscode_light.webp b/static/img/screenshots/screen_projects_new_project_no_vscode_light.webp new file mode 100644 index 0000000..46714ad Binary files /dev/null and b/static/img/screenshots/screen_projects_new_project_no_vscode_light.webp differ diff --git a/static/img/screenshots/screen_projects_view_dark.webp b/static/img/screenshots/screen_projects_view_dark.webp new file mode 100644 index 0000000..b2740bb Binary files /dev/null and b/static/img/screenshots/screen_projects_view_dark.webp differ diff --git a/static/img/screenshots/screen_projects_view_light.webp b/static/img/screenshots/screen_projects_view_light.webp new file mode 100644 index 0000000..358ca02 Binary files /dev/null and b/static/img/screenshots/screen_projects_view_light.webp differ diff --git a/static/img/screenshots/screen_settings_appearance_dark.webp b/static/img/screenshots/screen_settings_appearance_dark.webp new file mode 100644 index 0000000..32728dd Binary files /dev/null and b/static/img/screenshots/screen_settings_appearance_dark.webp differ diff --git a/static/img/screenshots/screen_settings_appearance_light.webp b/static/img/screenshots/screen_settings_appearance_light.webp new file mode 100644 index 0000000..2b5552c Binary files /dev/null and b/static/img/screenshots/screen_settings_appearance_light.webp differ diff --git a/static/img/screenshots/screen_settings_behavior_dark.webp b/static/img/screenshots/screen_settings_behavior_dark.webp new file mode 100644 index 0000000..a23ad2d Binary files /dev/null and b/static/img/screenshots/screen_settings_behavior_dark.webp differ diff --git a/static/img/screenshots/screen_settings_behavior_light.webp b/static/img/screenshots/screen_settings_behavior_light.webp new file mode 100644 index 0000000..f2c9330 Binary files /dev/null and b/static/img/screenshots/screen_settings_behavior_light.webp differ diff --git a/static/img/screenshots/screen_settings_installs_dark.webp b/static/img/screenshots/screen_settings_installs_dark.webp new file mode 100644 index 0000000..d32abfd Binary files /dev/null and b/static/img/screenshots/screen_settings_installs_dark.webp differ diff --git a/static/img/screenshots/screen_settings_installs_light.webp b/static/img/screenshots/screen_settings_installs_light.webp new file mode 100644 index 0000000..4df6a74 Binary files /dev/null and b/static/img/screenshots/screen_settings_installs_light.webp differ diff --git a/static/img/screenshots/screen_settings_projects_dark.webp b/static/img/screenshots/screen_settings_projects_dark.webp new file mode 100644 index 0000000..07ff39c Binary files /dev/null and b/static/img/screenshots/screen_settings_projects_dark.webp differ diff --git a/static/img/screenshots/screen_settings_projects_light.webp b/static/img/screenshots/screen_settings_projects_light.webp new file mode 100644 index 0000000..ee10876 Binary files /dev/null and b/static/img/screenshots/screen_settings_projects_light.webp differ diff --git a/static/img/screenshots/screen_settings_tools_dark.webp b/static/img/screenshots/screen_settings_tools_dark.webp new file mode 100644 index 0000000..25d483e Binary files /dev/null and b/static/img/screenshots/screen_settings_tools_dark.webp differ diff --git a/static/img/screenshots/screen_settings_tools_light.webp b/static/img/screenshots/screen_settings_tools_light.webp new file mode 100644 index 0000000..3faec35 Binary files /dev/null and b/static/img/screenshots/screen_settings_tools_light.webp differ diff --git a/static/img/screenshots/screen_settings_updates_dark.webp b/static/img/screenshots/screen_settings_updates_dark.webp new file mode 100644 index 0000000..56f8a24 Binary files /dev/null and b/static/img/screenshots/screen_settings_updates_dark.webp differ diff --git a/static/img/screenshots/screen_settings_updates_light.webp b/static/img/screenshots/screen_settings_updates_light.webp new file mode 100644 index 0000000..da0dd6f Binary files /dev/null and b/static/img/screenshots/screen_settings_updates_light.webp differ