Skip to content
This repository was archived by the owner on Jun 19, 2026. It is now read-only.

Using Pygafi GUI

LariVille edited this page Apr 23, 2024 · 1 revision

Using Pygafi GUI

GUI Screenshot


Before Starting:

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

Note

The GUI version doesn’t require Python installed because it’s already compiled with Python libraries.


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! (for file organisation, you can move output.ogfs into a known 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! (for file organisation, you can move output.mgfs into a known folder.)


Analyze output file differences

Launch Pygafi GUI

Note

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

Click on the first browse button and locate output.ogfs (or choose output1.txt if you are using a legacy output file).

The path of the file will appear next to it.

Warning

For now, you can't choose the output file by putting the path in the textbox, you need to locate it via the button.

Click on the second browse button and locate output.mgfs (or choose output2.txt if you are using a legacy output file)..

Then click on Differ. (If you see any errors at this step, please report it in the issues tab)

It will generate a file called differed.txt

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 click on the Generate button corresponding to your Operating system.

(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.


Available Pages:

Usage Guide
Info Pages
Other Pages

Tip

Latest Version: v0.4-beta


Clone this wiki locally