Integrations Document Index

Overview and Getting Started

This section contains various useful documents that will help you getting started with the Shotgun Pipeline Toolkit. This is a good starting point if you want to learn more about what the Shotgun Pipeline Toolkit is, how it works and how it can help you build pipelines and tools integrated with Shotgun.

Introducing the Shotgun Pipeline Toolkit

The Shotgun Pipeline Toolkit (sgtk) is a suite of pipeline tools and building blocks designed for artists, engineered for developers, and accessible to everyone. Sgtk is now available in public beta for existing Shotgun users!

Example Videos

A collection of example videos showing how Shotgun Pipeline Toolkit integrates into different Application environments. Curious what Shotgun looks like in Maya or Nuke...? Then take a closer look at this document.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For more details, see the Shotgun Integrations User Guide.

Installing Shotgun Desktop and creating your first Toolkit Project

Want to see what the Shotgun Pipeline Toolkit is all about? This document explains with simple, step-by-step instructions how to install the Shotgun Desktop and setting up your first Toolkit project.

Beyond your first project

Here, we explain where to go once you have got your first project up and running using the Shotgun Desktop. It covers useful common questions and topics and lists useful documentation resources.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For details, see the Shotgun Integrations User Guide.

An overview of the different Concepts in the Shotgun Pipeline Toolkit.

Here, we cover the main concepts in detail: How apps and Engines work, how the toolkit is launched and manages the current context (work area), how folders are created on disk etc. We recommend that anyone involved in configuration or development start here.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For details, see the Shotgun Integrations Admin Guide.

Examples

This section contains a collection of examples of how you can use Shotgun Pipeline Toolkit Apps in different workflows and setups. Toolkit Apps are generally highly configurable, so the same app may be used in several different ways. In this section we will post tutorials and examples of workflows that are commonly requested by the Shotgun pipeline community.

Publishing Alembic from Maya

This tutorial shows how you can configure Multi Publish to export Alembic files when you are publishing groups of geometry from Maya.

Toolkit Pipeline Tutorial

This document provides a step-by-step tutorial for Technical Directors (TDs) setting up a simple end-to-end pipeline using Toolkit in an advanced way. New Toolkit users who finish this tutorial will understand the fundamental aspects of the platform as well as how to customize it based on their studio's specific needs. The tutorial also provides an introduction to the out-of-the-box Toolkit apps and how they fit together in the artist workflow.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For more info, see the Shotgun Integrations User Guide.

Perforce Integration

This document describes the Perforce integration for Toolkit - what it is, who it is aimed at and a high level overview of how it is implemented.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For more info, see the Shotgun Integrations Admin Guide.

Technical Documentation

This section contains more detailed technical information that may be useful when you start to explore how you can tailor the Shotgun Pipeline Toolkit to work with your studio or if you want to learn how to build your own custom Sgtk apps and integrations.

An introduction to how to administer and configure Toolkit

This document covers some of the more detailed aspects of configuration and administration. It explains how to update and install apps, how the environments work and how to test new versions of apps and the Core API in a sandbox environment prior to production install.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For the default setup, please see Shotgun Integrations Admin Guide.

Configuration staging and rollout

This document explains best practices for how to safely roll out changes to your production pipeline. It explains how you can create a staging sandbox, which is a copy of your production configuration, update this sandbox and do testing and then finally push your changes to the production config.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For the default setup, please see Shotgun Integrations Admin Guide.

Getting Started with App Development

This is a brief introduction to App development and how the Shotgun Pipeline Toolkit can make things easier for you when you develop new tools.

Engine Development

How does engine development work and what is needed if you want to integrate an application with Toolkit? This document covers some of the basic questions we often get asked about engine development.

Reference Documentation

This section contains all the API Reference documentation for the Shotgun Pipeline Toolkit. The most recent release of the Shotgun Pipeline Toolkit Core API is reflected in these docs.

File System Configuration Reference

This document is a complete reference of the file system centric configurations in the Shotgun Pipeline Toolkit. It outlines how the template system works and which options are available. It also shows all the different parameters you can include in the folder creation configuration.
Please note that this document describes functionality only available if you have taken control over a Toolkit configuration. For details, see Shotgun Integrations Admin Guide.

Apps and Engines Configuration Reference

This document contains an overview of all the different options that you can include when creating configurations for Apps, Engines and Frameworks in the Shotgun Pipeline Toolkit. It can be useful when doing advanced configuration of Apps, and it is important when you are doing development and need to add parameters to your App Configuration Manifest.
This document describes functionality only available if you have taken control over a Toolkit configuration. For more info, see Shotgun Integrations Admin Guide.

Core API Reference

This is the reference documentation for the Toolkit Core API. It covers the part of the API which is not app and engine related, e.g. the context, folder creation, file system templates resolution and general admin and maintenance functionality.

Platform API Reference

This reference shows all methods and classes relating to App and Engine development. This is handy when you are developing your own Apps or Engines.

Core API Release Notes

These are the release notes for the Toolkit Core API. Whenever we release a new version, we enter a description of what we have changed here.

Shotgun Desktop Release Notes

These are the release notes for the Shotgun Desktop. Whenever we release a new version, we enter a description of what we have changed here.

Follow

0 Comments

Please sign in to leave a comment.