Important Announcement
Because of continuous breaking changes in mac and its support for wine, as well as not being able to find developers to help with mac code, the Mac is no longer officially supported by audiogame-manager. The following instructions are left in place for those who want to try, but if you run into problems, audiogame-manager developers will most likely not be able to help.
There is a commit that can be checked out that will contain code that should work for most things on the Mac. Note that following the git checkout instruction later in this document means that you will not get any games added after that point.
Introduction
This guide will show you how to install audio game manager and get some games running on the mac.
Disclaimer
This set of instructions may not work for everyone. This has been tested on Catalina and Big Sur. Not all games will work. After the Catalina update, most of the 32-bit support has been removed. This uses wine-crossover, which has 32-bit support but is bigger, and has issues with 64-bit wine prefixes, as far as I know. The only 64-bit game is sequence storm. The automation we use with xdotool is not supported on mac, some installers will require manual intervention.
M1 Mac
The M1 installs ARM versions of everything by default. To install the x86_64 version of homebrew, run the following:
arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
In the rest of the instructions, replace lines that start with brew with:
arch -x86_64 /usr/local/bin/brew
The ARM version of home brew and the x86 version are in two separate locations, so it is ok to have both installed.
Installation
Install Xcode from the mac AppStore. Search for Xcode and install. Beware that Xcode is over 1gb in size and may take a while on some connections.
Open terminal from the utilities folder, and run the following command to install the command line developer tools.
xcode-select --install
And follow the prompts.
a Note About Gatekeeper
Gatekeeper must be disabled for audiogame-manager to work correctly. Run the following command to disable gatekeeper.
sudo spctl --master-disable
Install homebrew, which is a package manager for the mac that allows you to install unix apps. Learn more Here To install homebrew, run the following command in the terminal.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Follow the prompts to complete the installation.
Run the following command to install the essential packages.
brew install bash cliclick coreutils gawk dialog sox unix2dos grep w3m
Run the following commands to install wine and winetricks. First add the tap:
brew tap gcenx/wine
Then install Wine:
brew install cask --no-quarantine wine-crossover
Then install winetricks:
brew install winetricks
Getting audiogame-manager
You can download the source of audiogame-manager by cloning the git repo
git clone https://git.stormux.org/storm/audiogame-manager.git
Usage
In the terminal, switch to the folder in wich you have cloned the repo (Usually Downloads) if you have cloned it into another folder cd to it `cd ~/Downloads/audiogame-manager
Both the master and testing branches of the project will most likely contain code that is not compatible with the Mac. So to get the latest version that works most completely, checkout the last version that is most compatible with the Mac. Usage of the testing or master branches may cause problems with some games that may have worked previously.
git checkout fbba315e1b224df002e177b445e9ada8f7a33649
Now make it executable, you'll only have to do this once.
`chmod +x audiogame-manager.sh
Help
View help by running:
./audiogame-manager.sh -h
Voiceover Tip:
Voiceover will not always read well in dialogs in the terminal. To get around this, when going up or down, and you hear the letter announced, up and down or down and up respectively should then correctly read what is highlighted.
Installing a game
You can install a new game by running:
./audiogame-manager.mac -i
Select the game and press enter.
Launching A Game
Run audiogame-manager without any flags to launch a game.
./audiogame-manager.mac
64 Bit Games
64 bit games will most likely not work. For the other games, try and see. Remember that games that require the Linux utility xdotool will require manual intervention to install on the Mac.