Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 3.8 KB

installation.md

File metadata and controls

87 lines (65 loc) · 3.8 KB

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.

Contents

Prerequisites

  • Install Python 2 (https://www.python.org/downloads/)
    • 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 setup.py

For a site-wide install, try:

python setup.py install

For a personal install, try:

python setup.py install --user

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

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

OS Specific Notes

Linux

Known Issues

  • Print server may not recognize network printers.

Mac (OSX)

Installation

  1. Launch Terminal
  2. cd to the downloaded usdmanager folder (you should see a setup.py file in here).
  3. Customize usdmanager/config.json if needed.
  4. Run python setup.py install (may need to prepend the command with sudo and/or add the --user flag)
  5. Depending on where you installed it (e.g. /Users/username/Library/Python/3.7/bin), update your $PATH to include the relevant bin directory by editing /etc/paths or ~/.zshrc.

Known Issues

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

Windows

Installation

  1. Launch Command Prompt
  2. cd to the downloaded usdmanager folder (you should see a setup.py file in here).
  3. Customize usdmanager/config.json if needed.
  4. Run python setup.py install (may need the --user flag)

If setup.py 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 setup.py 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 setup.py 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)