Shotgun for VRED is not publicly available at this time. Please contact Shotgun Support for access.

Shotgun Engine for VRED

Shotgun Integration for VRED
Latest Version: v1.0.1 (beta)
For our version numbers, we follow the Semantic Versioning standard.
System Name: tk-vred

Please Note: This document describes functionality only available if you have taken control over a Toolkit configuration. Please refer to the Shotgun Integrations User Guide for more details.


Shotgun Engine for VRED Documentation



The Shotgun Engine for VRED creates a bridge between the Shotgun Pipeline Toolkit apps and VRED. Write apps using Python to run right inside the engine.


Supported Application Versions

This item has been tested and is known to be working on the following application version: 2020. Please note that it is possible, even likely, to work with some older releases; however, it has not  been formally tested with these versions.

Overview Video


Shotgun Engine for VRED Documentation

The Shotgun Engine for VRED contains a standard platform for integrating Shotgun Apps into VRED. It is lightweight, straight forward, and adds a Shotgun menu to the VRED menu bar.


  • For documentation specific to Shotgun integration with VRED, see Working with Shotgun in the VRED online help.
  • For general documentation on Shotgun's Automotive Design Studio Components, see Introduction.

Information for App Developer - VRED Project Management

Whenever the Shotgun Engine for VRED starts, it will set the VRED Project to point at a location defined in the engine settings. This means the project can also change when a new file is opened. The details relating to how the VRED project is set, based on a file, can be configured in the configuration file, using the template system.


Installation and Updates - Adding This Engine to the Shotgun Pipeline Toolkit

If you want to add this engine to Project XYZ, and an environment named asset, execute the following command:

> tank Project XYZ install_engine asset tk-vred

Installation and Updates - Updating to the Latest Version

If this item is already installed in a project and you want the latest version, run the update command. You can navigate to the tank command for that specific project and run it there:

> cd /my_tank_configs/project_xyz
> ./tank updates

Alternatively, you can run your studio tank command and specify the project name to indicate which project to run the update check for:

> tank Project XYZ updates

Collaboration and Evolution


If you have access to the Shotgun Pipeline Toolkit, you also have access to the source code for all apps, engines, and frameworks in GitHub, where they are stored and managed. Feel free to evolve these; use them as a base for further independent development, make changes (and submit pull requests back to us!), or simply tinker with them to see how they have been built and how the toolkit works. Access this code repository at https://github.com/shotgunsoftware/tk-vred.



Below is a summary of all the configuration settings used. These settings need to be defined in the environment file where you want to enable this App or Engine.



Description: This template is for setting the initial render file path.



Default Value:default_file_usage

Description: Hook to customize behaviour on file change and file close.


Release Notes

There are currently no release notes specific to the Shotgun Engine for VRED.

For a list of Shotgun's Design Studio Components release notes, see the Release Notes section of the documentation.




Please sign in to leave a comment.