Instantly share code, notes, and snippets.

What would you like to do?
Maya 2017 PySide2 Docking Qt QMainWindow
This is what you need to do in order to get a qt window to dock next to maya channel box,
In all maya versions, including 2017 with PySide2
__author__ = ""
import sys
import os
import logging
import xml.etree.ElementTree as xml
from cStringIO import StringIO
# Qt is a project by Marcus Ottosson --->
from Qt import QtGui, QtWidgets, QtCore, QtCompat
import pysideuic
from shiboken import wrapInstance
except ImportError:
import pyside2uic as pysideuic
from shiboken2 import wrapInstance
import maya.OpenMayaUI as omui
from import MayaQWidgetDockableMixin
import maya.cmds as cmds
def loadUiType(uiFile):
:author: Jason Parks
Pyside lacks the "loadUiType" command, so we have to convert the ui file to py code in-memory first
and then execute it in a special frame to retrieve the form_class.
parsed = xml.parse(uiFile)
widget_class = parsed.find('widget').get('class')
form_class = parsed.find('class').text
with open(uiFile, 'r') as f:
o = StringIO()
frame = {}
pysideuic.compileUi(f, o, indent=0)
pyc = compile(o.getvalue(), '<string>', 'exec')
exec pyc in frame
# Fetch the base_class and form class based on their type in the xml from designer
form_class = frame['Ui_%s' % form_class]
base_class = getattr(QtWidgets, widget_class)
return form_class, base_class
def maya_main_window():
main_window_ptr = omui.MQtUtil.mainWindow()
return wrapInstance(long(main_window_ptr), QtWidgets.QWidget)
def maya_api_version():
return int(cmds.about(api=True))
class MyDockingWindow(MayaQWidgetDockableMixin, QtWidgets.QMainWindow):
MAYA2014 = 201400
MAYA2015 = 201500
MAYA2016 = 201600
MAYA2016_5 = 201650
MAYA2017 = 201700
def __init__(self, parent=None):
self.deleteInstances() # remove any instance of this window before starting
super(MyDockingWindow, self).__init__(parent)
compile the .ui file on loadUiType(), a function that uses pysideuic / pyside2uic to compile .ui files
uiFile = os.path.join(os.path.dirname(__file__), 'MyDockingWindow_ui.ui')
form_class, base_class = loadUiType(uiFile)
self.ui = form_class()
def dockCloseEventTriggered(self):
# Delete any instances of this class
def deleteInstances(self):
def delete2016():
# Go through main window's children to find any previous instances
for obj in maya_main_window().children():
if str(type(
obj)) == "<class ''>": # ""<class ''>":
if obj.widget().__class__.__name__ == "MyDockingWindow": # Compare object names
def delete2017():
Look like on 2017 this needs to be a little diffrents, like in this function,
However, i might be missing something since ive done this very late at night :)
for obj in maya_main_window().children():
if str(type(obj)) == "<class '{}.MyDockingWindow'>".format(os.path.splitext(
os.path.basename(__file__)[0])): # ""<class 'moduleName.mayaMixin.MyDockingWindow'>":
if obj.__class__.__name__ == "MyDockingWindow": # Compare object names
if maya_api_version() < MyDockingWindow.MAYA2017:
def deleteControl(self, control):
if cmds.workspaceControl(control, q=True, exists=True):
cmds.workspaceControl(control, e=True, close=True)
cmds.deleteUI(control, control=True)
# Show window with docking ability
def run(self):
2017 docking is a little different...
def run2017():
# The deleteInstances() dose not remove the workspace control, and we need to remove it manually
workspaceControlName = self.objectName() + 'WorkspaceControl'
# this class is inheriting, which will eventually call maya.cmds.workspaceControl.
# I'm calling it again, since the MayaQWidgetDockableMixin dose not have the option to use the "tabToControl" flag,
# which was the only way i found i can dock my window next to the channel controls, attributes editor and modelling toolkit., area='right', floating=False)
cmds.workspaceControl(workspaceControlName, e=True, ttc=["AttributeEditor", -1], wp="preferred", mw=420)
# size can be adjusted, of course
def run2016():
# on maya < 2017, the magiclly docks the window next
# to the channel controls, attributes editor and modelling toolkit., area='right', floating=False)
# size can be adjusted, of course
self.setSizePolicy(QtWidgets.QSizePolicy.Minimum, QtWidgets.QSizePolicy.Preferred)
if maya_api_version() < MyDockingWindow.MAYA2017:
def show():
this is the funciton that start things up
global MyDockingWindow
MyDockingWindow = MyDockingWindow(parent=maya_main_window())
return MyDockingWindow

This comment has been minimized.

chisn8tech commented Dec 5, 2016

Have you found a simple way to make the docked tab remain in focus when tabbed with the Maya attribute editor etc? By default when you drag it to become a tab, it goes below the other tabs and must be selected to rise to the top again.

( "pm.workspaceControl(workspaceCtrlName, e=1, visibleChangeCommand=self.makeItRise)" initially looked hopeful, but it appears that it is called just BEFORE the dock is actually docked, so calling self.raise_() etc in self.makeItRise did nothing. )

I ended up having to 'post' a custom event to the QApplication with a lower than 'low' priority,
(or use pm.mel.evalDeferred('workspaceControl -r name'), but that was ugly,)
and catch it with an eventFilter,
in order to execute the 'raise' tab part after it had actually been tabbed :(

(I also had to use an eventFilter (on self.parent() ) to catch the close event (event.Close) when the tab/floating dock was closed, as I wanted to save the layout on closing...)


This comment has been minimized.

marvolo3d commented Jan 6, 2017

Seems to work well other than 2014 which doesn't have mayaMixin


This comment has been minimized.

ryanitto commented Mar 10, 2017

This was quite helpful to create a dockable window in Maya 2017+. I might make a suggestion for line 116-122:

        if str(type(obj)) == "<class '{}.{}'>".format(

            # Compare object names
            if obj.__class__.__name__ == self.__class__.__name__:

This is a bit easier to just pull your class name from the __name__ type.


This comment has been minimized.

Klaudikus commented Apr 18, 2017

I just tested a few things in Maya 2017, and in my tool that inherits from MayaQWidgetDockableMixin, the dockCloseEventTriggered method never gets called. The two only methods that get called when opening or closing the window are showEvent, and hideEvent, respectively. If you look at the source, there are Signals not connected to anything, moreover, dockCliseEventTriggered doesn't seem to have a super or Widget method override. Maybe I'm missing something, or my setup is incorrect, but this Mixin class is handy, but incomplete.


This comment has been minimized.

griffinanimator commented May 25, 2017

This works great for me. The issue I currently have is that the statusBar only sends messages to the main maya window not the generated dockable window. In 2015 the status bar behaves as expected. Could this be something with the QT module? Anyone else experiencing this?


This comment has been minimized.


liorbenhorin commented Dec 1, 2017

Hey All, sorry for not replying, must have missed the party...
Anyways, here is a new, simpler and more stable way to achieve this:


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment