gdenv

The best command-line tool to install and switch between multiple versions of Godot.

Inspired by xcodes and built with ❤️ in Rust.

Installation

Quick Install (Recommended)

# Unix/Linux/macOS
curl -fsSL https://gdenv.bytemeadow.com | sh

# Windows PowerShell
irm https://gdenv.bytemeadow.com | iex

Cargo

# For the latest unstable version
cargo install --git https://github.com/bytemeadow/gdenv
# For the version released to crates.io
cargo install gdenv

Manual Download

Download pre-built binaries from GitHub Releases

Special thanks to Blaze for their support of this project. They provide high-performance Linux (AMD64 & ARM64) and Apple Silicon macOS runners for GitHub Actions, greatly reducing our automated build times.

Usage

Install a specific version of Godot using commands like:

gdenv install 4.4.1
gdenv install 4.5-beta1
gdenv install 3.6 --dotnet
gdenv install --latest
gdenv install --latest-prerelease

gdenv will download and install the version you asked for so that it's ready to use.

.godot-version

We recommend creating a .godot-version file to explicitly declare the Godot version for your project:

4.4.1

Then run:

gdenv install  # Installs 4.2.1
gdenv use      # Switches to 4.2.1

Commands

• install <version>: Download and install a specific version of Godot
• installed: List the versions of Godot that are installed
• list: List all versions of Godot that are available to install
• use <version>: Switch to a specific version of Godot
• current: Show the currently active version
• uninstall <version>: Uninstall a specific version of Godot
• update: Update the list of available versions of Godot
• cache: Manage download cache

License

gdenv is distributed under the terms of both the MIT license and the Apache License (Version 2.0). See LICENSE-APACHE and LICENSE-MIT for details. Opening a pull request is assumed to signal agreement with these licensing terms.