help.InstallMacOS - tixl3d/tixl GitHub Wiki

Background

We are working on MacOS support, but this is a major task that requires multiple drastic refactoring efforts. We have already made large strides in separating Windows dependencies from the .NET architecture. However, moving from DirectX to Vulkan and supporting abstraction layers for Metal will be another significant undertaking.

Running with Kegworks

Kegworks is a convenient open source tool to run Wine on Mac OS X. Please follow the installation instructions on the Kegworks repository, which in turn requires either MacPorts or Homebrew.

Kegworks setup

First, setup Kegworks Winery:

  • install a new engine by pressing the plus icon below the list, selecting the engine and pressing 'Download and install' (v23.7.1 and v24.0.7 seem to be working well at the time of writing)
  • install the wrapper by pressing 'Update Wrapper'

Setting up the Kegworks Wrapper

  • click the 'Create new blank wrapper' button
  • name the application (for example: Tooll3)
    • this will hang the window for a while. It may take a few minutes while the window is unresponsive.
    • yhe wrapper app will be placed in your userprofile: ~/Applications/Kegworks/Tooll3.app, /Users/[name]/Applications/Kegworks/Tooll3.app
    • once finished, you will see a dialog confirming the creation and you can open it
  • you now are required to install some wintricks, by clicking the Winetricks button:
    • dlls/d3dcompiler_43
    • dlls/d3dcompiler_47
    • dlls/dotnetdesktop6
    • fonts/corefonts

Installing Tooll3

  • Download and unzip the current stable Tooll3 release (v3.9.3 at the time of writing): https://github.com/tixl3d/tixl/releases/
  • Go to the Application folder (~/Applications/Kegworks/, /Users/[name]/Applications/Kegworks/Tooll3.app)
  • Right-click (control click) the app and select the show package contents option
  • Drag and drop the unpacked Tooll3 folder into Contents/drive_c/

out

Finishing the Wrapper configuration

  • Open your created Tooll3.app again
  • Click on advanced
  • Set the executable by pressing the "Browse" button to "C:\TiXL-v3.9.3\StartT3.exe" by navigating to the pasted folder
  • Set Direct3D to Metal translation layer option
  • (optionally change the logo)
  • click on 'Test Run'

Tooll3 should now start successfully on your Mac. If you run into any issues, feel free to reach out by creating a new issue in this repository.

Optional: Allow Retina rendering

  • Open the advanced settings of the wrapper
  • Go into the 'Tools' tab
  • Click the 'Registry Editor' button
  • Open HKEY_CURRENT_USER\Software\Wine\Mac Driver
  • Right-Click in the main pane New > String Value
  • Name the key RetinaMode and the value Y (capitalization is important)

image