Logging and inspecting errors

Witgui runs on top of the wit/wwt command line tools. 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. 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.