gevm

Godot Engine Version Manager (gevm) - README

Welcome to the repository for Godot Engine Version Manager! This tool is built using Go and InnoSetup. It allows for the downloading of Godot Engine from it's godot-builds repository via the terminal. We use it as part of our CI/CD pipeline for game development. It can also be used for personal use but we would recommend Godots for that case.

Table of Contents

• Installation
• Usage
• Uninstallation
• Contributing
• License

Installation

Windows

1. Download the latest installer from the latest release page here.
2. Run the installer.
3. Follow the on screen instructions.

Linux

You can use the very basic helper install script to download and install the binary:

curl -o- https://raw.githubusercontent.com/bashidogames/gevm/master/install.sh | bash

You will need to make sure ~/.local/bin is in your PATH environment variable:

export PATH="~/.local/bin:$PATH"

Mac

See installation for linux above.

Manual

Alternatively you can download the binary and use it manually:

1. Download the zip file for your system from the release page.
2. Extract the binary to a location of your choosing.
3. Add location to your PATH environment variable.

Usage

Below is some very basic usage for the more common commands. You can use gevm --help to get a full list of commands.

versions

Use the list command for listing available versions for your platform:

gevm versions list --mono --all

View versions for all platforms using the detailed command:

gevm versions detailed -m -a

godot

Install a version of godot using the install command:

gevm godot install 4.3 --release beta1 --mono

Uninstall a specific version and the export templates by using the uninstall command:

gevm godot uninstall 4.3 -r beta1 -m

You can use the path command to print the path to the specified version if installed. You can use this from external tools to get the godot path for running builds:

gevm godot path 4.3 -r beta1 -m

Use the list command to show all currently installed versions:

gevm godot list

Uninstall all versions and export templates by using the clear command:

gevm godot clear

settings

There are configuration settings you can change such where to put installed versions. Use the list command to list all the settings you can change and their current values:

gevm settings list

You can then change any of these settings by using the set command:

gevm settings set godot-root-directory <path>

Use the reset command to reset all settings to defaults:

gevm settings reset

cache

This tool uses a download cache to make reinstalling versions quicker. You may want to free up space by using the clear command:

gevm cache clear

Uninstallation

The uninstallation process will not remove any installed versions or cached downloads so you may want to that first to free up space:

gevm godot clear

gevm cache clear

Windows

1. Open Settings -> Apps -> Installed Apps or search for Add or remove programs in the start menu.
2. Look for Godot Engine Version Manager (gevm) and uninstall.
3. Follow the on screen instructions.

Linux

You can uninstall on Linux by just removing the binary:

rm ~/.local/bin/gevm

Mac

See uninstallation for linux above.

Contributing

See contributing for more details.

License

This project is licensed under the MIT License.