Setting your frame range

Sync frame range with Shotgun

Sync the frame range in your scene with the one stored in Shotgun.

By: Shotgun Software
Latest Version: v0.3.0 (prod)
For our version numbers, we follow the Semantic Versioning standard.
System Name: tk-multi-setframerange


This document describes functionality only available if you have taken control over a Toolkit configuration. Please refer to the Shotgun Integrations User Guide for details. This is a simple yet useful app that syncs your current file with the latest frame range in Shotgun for the associated shot. If a change to the cut has come in from editorial, quickly and safely update the scene you are working on using this app. Towards the end, it will display a UI with information about what got changed.


This app helps managing the frame range in the currently open scene. You can access it from the Shotgun menu by clicking the Sync Frame Range with Shotgun menu option.

When you click it, the Shotgun Toolkit will look at the shotgun entity associated with the current work area (typically a Shot) and look for in and out fields which contain the in and out frame information. Typically, this is something used in conjunction with Shots and in that case the app uses the standard shot in and out fields defined in Shotgun's default config. However, it is perfectly possible to configure the app to pull the frame ranges from other fields too.


Once you run the App, it will update the current scene with those ins and outs and finally display a summary message:


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-nuke tk-multi-setframerange

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

Special Requirements

  • You need Shotgun Pipeline Toolkit Core API version v0.12.5 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: sg_cut_in

Description: The Shotgun field to use to retrieve the in frame. The app will look for this field on the entity associated with the current context (e.g. the current shot, current asset etc).


Type: str

Default Value: sg_cut_out

Description: The Shotgun field to use to retrieve the out frame. The app will look for this field on the entity associated with the current context (e.g. the current shot, current asset etc).

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!


Adds context changing support.


Improved formatting for display of frame ranges in nuke.


Added support for the new 3DS Max Engine supporting MaxPlus and Max version 2015.


Improved handling of multiple frame range updates.

Details: The app now attempts to update the frame range every time you run it. This is a slight change to the behaviour - previously it would first check and see if the frame range needed updating and if so attempt to update it. This was causing some issues when a shot for example had different anim and render frame ranges. This release solves this by running the update every time to ensure that all fields are updated.


Minor tweaks and bug fixes.

Details: - Softimage logic now sets the global in and out range as well as the render range. - Houdini logic now sets the global frame ranges via hscript tset command.


Added support for 3dsmax.


Maya frame range adjustments now also updates the render globals and the animation frame range.


Maya frame range adjustments now also updates the render globals and the animation frame range.


Added Houdini support

Details: Added Houdini support


Renames and support for the new name Sgtk.


Added Softimage support.


Added icon.


Uses new Tank QT access. Updated manifest to be v0.12.5 compliant.


Initial release



  • 0
    Mathieu Leblanc

    Hi, it's possible to add this to the app? At the moment I need to clone the app to add this.


    def get_current_frame_range(self, engine):


    elif engine == "tk-3dsmax":

    from Py3dsMax import mxs

    current_in = mxs.animationRange.start

    current_out = mxs.animationRange.end

    def set_frame_range(self, engine, in_frame, out_frame):


    elif engine == "tk-3dsmax":

    from Py3dsMax import mxs

    mxs.animationRange = mxs.interval(in_frame, out_frame)

    And add it to info.yml

    supported_engines: [tk-nuke, tk-maya, tk-motionbuilder, tk-softimage, tk-houdini, tk-3dsmax]

  • 0
    Manne Öhrström

    Hey there Mathieu!

    Sorry about the extremely delayed response and many thanks for your valuable contribution! I have just pulled this into github now and we are just going to quickly QA it and then we'll release this change as part of the offical toolkit code base!


  • 0
    Juanmaria Garcia

    The code line to add the app makes reference to asset and nuke:

    tank Project XYZ install_app asset tk-nuke tk-multi-setframerange

    shouldn't it be shots and 3dsmax?

  • 0
    Kevin Lemaire


    Any plan to add the frame rate sync?This is really missing. 



  • 0
    Jeff Beeland

    Hi Kevin!

    There's not a great place in the default Shotgun schema that tracks FPS at the level of a project or shot. If you're interested in putting in a feature request for this, could you contact with an explanation of how you're tracking FPS in Shotgun, and we can get the request logged.

Please sign in to leave a comment.