Setup
Gum Application (binaries): files.flatredball.com/content/Tools/Gum/Gum.zip
Gum Source Code: https://www.github.com/vchelaru/Gum
Windows
Currently the Gum tool requires XNA runtimes. Download and install the runtime prior to running Gum:
Mac
Prerequisites
Before proceeding, ensure that you have the following prerequisites installed on your macOS:
Homebrew
WINE
Winetricks
Install Homebrew
Homebrew is a package manager for macOS. If you haven't installed Homebrew yet, you can install it by following the instructions on the official Homebrew website.
Install WINE and Winetricks
You can install WINE and Winetricks using Homebrew. Open a terminal and run the following commands:
Automated Setup
The following goes through the steps do download and run the setup_gum_mac.sh
automation script. This script goes through the steps for you with minimal interaction to setup your environment on macOS to run the GUM tool using WINE. If you would prefer to do this setup manually, please see the Manual Setup Steps section below.
Download the setup_gum.mac.sh script https://raw.githubusercontent.com/vchelaru/Gum/master/setup_gum_mac.sh
Open a terminal and
cd
to the directory that the script was downloaded toMake the script executable
Execute the script
Manual Setup Steps
The following goes through the steps setup your environment on macOS to run the GUM tool using WINE.
Open a new terminal
Install .NET Framework 4.8 using
winetricks
with the following command:
This command initiates the installation of .NET Framework 4.8. A total of two installer dialogs appear one after another. Follow the steps for both to complete the installation. This process may take a several minutes, so please be patient.
Download the XNA 4.0 Redistributable MSI file from Microsoft. You can download it using the following command:
After downloading the MSI file, install it using the following command:
Follow the installation prompts. At the end of the installation, it may display an error related to launching DirectX. This is normal; just click "Close" on the error dialog.
Download the Gum Tool ZIP file from the FlatRedBall website and save it to your preferred location. You can download it using the following command:
Unzip the downloaded Gum Tool ZIP file into the Program Files directory of the WINE folder. Run the following command in the terminal:
After unzipping the Gum Tool, remove the downloaded ZIP file using the following command:
Create a script to run the Gum Tool. Run the following command in the terminal:
Make the script executable by running:
To ensure you can run the Gum Tool from any directory, add the script directory to your PATH.
For Bash SHELL
For ZSH Shell
Reload the shell configuration to apply the changes. Run the following command:
For BASH Shell
For ZSH Shell
Running the Gum Tool
Congratulations! You have now successfully set up the Gum Tool on macOS using WINE. You can open the Gum Tool by simply typing the following command in the terminal:
If the command doesn't work immediately, try closing and reopening the terminal.
Last updated