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 stable — Set the global default to the latest stable.
gdvm pin stable --csharp — 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 3.5 --csharp — Run Godot 3.5 with C#.
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.

ℹ️

Hitting GitHub rate limits? Create a fine-grained token with access to public repositories, and run gdvm config set github.token (stored plaintext in ~/.gdvm/config.toml).

For more information, run gdvm --help.