Create filesystem folders from Shotgun.
By: Shotgun Software
Latest Version: v0.1.6 (prod)
For our version numbers, we follow the Semantic Versioning standard.
System Name: tk-shotgun-folders
This document describes functionality only available if you have taken control over a Toolkit configuration. Please refer to the Shotgun Integrations Admin Guide for details. Create folders on disk for a Shot, Asset, Sequence or other Shotgun entity directly from inside of Shotgun. The Shotgun Pipeline Toolkit will read its configuration and create a standardized and consistent folder structure on disk. You can also run the app in a preview mode which lets you do a "dry run" and see what files and folders would be created on disk before actually doing it.
Shotgun Pipeline Toolkit has a built in system that handles the creation of standardized directory structures based on a configuration. This makes it easy to quickly produce consistent file system layouts for multiple shots.
This App hooks up the file system creation API methods in the Sgtk Core API with Shotgun. This makes folder creation an easy task; just select a collection of Shots or assets and click the Create Folders action.
How it works
Simply select one or more Tasks, Shots or other entities (depending on the configuration). Now select create folders from the action menu. Once the process has completed, you will get a report of how many folders were created.
Installation and Updates
Adding this App to the Shotgun Pipeline Toolkit
If you want to add this app to the Shotgun action menu for Assets in Project XYZ, execute the following command:
> tank Project XYZ install_app shotgun_asset tk-shotgun tk-shotgun-folders
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-shotgun-folders.
- You need Shotgun Pipeline Toolkit Core API version v0.13.0 or higher to use this.
- You need Engine version v0.1.0 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.
Description: An optional parameter which lets you limit the visibility of this app. If you for example put in ['Artist'] as the value for this parameter, any user belonging to the shotgun permissions group Artist will not be able to see or execute the App.
Description: An optional parameter which lets you turn off this app on certain platforms. If you don't want it to appear on the Shotgun Pipeline Toolkit action menu for a platform, just include it in the the deny_platforms list. Valid values are Windows, Mac and Linux.
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!
Updated to make use of Shotgun's support of markdown.
Renames and support for the new name Sgtk.
Adjustments for v0.13 compatibility.
Optimized based on the changes to static folders done in 0.12.14
Updated to be 0.12.5 compliant.
Minor tweaks to make the app python2.5 compatible.
First Release with the new Tank API.
Initial release to the App Store.