matthewkapfhammer / quicklauncher

A minimal Qt based menu to quickly find and execute Maya commands and user scripts.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

QuickLauncher

A minimal Qt based menu to quickly find and execute Maya commands and user scripts.

quicklauncher

quicklauncher relies on PySide, it should work out of the box on Autodesk Maya 2014 or greater.

Installation

There are many ways to go about this, but for casual users I would recommend simply copy quicklauncher.py to your maya script directory.

If you are a developer or want to integrate quicklauncher in your pipeline, I highly recommend the standard setup.py script as it brings more flexibility and is the exact same procedure as every other python library.

python setup.py install

Usage

import quicklauncher
quicklauncher.show()

You can also select the folder in which quicklauncher will look for user scripts (repo).

import quicklauncher
quicklauncher.select_repo()

And alternatively, assign TAB key (it's kind of an special case as Maya reserve that key).

import quicklauncher
quicklauncher.setup_hotkey()

Be aware that the later override Maya default behavior of the tab key jumping between inputs in the attribute editor and editors alike.

For more info, check the Wiki (there are a few interesting things you can do).

Running tests

This is not something the average user should worry about, but if you want to contribute to quicklauncher development you can run the test suite by typing the following from the root of the project.

python setup.py test

Testing requires mock, it should be automatically installed by running the previous snippet in case it's not already available on your system.

Contributing

  • Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.

  • Fork the quicklauncher repository on Github to start making your changes (make sure to isolate your changes in a local branch when possible).

  • Write a test which shows that the bug was fixed or that the feature works as expected.

  • Send a pull request and bug me until it gets merged. :)

Make sure to add yourself to CONTRIBUTORS.md!

Known issues

  • quicklauncher does not supports MEL scripts at the moment.

About

A minimal Qt based menu to quickly find and execute Maya commands and user scripts.


Languages

Language:Python 100.0%