gdvm | Godot Version Manager

To get started, run the following command in your terminal:

curl -sSL https://gdvm.io/install.sh | bash

powershell -NoProfile -Command "(iwr -useb 'https://gdvm.io/install.ps1.txt').Content | iex"

What is gdvm?

Godot Version Manager (gdvm) is a tool designed to simplify the installation, management, and switching between different versions of the Godot Engine.

Whether you're working on multiple projects or need to test features across various Godot versions, you'll never need to manually fuss with Godot installations again.

gdvm is a community-driven project, not affiliated with Godot Engine or the Godot Foundation.

Supported Platforms

Windows (64-bit, 32-bit, and 64-bit ARM)
macOS (64-bit Intel and Apple Silicon)
Linux (64-bit, 32-bit, and 64-bit ARM)

Getting Started

Once installed, you can use the gdvm command to manage your Godot installations. Here are some common commands:

gdvm use latest — Set the global default to the latest stable.
gdvm pin csharp:latest — Pin the current folder to latest stable with C#, using a .gdvmrc file.

Associate .godot files with ~/.gdvm/bin/godot.exe to auto-use the correct version. gdvm can also detect the required version from project.godot.

gdvm run — Run the default Godot for the folder.
godot — Alias for gdvm run.
godot_console — Windows variant keeping the console open.
gdvm run csharp:3.5 — Run Godot 3.5 with C#.
gdvm run "4.5-rc*" — Run the latest 4.5 release candidate.
gdvm remove 3.5 — Remove Godot 3.5 without C#.
gdvm list — List installed versions.
gdvm search 4 — Search available 4.x versions.
gdvm upgrade — Upgrade gdvm.
GDVM_GODOT_VERSION=4.4 godot — Use a specific version with scripts that expect godot to be in the PATH.

For more information, run gdvm --help.

For examples of using gdvm with debuggers, see the guide to using gdvm with debuggers.