godman

godman (formerly Godot Manager) is a .NET 10 console/TUI tool to install, manage, and activate Godot Engine builds (Standard and .NET) on Linux and Windows.

Features

• Install from official URLs (auto-built) or local archives; supports Linux and Windows, Standard or .NET editions.
• Scope-aware installs: user or global (requires administrator privileges for global scope).
• Each install is extracted into its own subfolder under the install root, based on downloaded archive name (with deterministic fallback when source URL has no archive filename).
• Registry of installs with activation; sets GODOT_HOME and writes shims (godot or godot.cmd).
• Interactive TUI (tui) and CLI commands (list, fetch, install, activate, deactivate, remove, doctor, clean).
• Dry-run mode to preview install/activate operations without making changes.
• Cleanup command to remove installs, shims, and config.

Prerequisites

Pre-built releases are self-contained — no runtime needed. Just download and run.

Building from source requires:

• .NET 10 SDK

Quickstart

Install via WinGet (Windows)

winget install --id JanMesarc.GodMan

Install on Linux (one-liner)

curl -fsSL https://raw.githubusercontent.com/jame581/GodotManager/main/install.sh | bash

Install on Linux (manual)

Download the latest .tar.gz from Releases and extract:

mkdir -p ~/.local/bin
tar -xzf godman-linux-x64-*.tar.gz -C ~/.local/bin
chmod +x ~/.local/bin/godman

Note: If ~/.local/bin is not in your PATH, add it:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

The one-liner installer above does this automatically.

Usage example

# 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 <id> --dry-run

# Run TUI
godman tui

# Doctor and cleanup
godman doctor
godman clean --yes

# Enable diagnostic warnings for troubleshooting
godman activate <id> --verbose
godman install --version 4.5.1 --edition Standard --platform linux --activate --verbose

Commands

• list — show registered installs, active marker.
• fetch — browse available Godot versions from GitHub; options: --stable, --filter <VERSION>, --limit <COUNT>, --no-cache.
• install — download (auto URL) or use --archive; options: --version, --edition, --platform, --scope, --path, --activate, --force, --dry-run.
• activate <id> — switch active install; options: --dry-run.
• deactivate — deactivate the current active install (clears GODOT_HOME, removes shims).
• remove <id> [--delete] [--dry-run] — unregister (optionally delete files); --dry-run previews without changes.
• doctor — check registry/env/shim.
• tui — interactive menu for the above.
• clean [--yes] — remove installs, shims, config.
• --version — show the current godman version.

Global options

All commands accept the following global options:

• --verbose / -V — enable diagnostic warnings for best-effort operations (shim cleanup, PATH updates, shortcut creation, cache I/O, etc.). By default these operations fail silently; with --verbose they print warn: messages to the console.

Paths

Linux

• Config: ~/.config/godman/
• User installs: ~/.local/bin/godman/
• Global installs: /usr/local/bin/godman/
• User shim: ~/.local/bin/godot
• Global shim: /usr/local/bin/godot

Windows

• Config: %APPDATA%\godman\
• User installs: %APPDATA%\godman\installs\
• Global installs: C:\Program Files\godman\installs\
• User shim: %APPDATA%\godman\bin\godot.cmd
• Global shim: C:\Program Files\godman\bin\godot.cmd

Building & Tests

# Build the project
dotnet build

# Run all tests
dotnet test -v minimal

# Run integration tests only
dotnet test --filter "FullyQualifiedName~InstallerServiceIntegrationTests"

# Run with detailed output
dotnet test -v detailed

Test Coverage:

• Unit tests for path resolution and configuration
• Integration tests for download/install flows with mocked HTTP
• Cross-platform validation (Windows/Linux)
• Isolated test environments with temporary directories

Notes

• Global installs require elevated privileges:
  • Linux: run with sudo
  • Windows: a UAC prompt will appear when global scope is selected
• Global activation also requires elevated privileges (because it updates system-wide environment variables/shims); on Windows, activate now shows a UAC prompt automatically.
• Global cleanup requires elevated privileges; on Windows, clean shows a UAC prompt automatically when global paths are being removed.
• Global scope sets system-wide environment variables and shims accessible to all users.
• The fetch command queries GitHub API to discover available Godot versions.
• Auto-URL construction for known Godot version patterns.
• Environment variable overrides available: GODMAN_HOME, GODMAN_GLOBAL_ROOT
• Windows environment variables: After activation, GODOT_HOME is set in the registry and current process. New terminal sessions will automatically load it; existing sessions can verify with doctor command.
• Windows PATH: The shim directory is automatically added to your PATH during activation. Restart your terminal after activation to use the godot command.
• Troubleshooting: If something seems off after install/activate, run the command again with --verbose (-V) to see diagnostic warnings for any best-effort operations that failed silently.

Author

• Jan Mesarč - Programmer - Portfolio
• Do you want support my work, my dreams? - Buy me a coffee
• Take a look on my other games - itch.io