5.3 KiB
| id | title | sidebar_label |
|---|---|---|
| admin_openpype_commands | OpenPype Commands Reference | OpenPype Commands |
:::info
You can substitute openpype_console with poetry run python start.py if you want to run it
directly from sources.
:::
:::note
Running OpenPype without any commands will default to tray.
:::
Common arguments
--use-version to specify explicit version to use:
openpype_console --use-version=3.0.0-foo+bar
--use-staging - to use staging versions of OpenPype.
For more information see here.
Commands
| Command | Description | Arguments | | --- | --- |: --- :| | tray | Launch OpenPype Tray. | 📑 | eventserver | This should be ideally used by system service (such as systemd or upstart on linux and window service). | 📑 | | launch | Launch application in Pype environment. | 📑 | | publish | Pype takes JSON from provided path and use it to publish data in it. | 📑 | | extractenvironments | Extract environment variables for entered context to a json file. | 📑 | | run | Execute given python script within OpenPype environment. | 📑 | | projectmanager | Launch Project Manager UI | 📑 | | settings | Open Settings UI | 📑 | | standalonepublisher | Open Standalone Publisher UI | 📑 |
tray arguments
| Argument | Description |
|---|---|
--debug |
print verbose information useful for debugging (works with openpype_console) |
To launch Tray with debugging information:
openpype_console tray --debug
launch arguments
You have to set either proper environment variables to provide URL and credentials or use
option to specify them. If you use --store_credentials provided credentials will be stored for later use.
| Argument | Description |
|---|---|
--debug |
print debug info |
--ftrack-url |
URL to ftrack server (can be set with FTRACK_SERVER) |
--ftrack-user |
user name to log in to ftrack (can be set with FTRACK_API_USER) |
--ftrack-api-key |
ftrack api key (can be set with FTRACK_API_KEY) |
--ftrack-events-path |
path to event server plugins (can be set with FTRACK_EVENTS_PATH) |
--no-stored-credentials |
will use credential specified with options above |
--store-credentials |
will store credentials to file for later use |
--legacy |
run event server without mongo storing |
--clockify-api-key |
Clockify API key (can be set with CLOCKIFY_API_KEY) |
--clockify-workspace |
Clockify workspace (can be set with CLOCKIFY_WORKSPACE) |
To run ftrack event server:
openpype_console eventserver --ftrack-url=<url> --ftrack-user=<user> --ftrack-api-key=<key> --ftrack-events-path=<path> --no-stored-credentials --store-credentials
launch arguments
| Argument | Description |
|---|---|
--app |
Application name - this should be the key for application from Settings. |
--project |
Project name (default taken from AVALON_PROJECT if set) |
--asset |
Asset name (default taken from AVALON_ASSET if set) |
--task |
Task name (default taken from AVALON_TASK is set) |
--tools |
Optional: Additional tools to add |
--user |
Optional: User on behalf to run |
--ftrack-server / -fs |
Optional: Ftrack server URL |
--ftrack-user / -fu |
Optional: Ftrack user |
--ftrack-key / -fk |
Optional: Ftrack API key |
For example to run Python interactive console in Pype context:
pype launch --app python --project my_project --asset my_asset --task my_task
publish arguments
| Argument | Description |
|---|---|
--debug |
print more verbose infomation |
pype publish <PATH_TO_JSON>
extractenvironments arguments
Entered output filepath will be created if does not exists.
All context options must be passed otherwise only openpype's global environments will be extracted.
Context options are project, asset, task, app
| Argument | Description |
|---|---|
output_json_path |
Absolute path to the exported json file |
--project |
Project name |
--asset |
Asset name |
--task |
Task name |
--app |
Application name |
openpype_console /home/openpype/env.json --project Foo --asset Bar --task modeling --app maya-2019
run arguments
| Argument | Description |
| --script | run specified python script |
Note that additional arguments are passed to the script.
openpype_console run --script /foo/bar/baz.py arg1 arg2
projectmanager arguments
projectmanager has no command-line arguments.
openpype_console projectmanager
settings arguments
| Argument | Description |
| -d / --dev | Run settings in developer mode. |
openpypeconsole settings
standalonepublisher arguments
standalonepublisher has no command-line arguments.
openpype_console standalonepublisher