Logging and inspecting errors

Witgui runs on top of the wit/wwt command line tools. Please note that these tools don’t support the NKit format. When an error occurs or something doesn’t behave as intended with the generated game files, it can be useful to inspect the output of these tools. If the output contains something like this:

!! wit: ERROR #126 [FATAL ERROR] in wd_read_part() @ src/libwbfs/wiidisc.c#865
!!      ASSERTION FAILED !!!

it’s likely to be an issue with the wit/wwt tools, so you should try to get help on the official support forum: https://gbatemp.net/threads/wwt-wit-wiimms-wbfs-iso-tools.182236

  1. Open the Terminal (in /Applications/Utilities).
  2. Assuming Witgui is in the /Applications folder, copy and paste “/Applications/Witgui.app/Contents/MacOS/Witgui -log” into the Terminal and press Enter.
  3. A new app instance will open. Reproduce the issue.
  4. A bunch of lines will appear inside the Terminal that contain some logs.
  5. After analyzing the Terminal output, you can quit Witgui and the Terminal.