![]() |
QT Widgets FrameworkA Collection of Reusable QT Widgets to simplify app development. |

Documentation
Installation, Updates and Development
Configuration Options
Release Notes History
A collection of Toolkit Related QT widgets. Includes a help popup screen, a standard delegate view framework and a standard spinner overlay.
Documentation
The API Reference documentation for this Framework can be found here:
http://developer.shotgunsoftware.com/tk-framework-qtwidgets
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-qtwidgets. |
Special Requirements
- You need Shotgun Pipeline Toolkit Core API version v0.19.1 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!
v2.9.4
2020-Nov-16
Fixes an issue in the global search widget where matches with unicode characters in them would not appear.
v2.9.3
2020-Sep-14
Fixes a rare rendering glitch in a group view.
v2.9.2
2020-Feb-3
Fixes a date display issue in the activity stream and the search completion tool for the entity tree search widget in Python 3.
v2.9.1
2020-Feb-3
Fixes a few issues with the activity stream in Python 3.
v2.9.0
2020-Jan-22
Adds Python 3 support.
v2.8.6
2019-Nov-14
Fixes an issue when updating the content of the activity stream.
v2.8.5
2019-Oct-28
Fixes an issue preventing from selecting a new context in certain versions of PySide2.
v2.8.4
2019-Oct-03
The context selector's my task drop down, now shows tasks assigned to a user's group as well as directly to the user.
v2.8.3
2019-Feb-27
Resolves an issue where placeholder thumbnails were never replaced in the activity stream widget.
Details:
There's now an interim period after a thumbnail image is uploaded to Shotgun where that image is not available for download. During this period, Shotgun provides a placeholder image. When our activity stream widget encountered one of these thumbnails, it would cache information about it that would be reused forever, rather than eventually being replaced with the "hero" thumbnail image. We now trigger a cache dump and rescan of the activity stream when we encounter these placeholder thumbnails.
v2.8.2
2018-Sep-19
Minor tweak to the activity stream to fix a crash bug in some PySide2 environments.
v2.8.1
2018-May-20
Fixes bugs relating to bg manager thread leaking.
v2.8.0
2018-Mar-27
The ShotgunOverlayWidget can now display HTML content.
v2.7.3
2018-Mar-23
Fixes an issue with certain versions of PySide2 and the screenshot widget.
v2.7.1
2018-Jan-09
Fixed an edge case bug in HierarchicalFilteringProxyModel
recursive filtering.
v2.7.0
2018-Jan-05
Introduces a new context selection widget, first introduced in tk-multi-publish2 and now moved here.
v2.6.6
2017-Dec-06
Updated metrics logged
v2.6.5
2017-Aug-19
Uses a safe method of forcing deletion of Qt widgets that prevents garbage collection issues in PySide2/Qt5.
v2.6.3
2017-Jun-15
Now uses internal QT screengrab logic on linux if imagemagick has not been set up.
v2.6.2
2017-May-16
Updates to the search widgets.
Details:
The HierarchySearchCompleter
and GlobalSearchCompleter
will now clear their contents when ESC is hit or a result picked from the dropdown.
v2.6.0
2017-May-03
Added hierarchy completer and overlay spinner widget
Details:
- Adds hierarchical search completer, similar to the completer found in the Shotgun global media app. This completer searches along the structure defined by the hierarchy settings in Shotgun.
- Adds ShotgunSpinningWidget, an extended version of the existing overlay widget.
- Upgrades to require core 18.45 and sg utils 5.2.0 or greater.
v2.5.18
2017-Mar-15
Removes problematic profiles from png files used as icons.
Details:
This will silence libpng warnings from Qt when the png files are loaded as pixmaps. This is a second attempt as this profile stripping, and uses ImageMagick's "mogrify" command to achieve the desired result, which maintains color consistency.
v2.5.16
2017-Feb-17
Properly addresses new Note entities to include the creator of the linked-to entity.
v2.5.15
2017-Jan-06
Adds a field widget delegate that does not require a ShotgunModel
v2.5.14
2017-Jan-06
Adds a field widget delegate that does not require a ShotgunModel
v2.5.13
2016-Dec-19
Fixes a bug in activity stream data manager destroy
v2.5.12
2016-Nov-22
Fixes default key navigation in SG menu
v2.5.11
2016-Nov-19
Field menu polish
v2.5.10
2016-Oct-07
Adds get_hyperlink_html utility function that defines standard hyperlink styling.
v2.5.9
2016-Sep-28
Activity stream widget no longer shows multiple notes in the UI after a reply.
v2.5.8
2016-Sep-27
SG menu now scrollable when size extends beyond height of display
v2.5.7
2016-Sep-22
Hotfix for qtwidgets docs build
v2.5.6
2016-Sep-16
Styling tweaks for ActivityStreamWidget. These account for the needs to of both Shotgun Panel and Shotgun Review for RV.
v2.5.5
2016-Sep-13
Styling fixes and general debugging of editable fields in the VersionDetailsWidget.
Details:
As editable shotgun fields widgets are being used in RV for the first time, some styling tweaks were required. In addition, some bugs and performance issues were discovered during RV's QA process that necessitated a number of fixes and tweaks to various components within the framework.
v2.5.4
2016-Sep-12
Adds backward compatibility support for project searching via entity and multi entity field widgets
v2.5.3
2016-Sep-02
Polish for field widgets in version details
v2.5.2
2016-Sep-01
Polish for field widgets and associated classes based on QA
v2.5.1
2016-Aug-25
Fixes for entity edit widgets as per QA notes
v2.5.0
2016-Aug-23
Shotgun fields in the VersionDetailsWidget are now editable.
Details:
Once edited in the widget, those changes are sent to Shotgun and the fields are updated there. Along with this feature comes additional getters on shotgun_fields widgets.
v2.4.3
2016-Aug-12
Removes the use of collections.OrderedDict in the VersionDetails widget.
Details:
The OrderedDict class is not available in Python versions older than 2.7.
v2.4.2
2016-Aug-10
Fixed bugs around note creation when running in a site context
v2.4.1
2016-Aug-08
Adds attachments filtering mechanism and new note autoselection to the activity stream widget.
v2.4.0
2016-Aug-03
Adds a VersionDetailsWidget Qt widget and its associated classes.
Details:
A version details widget has been added. This widget makes use of Shotgun's activity stream data to present a user with a view into a Version entity's activity stream, plus a second tab displaying a list of related Version entities found in Shotgun. In addition, a ShotgunSortFilterProxyModel class is provided for sorting and filtering Shotgun data in a list view.
v2.3.7
2016-Jul-19
Allow the editor widgets to be used with the shotgunmodel
v2.3.6
2016-Jul-01
Uses SG_LINK_COLOR qss constant when it is available, and bubbles up the ability to turn off clickable user icons from lower-level activity stream widgets.
v2.3.5
2016-Jun-22
Allows field specific widget registration via class member
v2.3.4
2016-Jun-21
Adds ability to register widgets for specific entity/type
v2.3.3
2016-Jun-14
[minor] Adds a property for image_url in shotgun_fields.image_widget.
v2.3.2
2016-Jun-13
Bug fix related to decorator application order for shotgun_fields' metaclass.
v2.3.1
2016-Jun-07
Allows for a pre-submission callback to be registered for use during Note/Reply entity creation.
Details:
The new callback has been put into place to allow higher-level app code to do something like procedurally generate attachments for a new Note/Reply at the time of submission. In addition, the use of QtCore.Property in the version stream widget has been replaced with normal Python property() calls to ensure compatibility with more than just PySide (ie: PyQt4).
v2.3.0
2016-May-25
Adds editing functionality to shotgun fields widgets
v2.2.1
2015-Dec-09
HierarchicalFilteringProxyModel now listens to reset signals from its source model.
Details:
When the HierarchicalFilteringProxyModel model receives the reset signal it will automatically clear its cache of model indices. This will allow the source model to delete its nodes much quicker since there will not be any QPersistentModelIndex caches to update.
v2.2.0
2015-Nov-23
Updated to use v4.x.x of the Shotgun Utils framework.
v2.1.0
2015-Nov-10
Added new widgets extracted from the Shotgun Panel app.
Details:
- Added sphinx documentation for framework, located in http://developer.shotgunsoftware.com/tk-framework-qtwidgets
- Added activity stream widget from the Shotgun Panel
- Added global search widget from the Shotgun Panel
- Added note input UI from the Shotgun Panel
- Added playback label from the Shotgun panel
- Added screengrab widget from the Shotgun panel
v2.0.6
Additional fixes and improvements as well as code tidy-up.
v2.0.3
Fix to the HierarchicalFilterProxyModel to support earlier versions of PySide
v2.0.2
Added additional widgets used by the File Manager and fixed various bugs
Details:
- Added new widgets including a search control, an elided text label that can handle HTML and the navigation controls from the Loader.
- Fixed numerous bugs in the grouped list view and hierarchical filtering proxy model
v2.0.1
Initial pre-release v2.x for testing with File Manager v2
v1.0.3
removing file_browser widget
v1.0.2
adding file browser widget
v1.0.1
Fixed PyQt 4.6.2 compatibility issue
Details:
- Some old versions of PyQt don't contain the Q*Animation classes introduced in Qt 4.6 and this was causing some Toolkit features to fail
- Updated to require core v0.14.58
v1.0.0
Initial release.