help.InstallMacOS

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 Sikarugir

Sikarugir (which was formerly called "Kegworks", but was forced to rename because of that name was trademarked) is a convenient open source tool to run Wine on Mac OS X. Please follow the installation instructions on the Sikarugir repository, which in turn requires either MacPorts or Homebrew.

Sikarugir setup

First, setup Sikarugir / 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 Sikarugir 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.
  • The wrapper app will be placed in your userprofile: ~/Applications/Sikarugir/Tooll3.app, /Users/[name]/Applications/Sikarugir/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:

TiXL:

• dlls/d3dcompiler_43
• dlls/d3dcompiler_47
• fonts/corefonts

Tooll3:

• 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/Sikarugir/, /Users/[name]/Applications/Sikarugir/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/

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.

Installing TiXL

• Download latest release exe from https://github.com/tixl3d/tixl/releases
• Find your TiXL container in the /Applications/Sikarugir/ folder and
• Double click TiXL

• In Configuration run click Install Software.
• Select Choose Setup Executable ...

• Select your downloaded release (probably in Downloads):

The TiXL installer will magically appear:

Do not change the target folder and click Next:

This will install:

If .net9 has already been installed, it will ask to repair. In this case, click Close and confirm with Yes:

Finally click Finish with the Launch checkbox enabled:

Change the windows app path by clicking Browse:

Select TiXL:

Start with Test Run.

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)