<h1>Meet godman, your Godot manager</h1>
godman is a small tool that helps you install and manage Godot Engine builds.
It is made with .NET 10 and it works on Windows and Linux.
The code is free and it uses the MIT license.
Repository: <a href="https://github.com/jame581/GodotManager" target="_blank" rel="noopener nofollow">https://github.com/jame581/GodotManager</a>
<h2>What problem it solves</h2>
Getting the right Godot version is usually easy.
But after a while you can end up with many zip files and many folders.
Then it is easy to forget where each version is.
I started digging into GDExtensions and I often needed more Godot versions for testing.
I like the terminal and I wanted a simple workflow.
Install a version, activate it, and run Godot with the command <code>godot</code>.
godman keeps a registry of your installs and lets you switch the active one any time.
It also sets GODOT_HOME and creates a shim so you can run Godot from the terminal.
<h2>What you can do with it</h2>
<ol>
<li>List what you have installed</li>
<li>Fetch available versions from GitHub</li>
<li>Install a version from official downloads or from a local archive</li>
<li>Activate one install and switch any time</li>
<li>Use a simple TUI if you prefer menus</li>
<li>Run doctor and clean to keep things tidy</li>
</ol>
<h2>Install on Windows</h2>
godman is available on WinGet.
Install command
<pre><code>winget install --id JanMesarc.GodMan
</code></pre>
After installation you can run godman from anywhere.
<h2>Install on Linux</h2>
godman is available on Linux too.
Download it from releases
<a href="https://github.com/jame581/GodotManager/releases" target="_blank" rel="noopener nofollow">https://github.com/jame581/GodotManager/releases</a>
Next step is to prepare a Copr release.
<h2>Usage example</h2>
<pre><code># List installs
godman list

# Browse available versions from GitHub
godman fetch --stable --limit 10

# Preview installation (dry-run)
godman install --version 4.5.1 --edition Standard --platform windows --scope User --dry-run

# Install latest 4.5.1 Windows Standard (auto URL) to user scope and activate
godman install --version 4.5.1 --edition Standard --platform windows --scope User --activate

# Install .NET edition for Windows from auto URL, global scope (UAC prompt)
godman install --version 4.5.1 --edition DotNet --platform windows --scope Global --activate

# Install on Linux global scope (requires sudo)
sudo godman install --version 4.5.1 --edition Standard --platform linux --scope Global --activate

# Preview activation (dry-run)
godman activate &lt;id&gt; --dry-run

# Run TUI
godman tui

# Doctor and cleanup
godman doctor
godman clean --yes
</code></pre>
<h2>Why I built it</h2>
I wanted a fast and predictable way to manage Godot versions for daily work.
This tool is also a nice way to keep projects consistent across machines.
If you try it, I would love feedback and ideas for improvements.
#godot #gamedev #opensource

Jan Mesarč

godman is an open-source CLI tool built with .NET 10 for installing and managing multiple Godot Engine versions on Windows and Linux. It maintains a registry of installed builds, lets you switch the active version at any time, sets GODOT_HOME, and creates a shim so you can invoke Godot from the terminal. Features include listing installs, fetching available versions from GitHub, installing from official downloads or local archives, a TUI mode, and doctor/clean utilities. Available via WinGet on Windows and as a binary release on Linux.

Meet godman your Godot manager