Jump to Screening Room

Screening Room Integration

Screening Room integration right inside your application.
Latest Version: v0.5.0 (prod)
For our version numbers, we follow the Semantic Versioning standard.
System Name: tk-multi-screeningroom

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.

This app launches Screening Room for the current context. Jumping into your review session has never been easier! Just click a button and Screening Room will open, focused on the particular shot or asset you are currently working on. This also makes it really easy to see your submitted versions in context or review different variations that you submitted from inside your content creation application.


This is a small app that hooks up your current Maya session with Screening Room. It will add an item to the Shotgun menu saying Jump to Screening Room. Clicking this button will launch Screening Room and point it at the current Shotgun Toolkit Context - for example a Shot, Asset or a Task. You can then use Screening Room to browse all submitted content.

Haven't heard about Screening Room? Screening Room is Shotgun's feature for review and playback. For more information, go here: https://support.shotgunsoftware.com/hc/en-us/articles/221888287-Screening-Room

Installation and Updates

Adding this App to the Shotgun Pipeline Toolkit

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

> tank Project XYZ install_app asset tk-maya tk-multi-screeningroom

Updating to the latest version

If you already have this item installed in a project and you want to get the latest version, you can run the update command. You can either navigate to the tank command that comes with 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 tell it 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 we store and manage them. Feel free to evolve these items; 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. You can access this code repository at https://github.com/shotgunsoftware/tk-multi-screeningroom.

Special Requirements

  • You need Shotgun Pipeline Toolkit Core API version v0.19.1 or higher to use this.


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.


Type: str

Default Value: C:\Program Files\RV\RV64.exe

Description: The path to the Rv executable on Windows.


Type: str

Default Value: rv

Description: The path to the Rv executable on Linux.


Type: str

Default Value: /Applications/RV64.app

Description: The path to the Rv executable on Macosx.


Type: bool

Default Value: True

Description: Toggles the display of a menu item that allows a user to jump the Screening Room RV Player.


Type: bool

Default Value: True

Description: Toggles the display of a menu item that allows a user to jump the Screening Room Web Player.


Type: hook

Default Value: {self}/init.py

Description: This hook contains methods that a user can override in order control how the environment is initialized before screening room is launched.

Release Notes

Welcome to the release notes for this App. 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!



Rebranded to ShotGrid



Adds multi selection support for Version entities in tk-shotgun.



The app now supports Python 3.



Fixes a bug where it could fail to launch when providing a custom RV executable path.



Updated app icon.



Allows to launch RV using a shell function.


Supports context changes.



Added a pre-launch hook.


Fixes a crash when launching RV at the project level from the Desktop app.


Fixed a bug causing 32 bit RV on Macosx to fail to load.


Added option to jump into the web version of Screening Room.

Details: There are now two new configuration options which lets you toggle the items that are shown on the Shotgun menu. The first one is the one that lets you jump to Screening Room for RV - this is the functionality that we have had previously. The second one is a new option that allows a user to jump to the web version of Screening Room. This will pop up your default web browser and launch Screening Room there.


Renames and support for the new name Sgtk.


Added better metadata for the shell engine.


Name updated to Screening Room


  • Name changed to Screening Room


Details: Now runs in all engines. Updated manifest to require 0.12.5


Added support for code reload.


Initial release