Skip to content

Launching from an ISO on Linux

tools/linux/gow_launcher.py prepares the files required by the runtime and starts a prebuilt native Linux ps2EntryRunner. The launcher does not compile anything or modify the ISO.

python3 tools/linux/gow_launcher.py \
  --iso "/path with spaces/God of War.iso" \
  --runner "/path/to/ps2EntryRunner"

If --iso is omitted, the launcher uses GOW_ISO, then the ISO saved from an earlier successful run, then scans ~/Games/Sony Playstation 2, ~/Games, ~/Downloads (and GOW_ISO_DIRS) for a valid image. Only one match is used without asking; several matches open a picker. If nothing resolves, the settings window opens (needs python3-tk), or a terminal prompt when no graphical display is available. See Launcher details. --last skips the window and launches the resolved ISO. If --runner is omitted, the launcher looks for bin/ps2EntryRunner in the repository; GOW_RUNNER can also specify its path. To validate and prepare the files without starting the game:

python3 tools/linux/gow_launcher.py --iso "/path/God of War.iso" --prepare-only

The supported edition is NTSC-U SCUS-97399, with SYSTEM.CNF booting cdrom0:\SCUS_973.99;1 and an ELF whose SHA-256 is ec9397d252f14d4412daffaad6be1f1931769e56222b5dbb9b39a947fc8ad71c. The image must use ISO 9660 with 2048-byte sectors and place SCUS_973.99 and its IRX modules in the root. At least SMPD_IOP.IRX, 989NOMID.IRX, and LIBSD.IRX are required. Other revisions and layouts produce an explicit error.

The ELF and all root IRX files are extracted to ${XDG_CACHE_HOME:-~/.cache}/gow-one-recomp/SCUS-97399/ under a private directory. The IRX modules are stored in IOP_MOD/ beside the ELF, as the runtime expects. The cache records a SHA-256 for each file and reextracts damaged files. A change to the ISO size, modification time, or file identity creates a new cache entry. The original ISO stays in place; the launcher passes its absolute path through GOW_ISO so the IOP can read sectors from it.

Run the synthetic tests without game files (no display needed):

python3 -m unittest discover -s tests -p test_gow_launcher.py