Installing USD Manager

USD Manager has primarily been developed for and tested on Linux. While the basics should work on other platforms, they have not been as heavily tested. Notes to help with installation on specific operating systems can be added here.

These steps provide an example only and may need to be modified based on your specific setup and needs.


  • Install Python 2 (
    • Windows: Ensure the install location is part of your PATH variable (newer installs should have an option for this)
  • Install one of the recommended Python Qt bindings
    • Python 2: PyQt4 or PySide

Install with

For a site-wide install, try:

python install

For a personal install, try:

python install --user

Studios with significant python codebases or non-trivial installs may need to customize

Your PATH and PYTHONPATH will need to be set appropriately to launch usdmanager, and this will depend on your install settings.

OS Specific Notes


Known Issues

  • Print server may not recognize network printers.

Mac (OSX)

Known Issues

  • User preferences may not preserve between sessions.
  • Since this is not installed as an entirely self-contained package, the application name (and icon) will by Python, not USD Manager.



  1. Launch Command Prompt
  2. cd to the downloaded usdmanager folder (you should see a file in here).
  3. Run python install (may need the --user flag)

If complains about missing setuptools, you can install it via pip. If you installed a new enough python-2 version, pip should already be handled for you, but you may still need to add it to your PATH. pip should already live somewhere like this (C:\Python27\Scripts\pip.exe), and you can permanently add it to your environment with: setx PATH "%PATH%;C:\Python27\Scripts"

  1. Upgrade pip if needed
  2. Launch Command Prompt in Administrator mode
  3. Run pip install pip --upgrade (may need the --user flag)
  4. Install setuptools if needed
  5. Run pip install setuptools
  6. Re-run the step above for usdmanager
  7. If you don’t modify your path, you should now be able to run something like this to launch the program: python C:\Python27\Scripts\usdmanager

Known Issues

  • Drive letter may show doubled-up in address bar (e.g. C:C:/my_file.txt)

Common Problems

  • Missing icons (may still be missing some even after this!)
    • pip install django-crystal-small (this also installs django by default, which you may not want)
    • Add installed path to your downloaded usdmanager/config.json file, then re-run the install. You’ll need a line similar to this in your config.json: "themeSearchPaths": ["C:\\Python27\\Lib\\site-packages\\django_crystal_small\\static\\crystal"]
  • Can’t open files in external text editor
    • In Preferences, try setting your default text editor
    • Windows: Try notepad.exe or "C:\Windows\notepad.exe" (including the quotation marks)