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

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.

Setting the file sort order

By default, files are sorted clockwise by decreasing file size. From the View menu, you can set a different sort order.

File Size

The default. You can quickly find files that take away most of your disk space.

Allocated File Size

When opening an ordinary directory, this setting will produce a similar display as for the File Size sort order (since usually there is only a small difference between the file size and the allocated file size). When scanning a directory managed by a cloud service such as Google Drive, Dropbox or OneDrive, this setting will effectively hide all those files that are not currently on the selected drive but are downloaded on demand (since their allocated file size is 0 Bytes).

Child count

Directories are sorted by the number of subfiles, followed by all the regular files sorted in alphabetical order. Having a lot of (small) files may slow down some operations: for example, copying a directory containing many files is often slower than copying a directory with less files but the same overall size. With this sort mode you can quickly find such slow directories which you may want to exclude from a periodic copy operation or backup.

Granting access to protected files

By default, Disk Graph can only show files that are not protected by the operating system, which will result in the graph showing more free space than expected when scanning directories such as /Library or /System. Starting from macOS 10.14, you can grant access to these protected system files.

  1. Go to System Settings > Security > Privacy.
  2. Click on the lock at the bottom left of the window and enter your system password.
  3. Click on the plus button and select the application.
  4. Click on the lock again. You can now close the window.

Backup strategy

You can choose whether files that are overwritten or removed from the destination should be moved to the trash or a custom folder.

A custom backup folder must be on the same device as the destination. If the backup folder is inside the destination (or the source for two-way syncs), it will be automatically excluded.

When moved to the backup folder, the current timestamp is appended to each filename. The timestamp has the format yyyy-MM-dd[T]HH-mm-ss+ZZZZ, which is independent of the current system locale and takes into account the timezone as well. This timestamp will be used in order to determine which backup files lie outside of the selected timeframe and are to be removed.

Follow hard and symbolic links and Finder aliases

While following hard links is supported, symbolic links and Finder aliases are not. This is a standard behaviour for sandboxed apps from the Mac App Store and cannot be circumvented.

If you want to copy files pointed to by a symbolic link or a Finder alias, you can create separate sync items taking care of these files.