README.md

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.

• Common plug-ins
• Common functionality
• File-menu shortcut

Installation

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.

Usage

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

# 1. Register your favourite GUI
import pyblish.api
pyblish.api.register_gui("pyblish_lite")

# 2. Set-up Pyblish for Maya
import pyblish_maya
pyblish_maya.setup()

Documentation

• Under the hood
• Manually show GUI
• No menu-item
• Teardown pyblish-maya
• No GUI

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
pyblish_maya.setup(menu=False)

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
pyblish_maya.show()

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
pyblish_maya.teardown()

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

No GUI

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.