A new version of ShotGrid Desktop has been released!

Welcome to the release notes for the ShotGrid Desktop. Below you will find an overview of all the changes we did for each release. We try to be as detailed as possible and include all bugs we have fixed, features we have added and things that may have changed. If you have questions about a particular release, don't hesitate to contact our support team.

If you want to install ShotGrid Desktop, head over to the getting started guide.


Updates some third-party dependencies and packages the latest version of the Shotgun Integrations.


  • Updates Python to 2.7.14.
  • Updates OpenSSL to 1.0.2k.
  • Updates the Shotgun Integrations to v1.1.12.

Download links:

v1.5.3 macOS | v1.5.3 Windows | v1.5.3 Linux CentOs 5/6 | v1.5.3 Linux CentOs 7/Fedora


Fixes an issue importing ctypes on Linux and packages the latest version of the Shotgun Integrations.

Download links:

v1.5.4 macOS | v1.5.4 Windows | v1.5.4 Linux CentOs 5/6 | v1.5.4 Linux CentOs 7/Fedora


Fixes an issue with SSO when using Okta as the SSO provider.

This update drops support for macOS 10.8 and below. If you want to keep using the Shotgun Desktop with an older version of macOS, you should keep using Shotgun Desktop v1.5.4. If for need to use single-sign on through Okta and are running macOS 10.8 and below, please contact our support team and we'll help you get up and running.

Auto-updates are still supported for all versions of macOS.

Download links:

v1.5.5 macOS | v1.5.5 Windows | v1.5.5 Linux CentOs 5/6 | v1.5.5 Linux CentOs 7/Fedora


Fixes an issue with SSO when authenticating over NTLM on Linux and macOS.

A bug in Qt's QAuthenticator prevents Toolkit from authenticating with Shotgun when using NTLM on a domain-bound macOS or Linux computer. In order to authenticate with Shotgun, Toolkit will now request your system credentials in order to sign-in.

Download links:

v1.5.6 macOS | v1.5.6 Windows | v1.5.6 Linux CentOs 5/6 | v1.5.6 Linux CentOs 7/Fedora


Security release for the browser integration.

Download links:

v1.5.7 macOS | v1.5.7 Windows | v1.5.7 Linux CentOs 5/6 | v1.5.7 Linux CentOs 7/Fedora


Fixes an issue when signing into Shotgun Desktop using Okta as the SSO provider.

Download links:

v1.5.8 macOS | v1.5.8 Windows | v1.5.8 Linux CentOs 5/6 | v1.5.8 Linux CentOs 7/Fedora


Fixes a crash during startup on macOS Catalina (10.15) when using an older version of the browser integration. This build is otherwise identical to 1.5.8. There's no need to upgrade if you are not on macOS Catalina or planning to upgrade to Catalina.

Download links:

v1.5.9 macOS | v1.5.9 Windows | v1.5.9 Linux CentOs 5/6 | v1.5.9 Linux CentOs 7/Fedora


Adds Python 3 and Qt5 support to Shotgun Desktop.


This release of Shotgun Desktop includes both Python 2.7.17 and Python 3.7.8 support. It also ships with Qt 5 and PySide 2.

It is supported on the following platforms:

  • Windows 8 and above
  • macOS 10.13 and above
  • CentOS 7.4 and above

Download links:

v1.6.1 macOS | v1.6.1 Windows | v1.6.1 CentOS

What is new?

You can choose which version of Python to run Shotgun Desktop under. When running the Advanced Project Setup in Python 3 mode, projects will be configured to use the built-in Python 3 interpreter. Note that once setup, a project configured with Python 3 can still be used by a user running a Python 2 version of Shotgun Desktop and vice-versa.

To select which version of Python to use on startup, set the SHOTGUN_PYTHON_VERSION environment variable to 2 or 3.

What steps should I take to ensure my site configuration and projects will work in Python 3 mode?

If you do not have a custom site configuration, no steps need to be taken. Shotgun Desktop comes packaged with the latest versions of all our components out of the box.

If you have customized your site configuration and/or project configurations, make sure that they have the most recent versions of the following packages:

  • tk-desktop (v2.5.9+)
  • tk-framework-shotgunutils (v5.7.6+)
  • tk-framework-qtwidgets (v2.8.3+)
  • tk-framework-desktopserver (v1.4.4+)
  • tk-multi-launchapp (v0.11.2+)
  • tk-core (v0.19.16+)

What about content creation software running in Python 3 mode?

We currently support the following products in Python 3 mode:

  • Autodesk 3dsMax
  • Autodesk Alias
  • Autodesk Maya
  • Autodesk VRed
  • SideFX Houdini
  • Adobe Photoshop
  • Adobe After Effects

Note that to launch a given product in Python 3 mode, you will need to modify the software entities in Shotgun. See your content creation software's command-line arguments to find which command-line arguments launch it in Python 3 mode. You'll also need to update apps and engines in your configuration for Python3 compatible versions.

For an up to date list of Toolkit bundles and products supported with Python 3, see this list.

Will custom Toolkit applications work in Python 3?

Provided the code has been ported to Python 3 and is targeting Python 3.7.x, they should work. If you've never ported an application to Python 3, we've documented the process we've used to port our code to Python 3.


Rebranded to ShotGrid and includes ShotGrid Integrations v1.4.0.

v1.7.0 macOS | v1.7.0 Windows | v1.7.0 CentOS


Upgrades Python versions 2.7.17 and 3.7.11 for security fixes in desktop packages.

v1.7.1 macOS | v1.7.1 Windows | v1.7.1 CentOS


Support for PySide2 v5.15

v1.7.2 macOS | v1.7.2 Windows | v1.7.2 CentOS


ShotGrid branding updates and make Desktop use Python 3 by default.


ShotGrid Desktop is now launching with Python 3 by default. You override this feature using SHOTGUN_PYTHON_VERSION=2 environment variable.

Download Links:

v1.7.3 macOS | v1.7.3 Windows | v1.7.3 CentOS

1 Like


Adding support for Rocky Linux 8. Only Python 3.9 is now included with ShotGrid Desktop.


  • Python version 2.7 were removed from the installer.
  • Rocky 8.X are supported.
  • Aligned with desktop-packages VFX 2022.

Download Links:

v1.8.0 macOS | v1.8.0 Windows | v1.8.0 CentOS7/Rocky8

1 Like