Using Pygafi CLI (no GUI)

Using Pygafi (no GUI)

---

Before Starting:

• Download Pygafi
• Download Python 3.9.0 or above
• If you are on Linux you need realpath and sha256sum (mostly preinstalled on every Linux Distro)

Note

You are using the version without the GUI, compared to the GUI version you need Python installed on your computer.

---

Generate output files

Get original output

First of all, you need a clean Super Mario Galaxy (2) file system using the unmodified version of the game. (The content extracted from your ISO must be on a known file path).

Copy diff_galaxy_og.bat/.sh into \DATA\files\ and run it. (It needs be the original file system)

Note

If you are on Linux, run the command chmod +x diff_galaxy_og.sh to make it executable.

The operation could take a while.

Important

If you see "An empty file was found: {file}. Ignored the file." don't panic. Some files in the original Super Mario Galaxy (2) File System are empty, it won't modify the result.

At the end, it should generate a file called output.ogfs containing the hash of each file (SHA-256) with a path linked to it.

The operation is complete! Move output.ogfs to pygafi root folder.

---

Get the modified output

After obtaining output.ogfs, it's time to generate another output file. You'll need the modified file system from your Super Mario Galaxy (2) Rom-Hack.

Copy diff_galaxy_modded.bat/.sh into \DATA\files\ and run it. (It needs be the modified file system)

Note

If you are on Linux, run the command chmod +x diff_galaxy_modded.sh to make it executable.

The operation could take a while.

Important

If you see "An empty file was found: {file}. Ignored the file." don't panic. Some files in the original Super Mario Galaxy (2) File System are empty, it won't modify the result.

At the end, it should generate a file called output.mgfs containing the hash of each file (SHA-256) with a path linked to it.

The operation is complete! Move output.mgfs to pygafi root folder.

---

Analyze output file differences

Go to the pygafi root folder, make sure there are output.ogfs and output.mgfs

Note

Compared to the GUI version, you can't use a legacy output file with this method, if you want to use a legacy file, you will need to rename output1.txt to output1.ogfs and output2.txt to output2.ogfs. (If you don't know what is output1.txt or output2.txt just ignore this note.)

Run differed_galaxy.py (If you see any errors at this step, please report it in the issues tab)

It will generate differed.txt containing all the hash differences between the two outputs.

Do not rename or move differed.txt until you finished using Pygafi.

---

Extract modified data

Finally, make sure the modified file system is still connected to the device and run generate.py/generate_linux.py.

(If you see any errors at this step, please report it in the issues tab)

A folder called GENERATED will contain all the data extracted from the modified file system.

---