Setup
Gum Application (binaries):
Latest release direct link: files.flatredball.com/content/Tools/Gum/Gum.zip
Release history (including older releases): https://github.com/vchelaru/Gum/releases
Gum Source Code: https://www.github.com/vchelaru/Gum
Windows
Download and unzip the .zip file and run the Gum.exe file which is located in Data/Debug/.
Since Gum is a prebuilt file in a .zip, Windows blocks the file which results in the "Windows protected your PC" popup:

You can click More info, then Run anyway. Alternatively, you can right-click on the .zip file and select the option to unblock:

MacOS
Prerequisites
Before proceeding, ensure that you have the following prerequisites installed on your system:
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:
brew install --cask --no-quarantine wine-stable
brew install winetricks
Automated Setup MacOS
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
chmod +x ./setup_gum_mac.sh
Execute the script
./setup_gum.mac.sh
Linux
Prerequisites
You will need these following prerequisites installed on your system, you can run the automated install script to have them installed automatically or you can install them yourself manually if you run into issues (see Manual Setup Steps section):
WINE
Winetricks
Automated Setup Linux
These following commands will go through the steps of downloading and running the setup_gum_linux.sh
script. This script goes through the steps for you with minimal interaction required to setup your Linux environment to run the GUM tool using WINE. If you would prefer to do this setup manually, please refer to the Manual Setup Steps section below.
Download the setup_gum.linux.sh script https://raw.githubusercontent.com/vchelaru/Gum/master/setup_gum_linux.sh
Open a terminal and
cd
to the directory that the script was downloaded toMake the script executable
chmod +x ./setup_gum_linux.sh
Execute the script
./setup_gum_linux.sh
Install WINE and Winetricks Manually
If the auto script fails to install the prerequisites try this.
You can install WINE and Winetricks using your package manager. Open a terminal and run the following commands:
If your distro is not listed bellow please use your prefered search engine to find out how to install wine and winetricks properly on your system.
Ubuntu 22.04
sudo dpkg --add-architecture i386
sudo mkdir -pm755 /etc/apt/keyrings
wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key -
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources
sudo apt update && sudo apt install --install-recommends winehq-stable
sudo apt-get -y install winetricks
Ubuntu 24.04
sudo dpkg --add-architecture i386
sudo mkdir -pm755 /etc/apt/keyrings
wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key -
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/noble/winehq-noble.sources
sudo apt update && sudo apt install --install-recommends winehq-stable
sudo apt-get -y install winetricks
Fedora & Nobara (All Versions)
sudo dnf install wine
sudo dnf install winetricks
Linux Mint 20
sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https curl -y
sudo dpkg --add-architecture i386
curl -s https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/winehq.gpg > /dev/null
echo deb [signed-by=/usr/share/keyrings/winehq.gpg] http://dl.winehq.org/wine-builds/ubuntu/ focal main | sudo tee /etc/apt/sources.list.d/winehq.list
sudo apt-get install winetricks
Linux Mint 21
sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https curl -y
sudo dpkg --add-architecture i386
curl -s https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/winehq.gpg > /dev/null
echo deb [signed-by=/usr/share/keyrings/winehq.gpg] http://dl.winehq.org/wine-builds/ubuntu/ jammy main | sudo tee /etc/apt/sources.list.d/winehq.list
sudo apt-get install winetricks
Linux Mint 22
sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https curl -y
sudo dpkg --add-architecture i386
curl -s https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/winehq.gpg > /dev/null
echo deb [signed-by=/usr/share/keyrings/winehq.gpg] http://dl.winehq.org/wine-builds/ubuntu/ noble main | sudo tee /etc/apt/sources.list.d/winehq.list
sudo apt-get install winetricks
Manual Setup Steps
These following commands will go through the steps setting up your macOS or Linux environment to run the GUM tool using WINE.
Open a new terminal
Install .NET Framework 4.8 using
winetricks
with the following command:
winetricks dotnet48
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:
curl -O https://download.microsoft.com/download/A/C/2/AC2C903B-E6E8-42C2-9FD7-BEBAC362A930/xnafx40_redist.msi
After downloading the MSI file, install it using the following command:
wine msiexec /i xnafx40_redist.msi
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:
curl -o Gum.zip https://files.flatredball.com/content/Tools/Gum/Gum.zip
Unzip the downloaded Gum Tool ZIP file into the Program Files directory of the WINE folder. Run the following command in the terminal:
unzip Gum.zip -d ~/.wine/drive_c/Program\ Files/Gum
After unzipping the Gum Tool, remove the downloaded ZIP file using the following command:
rm -f Gum.zip
Create a script to run the Gum Tool. Run the following command in the terminal:
echo '#!/bin/bash
wine ~/.wine/drive_c/Program\\ Files/Gum/Data/Gum.exe' > ~/bin/Gum
Make the script executable by running:
chmod +x ~/bin/gum
To ensure you can run the Gum Tool from any directory, add the script directory to your PATH. Most Linux and macOS users using macOS 10.14 or lower, will be using the BASH shell. While for most macOS user using macOS 10.15 or higher, you'll be using the ZSH shell.
For Bash SHELL
if ! grep -q 'export PATH="\$HOME/bin:\$PATH"' ~/.bash_profile 2>/dev/null; then
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bash_profile
fi
For ZSH Shell
if ! grep -q 'export PATH="\$HOME/bin:\$PATH"' ~/.zshrc 2>/dev/null; then
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
fi
Reload the shell configuration to apply the changes. Run the following command:
For BASH Shell
source ~/.bash_profile
For ZSH Shell
source ~/.zshrc
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:
gum
If the command doesn't work immediately, try closing and reopening the terminal.
Last updated
Was this helpful?