![]() |
AdminUI FrameworkInterfaces for some standard Toolkit administration commands. |

Documentation
SetupProjectWizard API Reference
SetupProjectWizard Constructor
Installation, Updates and Development
Configuration Options
Release Notes History
Interfaces for some standard Toolkit administration commands.
Experimental Framework!
Please note that the latest release of this framework is v0.6.1, meaning that its interfaces are still experimental. While we try hard not to break backwards compatibility between updates, this still occasionally happens when the version number starts with a zero. Once the framework reaches 1.0, interfaces do not to break between major version number changes. For more information about these conventions, see the Semantic Versioning standard guidelines.
Documentation
The Admin UI Framework implements a place that holds standard user interfaces that wrap Toolkit administrative commands.
Currently the only interface is for the setup_project command.
SetupProjectWizard API Reference

This is a QWizard implementation that walks somebody through setting up a Project from their Shotgun instance for Toolkit. To use the wizard, simply create an instance of the class, passing in the project to setup (as a standard Shotgun API entity dictionary) and the window to parent to.
adminui = sgtk.platform.import_framework("tk-framework-adminui", "setup_project") setup = adminui.SetupProjectWizard(project, parent) dialog_result = setup.exec_()
This will run the wizard and return a standard QDialog Accepted or Rejected value.
SetupProjectWizard Constructor
Initialize a SetupProjectWizard. This is a subclass of QtGui.QWizard.
SetupProjectWizard()
Installation and Updates
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-framework-adminui. |
Special Requirements
- You need Shotgun Pipeline Toolkit Core API version v0.18.156 or higher to use this.
Configuration
No Configuration Needed!
This item does not have any options to configure!
Release Notes
Welcome to the release notes for this Framework. 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!
v0.6.1
2020-Oct-14
Small bug fixes.
Details: - Fixes an issue where the cancel button wouldn't show when the project setup failed. - Configuration paths picked via the browse dialog on Windows, now produce a path using back slashes rather than forward slashes. This means it should no longer fail validation when proceeding to the next step in the wizard.
v0.6.0
2020-Jul-15
Adds Python 3 support.
v0.5.2
2018-Oct-30
UI tweaks around error message positioning.
v0.5.1
2018-Oct-30
Tweaked error message text in the UI not to appear when distributed mode is selected.
v0.5.0
2018-Oct-04
Adds support for distributed configs in the setup wizard
v0.4.0
2018-Oct-03
Various fixes required for the setup project wizard to remain stable when run in a standalone app from Windows and Linux OSs.
v0.3.2
2018-Apr-17
Updates path sanitation for browsing and manual entry, bumps required core to v0.18.143
v0.3.1
2018-Apr-11
Bumps the minimum core required to v0.18.142
v0.3.0
2018-Mar-26
Adds storage mapping interface during project setup
v0.2.1
2017-Nov-27
Minor configuration description edits
v0.2.0
2017-Nov-08
Removes deprecated configs
v0.1.6
2016-Aug-25
Updates the framework dependencies to the latest major version.
v0.1.5
2016-Apr-12
Allow selecting a .zip archive of an existing config
Details:
Previously there was no option in SG Desktop to select a .zip file when setting up a project based on an existing config on disk. Now you can choose to select a .zip file or a directory.
v0.1.4
2016-Apr-11
(NOT RELEASED) Allow selecting a .zip archive of an existing config
v0.1.3
2016-Mar-29
The Help button now takes users to the new Toolkit support page.
v0.1.2
The tooltip for locked storage is now more explicit.
v0.1.1
Fix issue with disappearing path names in project setup
v0.1.0
Added flame as a default configuration option.
v0.0.15
Fix issue with clicking back button when configuration path is wrong
v0.0.14
Unable to click on the back button to change config path
Details:
Allow users to click on the back button to change the configuration folder path if an invalid value is entered
v0.0.13
Add a note to the setup project UI explaining locked storages
Details:
Makes disabled color more obvious and adds a lock icon to make it more user-friendly.
v0.0.12
Primary paths disappear when clicking on back/continue
Details:
As a Toolkit user, I want to be able to click on the back button and continue again without loosing the primary paths
v0.0.11
Prevents closing wizard prematurely while setup project is running.
v0.0.10
Fixes missing button on setup summary
Details:
Fixes missing 'Done' button on project setup summary page.
v0.0.9
26165: [desktop] Disable window manager close button on the setup project wizard
v0.0.8
26172: Repeated sentence in Select Configuration Location screen
v0.0.7
Fix for extra directories being created when editing project path name
v0.0.6
Added help urls, summary page, better progress indicators, and a couple of bug fixes.
Details:
- Added help urls
- Updated Git page to not be github specific.
- Added summary page
- Make progress page running/complete state more obvious
- Auto-advance from progress unless show details has been clicked
- Updated copy on summary screen
- Fix for attempting to create storage twice on storage page if validate is run multiple times
- Fix for key error when trying to hide nonexistent widget on project name page
v0.0.5
Visual polish
Details:
- Fix for missing spacer on configuration location page
- Fix for default focus
v0.0.4
New project icon.
v0.0.3
Visual polish and a fix for a Windows hang
Details:
General visual polist. Added a help button. Proper umasks when directories are created. Fix for a hang on Windows resulting from GUI updates from a thread.
v0.0.2
Various GUI improvements. Local Storage management.
Details:
No longer prompts for directory creation. Progress bar. Local Storage management.
v0.0.1
Initial release to app store.