Skip to content
English
Sign in
My Inbox
  • There are no suggestions because the search field is empty.

KeyShot crashes when dragging or changing Materials on MacOS

Troubleshooting for unexpected crashes when dragging or changing Materials on MacOS

Issue

When altering or drag and dropping Materials in KeyShot Studio 2026 on MacOS, KeyShot might crash unexpectedly.

Environment Details

  • KeyShot
    • 2026.1+
  • MacOS

Troubleshooting

This might be known bug in the version of Qt (6.8.2) that we are using. A workaround for this known bug is to disable the accessibility feature in Qt, using an environment variable: QT_ACCESSIBILITY

Set the value of that environment variable to simply “0” (without the quotes) before starting KeyShot Studio.

  1. Open the Terminal 

    • Press Cmd (⌘) + Space
    • Type Terminal and press Enter

    or

    • Open Finder
    • Go to Applications → Utilities
    • Double-click Terminal
    • In the Terminal, type export QT_ACCESSIBILITY=0
      and press Enter, then start KeyShot Studio from the Terminal by entering
      open /Applications/KeyShot Studio.app

      Replace /Applications/KeyShot Studio.app with the actual path of the app on your disk.

    That method is only for a quick test to confirm that the workaround fixes the crashes, as the environment variable will not persist that way (and will not apply to the KeyShot Studio app launched through the Dock).


    Resolution

    If this indeed fixes the crashes, a more permanent way of setting the environment variable would be like this:

    Create a text file and enter the following:

    <?xml version="1.0" encoding="UTF-8"?>

    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

    <plist version="1.0">

    <dict>

    <key>Label</key>

    <string>com.keyshot.env</string>

    <key>ProgramArguments</key>

    <array>

    <string>launchctl</string>

    <string>setenv</string>

    <string>QT_ACCESSIBILITY</string>

    <string>0</string>

    </array>

    <key>RunAtLoad</key>

    <true/>

    </dict>

    </plist>

     


    Make sure to save it as a plain text and rename it to com.keyshot.env.plist
    Or download it here

    Place the file in 

    ~/Library/LaunchAgents/
     
    Lastly, using the Terminal, type the following command, which will re-run launchctl setenv automatically at every login:

     launchctl load ~/Library/LaunchAgents/com.keyshot.env.plist