Config

By default PYZDL_ROOT is ~/.config/pyzdl. This can be overriden by setting the $PYZDL_ROOT environment variable.
The default config file is found at $PYZDL_ROOT/config.json.

Profile Saves

By default, profile saves are enabled. When enabled, a savedir root will be created at $PYZDL_ROOT/saves.
When running a profile $PROFILE, if no -savedir argument is configured, it will launch with -savedir $PYZDL_ROOT/saves/$PROFILE.
This ensures profiles don't overwrite each other's saves when using the same IWADs.

Downloading Windows-only GZDoom Games From Steam

Several great GZDoom games and mods are available on Steam, and while most work great with the macOS GZDoom build it takes some work to get the files.

If you don't already have steamcmd installed:

brew install --cask steamcmd

For this example, we'll download Hedon.

For convenience we'll download to /home/doomguy/wads/hedon, but substitute a viable path as need. Likewise, replace doomguy with your Steam user.

steamcmd +force_install_dir /home/doomguy/wads/hedon +@sSteamCmdForcePlatformType windows +login doomguy +app_update 1072150

It's important +force_install_dir goes first, for reasons.

This one is simple because it's only one IWAD, Hedon.ipk3. Given an already configured GZDoom source port, one needs only add the IWAD then a profile pointing to the IWAD and port combination.

To do so via CLI:

# Add IWAD
python cli.py iwads add Hedon /home/doomguy/wads/hedon/Hedon.ipk3
# Add profile
python cli.py profiles add Hedon GZDoom Hedon
# Play Hedon!
python cli.py run profile Hedon

Other games come with additional *.wad, *.iwad, *.pk3, or *.ipk3 files. Add these in the profile editor or by editing the config JSON directly. Sometimes there's a bundled gzdoom.ini (or similarly named file).
To add this to a profile, specify -config /path/to/gzdoom.ini in the editor args box or by adding to to the "args" key in the profile JSON.

Other mods from ModDB use DOOM.WAD or DOOM2.WAD as an IWAD base. Get a copy of from GOG or Steam.

pyZDL