- Substance 3D home
- Home
- Command Line Tools
- Command Line overview
- sbsbaker
- sbscooker
- sbsmtools
- sbsmutator
- sbsrender
- sbsupdater
- Command Line overview
- Pysbs - Python API
- Pysbs - Python API overview
- Getting started
- General topics
- Examples
- API Content
- API Content overview
- Substance definitions
- Common interfaces
- compnode
- context projectmgr
- graph
- mdl
- modelgraphindex
- modelannotationnames
- modelgraph
- modelgraphgenerator
- modelgraphimplementation
- modelnodenames
- modeloperand
- modulegraphindex
- moduleannotation
- moduleconnection
- modulegraph
- modulegraphgenerator
- modulegraphimplementation
- modulegraphlibrary
- modulegraphregister
- modulenode
- modulenodeimplementation
- modulenodeinstance
- moduleoperand
- moduleoutputbridging
- moduleparaminput
- params
- projectmgrdoc
- sbsarchive
- sbscommon
- sbspreset
- sbsproject
- substance
- Libraries
- sbsenum
- sbslibrary
- sbsbakerslibrary
- Helpers
- Execution context
- API Change log
- Samples
- Setup and Getting Started
- Integrations
- Substance Maya toolset
- Changelog overview
Setup and Getting Started
Windows
Legacy substance3d
From legacy substance3d the package is an executable, .exe.
By default, the installer will install the batch tools and the python package to:
C:Program FilesAllegorithmicSubstance Automation Toolkit
The example files will be installed to
C:Users<User>DocumentsSubstance Automation Toolkit
In order to install the python package, run
C:Program FilesAllegorithmicSubstance Automation ToolkitPython APIpysbs.<version>.bat
Enterprise Admin Console
The package is a .zip archive that can be downloaded by your administrator via the Package > Tools section of the Admin Console.
This archive can be uncompressed anywhere however its location should be set as a value in the SAT_INSTALL_PATH environment variable.
It will use the pip package system for the python version that is in the path. For more control, you can look at the batch file and edit it to make sure the right python installation is used. This requires python and pip to be in your PATH environment variable. For more details around installing the python API refer to Getting started
In order to learn more about how to use the tools, visit the samples and integration page
MacOSX
By default the installed package will end up in
/Applications/Substance Automation Toolkit/
The example files will be in
/Applications/Substance Automation Toolkit/samples
Since this is an read only location, you ideally want to copy them to your user directory and run them from there
In order to install the python package, refer to Getting started
Linux
The linux package is a tar.gz archive. You can unzip it wherever you find it convenient. Enter this new directory location as a value in the SAT_INSTALL_PATH environment variable.
The samples will be in the "samples" sub directory and the python api in the "Python API" subdirectory.
In order to install the python package, refer to Getting started
Custom installation
For any platform, it's possible to move the installation or extract the SAT package wherever you want. In this case, you must precise the SAT install location with the SAT_INSTALL_PATH environment variable.