Table Of Contents

Previous topic


Next topic

Configuring oyProjectManager

This Page

How to install oyProjectManager

Automated install

  1. Download and install Python 2.6 (that is because most of the programs are still using 2.6)

  2. Download and install setup tools

  3. Run:

    easy_install-2.6 oyProjectManager

    This will install oyProjectManager to your pythons dist-packages folder with all its dependencies.

  4. Copy all the packages to a shared folder, which is visible to other computers in your studio.

  5. Add the following paths to PYTHONPATH environment variable to let all the applications to see the modules:


As a side note, running the installation code above under one operating system and using oyProjectManager under other operating systems is working without any problems. The only side effects should be the lack of C extensions that both libraries supplying, but this will not affect the speed as may it has been thought of.

Manual install

  1. Download oyProjectManager and extract it and copy the oyProjectManager folder to a shared folder which all of your workstations are able to see.

  2. Download SQLAlchemy and again extract it to a shared folder.

  3. Do the same for Jinja2.

  4. Add these paths to the PYTHONPATH environment variable to let all the applications to see the modules:



oyProjectManager needs two environment variables to be defined, REPO and OYPROJECTMANAGER_PATH.

REPO: set to a path where you want to save your projects. This is typically a mapped drive like M:\Projects for Windows and or a mount like /mnt/M/Projects in Linux and OSX.

OYPROJECTMANAGER_PATH: The path that contains the file, which is the configuration file for the system (I also suggest to use this folder to place your SQLite3 database file).

See configuring oyProjectManager for the details about

User Interfaces

  1. If you don’t plan to use another interface library and do all that nasty coding by your self I also strongly suggest you to install PyQt4 or PySide for all to your applications (Maya, Nuke, Houdini etc.) and use the UI coming with oyProjectManager. Because installing PyQt4 and PySide is a little bit involving, I’m leaving you by your self about how to install it. For a quick tip search for MyQt4 for Maya, and you can use this blog post about compiling PyQt4 under Windows.
  2. Newer versions of Nuke comes with PySide installed, to be able to use PySide instead of PyQt4, add a new environment variable to Nuke’s startup script ( called “PREFERRED_QT_MODULE” and assign the value “PySide”.
  1. You should be ready to go, run maya, be sure that maya is able to see the directory you have copied the modules in to and run:

    from oyProjectManager.environments import mayaEnv
    from oyProjectManager.ui import version_creator
    mEnv = mayaEnv.Maya()

    When you run the above script, you should be able to see the version_creator UI. Which as the name suggests creates new versions for some assets or shots.

    The interface should explain itself. But because you didn’t created any Project yet you will not be able to create any assets or shots or versions.

  2. To bring up the project_manager interface use the following code:

    from oyProjectManager.ui import project_manager

This will show up a new interface where you can create and edit Projects, Sequences and Shots.

You can also run the project_manager from the regular Python shell if you have successfully installed oyProjectManager, SQLAlchemy and Jinja2 to your system installation of Python by using the automated install.

  1. To bring up the status_manager interface use the following code:

    from oyProjectManager.ui import status_manager

    Status manager is an interface where you are able to see the progress or the status of your project.