Pyblish for Maya
Clone or download
mottosso Merge pull request #74 from darkvertex/dev_build_wheels
Edit Travis config to build a Python wheel (.whl) along with the .tar.gz file
Latest commit 75db8b5 Sep 8, 2018

Build Status

Pyblish integration for Autodesk Maya 2008-2019.

What is included?

A set of common plug-ins and functions shared across other integrations - such as getting the current working file. It also visually integrates Pyblish into the File-menu for easy access.


pyblish-maya depends on pyblish-base and is available via PyPI.

$ pip install pyblish-maya

You may also want to consider a graphical user interface, such as pyblish-qml or pyblish-lite.


To get started using pyblish-maya, run setup() at startup of your application.

# 1. Register your favourite GUI
import pyblish.api

# 2. Set-up Pyblish for Maya
import pyblish_maya


Under the hood

The setup() command will:

  1. Register maya and mayapy as as a "host" to Pyblish, allowing plug-ins to be filtered accordingly.
  2. Append a new menu item, "Publish" to your File-menu
  3. Register a minimal set of plug-ins that are common across all integrations.


No menu-item

Should you not want a menu-item, pass menu=False.

import pyblish_maya

Manually show GUI

The menu-button is set to run show(), which you may also manually call yourself, such as from a shelf-button.

import pyblish_maya

Teardown pyblish-maya

To get rid of the menu, and completely remove any trace of pyblish-maya from your Maya session, run teardown().

import pyblish_maya

This will do the opposite of setup() and clean things up for you.


In the event that no GUI is registered upon running setup(), the button will provide the user with this information on how they can get up and running on their own.