Skip to content

For Unix Systems

matyalatte edited this page Apr 28, 2024 · 16 revisions

You can use the tool on macOS and Linux.

0. Supported Platforms

  • macOS 10.15 or later.
  • Linux with GLIBC 2.27 and GLIBCXX 3.4.26 (or later versions of the libraries.)

1. Download the Windows version.

Download UE4-DDS-Tools-*-GUI.zip from the release page.

2. Remove unnecessary files

Unzip UE4-DDS-Tools-*-GUI.zip.
Then, remove ./python and ./GUI.exe.

3. Download Tuw

Download Tuw-v0.6.4-*.tar.bz2 from here.
Then, copy the executable (Tuw) to the tool's directory.
It's a Unix build for GUI.exe.

4. Allow executing file as program (for Ubuntu)

If you are using Ubuntu, you should check Allow executing file as program. (Properties->Permissions->Execute)
CloudNotDisplay

5. Download DDS converter (Texconv)

Download blender_dds_addon_v0.4.0_*.zip from here.
Then, copy the shared library (blender_dds_addon/directx/libtexconv.*) to ./src/directx.
It's a Unix build for the DDS converter.

6. Install Python3.10 or later

Unix versions will use python3 to run python scripts.
Install it if you don't have.

Your machine might use an old version of python even if you installed python3.10.
If so, you should replace all python3 with python3.10 in gui_definition.json.

8. Done!

Run Tuw.
It'll show the same GUI as the Windows version.

If you get a macOS cannot verify that this app is free from malware warning, you should allow Mac to open the file.
You can find tons of websites that explain how to fix it.

Ubuntu mac

Notes

Please note that the Unix versions have some limitations.

  • .png, .jpg, and .bmp are unavailable.
  • BC6 and BC7 compression will take tons of times because the Unix builds can't use GPU.