# AWS Deadline Cloud for After Effects
[](https://pypi.python.org/pypi/deadline-cloud-for-after-effects)
[](https://pypi.python.org/pypi/deadline-cloud-for-after-effects)
[](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/mainline/LICENSE)
### Disclaimer
---
This GitHub repository is an example integration with AWS Deadline Cloud that is intended to only be used for testing and is subject to change. This code is an alpha release. It is not a commercial release and may contain bugs, errors, defects, or harmful components. Accordingly, the code in this repository is provided as-is. Use within a production environment is at your own risk!
Our focus is to explore a variety of software applications to ensure we have good coverage across common workflows. We prioritized making this example available earlier to users rather than being feature complete.
This example has been used by at least one internal or external development team to create a series of jobs that successfully rendered. However, your mileage may vary. If you have questions or issues with this example, please start a discussion or cut an issue.
---
AWS Deadline Cloud for After Effects is a package that allows users to create [AWS Deadline Cloud][deadline-cloud] jobs from within After Effects. Using the [Open Job Description (OpenJD) Adaptor Runtime][openjd-adaptor-runtime] this package also provides a command line application that adapts to After Effects' command line interface to support the [OpenJD specification][openjd].
[deadline-cloud]: https://docs.aws.amazon.com/deadline-cloud/latest/userguide/what-is-deadline-cloud.html
[deadline-cloud-client]: https://github.com/aws-deadline/deadline-cloud
[openjd]: https://github.com/OpenJobDescription/openjd-specifications/wiki
[openjd-adaptor-runtime]: https://github.com/OpenJobDescription/openjd-adaptor-runtime-for-python
[openjd-adaptor-runtime-lifecycle]: https://github.com/OpenJobDescription/openjd-adaptor-runtime-for-python/blob/release/README.md#adaptor-lifecycle
## Compatibility
This library requires:
**Submitter:**
1. After Effects 24.3
1. Python3.9 or higher; and
1. Windows or a MacOS operating System
**Adaptor:**
1. After Effects 24.3
1. Python3.9 or higher; and
1. A Windows operating system
## Submitter
This package provides a JavaScript based After Effects plugin that creates jobs for AWS Deadline Cloud using the [AWS Deadline Cloud client library][deadline-cloud-client]. Based on the loaded project it determines the files required, allows the user to specify render options, and builds an [OpenJD template][openjd] that defines the workflow.
## Adaptor
The After Effects Adaptor implements the [OpenJD][openjd-adaptor-runtime] interface that allows render workloads to launch After Effects and feed it commands. This gives the following benefits:
* a standardized render application interface,
* sticky rendering, where the application stays open between tasks,
* See [adaptor IPC](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/docs/adaptor_ipc.md) for more information.
* path mapping, that enables cross-platform rendering
Jobs created by the submitter use this adaptor by default.
## Getting Started
### Adaptor
---
The adaptor can be installed by the standard python packaging mechanisms:
```sh
$ pip install deadline-cloud-for-after-effects
```
After installation it can then be used as a command line tool:
```sh
$ afterfx-openjd --help
```
### Submitter
---
### Build & Install
Bundle the JSX and JS files together with the `jsxbundler.py` script:
```
python jsxbundler.py --source src/deadline/ae_submitter/OpenAESubmitter.jsx --destination dist/jsxbundle/DeadlineCloudSubmitter.jsx
```
This will create a bundle file at `dist/jsxbundle/DeadlineCloudSubmitter.jsx`.
Copy the generated bundle file into the scripts location for After Effects.
Alternatively, you can specify the output path for the bundler directly with the `--destination` option.
See `python jsxbundler.py --help` for details. This may require elevated permissions.
The default scripts location is at `<AE_INSTALL_LOCATION>/Support Files/Scripts`. For example, on Windows this would be: `C:\Program Files\Adobe\Adobe After Effects 2023\Support Files\Scripts`
### Submitter Usage
Before using the script you must configure the following options in After Effects:
Navigate to the `Edit` menu > `Preferences` > `Scripting & Expressions` and enable the following options:
- Allow Scripts to Write Files and Access Network
- Enable JavaScript Debugger (optional, for development)
To run the script:
1. Open an After Effects project.
2. Once inside the project, navigate to the `File` Panel at the top.
3. Under the `Scripts` sub-menu, select the `DeadlineCloudSubmitter.jsx` script to start it.
## Versioning
This package's version follows [Semantic Versioning 2.0](https://semver.org/), but is still considered to be in its
initial development, thus backwards incompatible versions are denoted by minor version bumps. To help illustrate how
versions will increment during this initial development stage, they are described below:
1. The MAJOR version is currently 0, indicating initial development.
2. The MINOR version is currently incremented when backwards incompatible changes are introduced to the public API.
3. The PATCH version is currently incremented when bug fixes or backwards compatible changes are introduced to the public API.
## Security
See [CONTRIBUTING](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/CONTRIBUTING.md#security-issue-notifications) for more information.
## Telemetry
See [telemetry](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/docs/telemetry.md) for more information.
## License
This project is licensed under the Apache-2.0 License.
Raw data
{
"_id": null,
"home_page": null,
"name": "deadline-cloud-for-after-effects",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Amazon Web Services",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b4/1d/2b7dc6df4191f3e0515ad69a6be4479bc225270c3b7ccd11e6030b01e297/deadline_cloud_for_after_effects-0.1.2.tar.gz",
"platform": null,
"description": "# AWS Deadline Cloud for After Effects\n\n[](https://pypi.python.org/pypi/deadline-cloud-for-after-effects)\n[](https://pypi.python.org/pypi/deadline-cloud-for-after-effects)\n[](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/mainline/LICENSE)\n\n### Disclaimer\n---\nThis GitHub repository is an example integration with AWS Deadline Cloud that is intended to only be used for testing and is subject to change. This code is an alpha release. It is not a commercial release and may contain bugs, errors, defects, or harmful components. Accordingly, the code in this repository is provided as-is. Use within a production environment is at your own risk!\n \nOur focus is to explore a variety of software applications to ensure we have good coverage across common workflows. We prioritized making this example available earlier to users rather than being feature complete.\n\nThis example has been used by at least one internal or external development team to create a series of jobs that successfully rendered. However, your mileage may vary. If you have questions or issues with this example, please start a discussion or cut an issue.\n\n---\nAWS Deadline Cloud for After Effects is a package that allows users to create [AWS Deadline Cloud][deadline-cloud] jobs from within After Effects. Using the [Open Job Description (OpenJD) Adaptor Runtime][openjd-adaptor-runtime] this package also provides a command line application that adapts to After Effects' command line interface to support the [OpenJD specification][openjd].\n\n[deadline-cloud]: https://docs.aws.amazon.com/deadline-cloud/latest/userguide/what-is-deadline-cloud.html\n[deadline-cloud-client]: https://github.com/aws-deadline/deadline-cloud\n[openjd]: https://github.com/OpenJobDescription/openjd-specifications/wiki\n[openjd-adaptor-runtime]: https://github.com/OpenJobDescription/openjd-adaptor-runtime-for-python\n[openjd-adaptor-runtime-lifecycle]: https://github.com/OpenJobDescription/openjd-adaptor-runtime-for-python/blob/release/README.md#adaptor-lifecycle\n\n## Compatibility\n\nThis library requires:\n\n**Submitter:**\n1. After Effects 24.3\n1. Python3.9 or higher; and\n1. Windows or a MacOS operating System\n\n**Adaptor:**\n1. After Effects 24.3\n1. Python3.9 or higher; and\n1. A Windows operating system\n\n## Submitter\n\nThis package provides a JavaScript based After Effects plugin that creates jobs for AWS Deadline Cloud using the [AWS Deadline Cloud client library][deadline-cloud-client]. Based on the loaded project it determines the files required, allows the user to specify render options, and builds an [OpenJD template][openjd] that defines the workflow.\n\n## Adaptor\n\nThe After Effects Adaptor implements the [OpenJD][openjd-adaptor-runtime] interface that allows render workloads to launch After Effects and feed it commands. This gives the following benefits:\n* a standardized render application interface,\n* sticky rendering, where the application stays open between tasks,\n * See [adaptor IPC](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/docs/adaptor_ipc.md) for more information.\n* path mapping, that enables cross-platform rendering\n\nJobs created by the submitter use this adaptor by default. \n\n## Getting Started\n\n### Adaptor\n---\nThe adaptor can be installed by the standard python packaging mechanisms:\n```sh\n$ pip install deadline-cloud-for-after-effects\n```\n\nAfter installation it can then be used as a command line tool:\n```sh\n$ afterfx-openjd --help\n```\n### Submitter\n---\n### Build & Install\n\nBundle the JSX and JS files together with the `jsxbundler.py` script:\n\n```\npython jsxbundler.py --source src/deadline/ae_submitter/OpenAESubmitter.jsx --destination dist/jsxbundle/DeadlineCloudSubmitter.jsx\n```\n\nThis will create a bundle file at `dist/jsxbundle/DeadlineCloudSubmitter.jsx`.\nCopy the generated bundle file into the scripts location for After Effects.\n\nAlternatively, you can specify the output path for the bundler directly with the `--destination` option. \nSee `python jsxbundler.py --help` for details. This may require elevated permissions.\n\nThe default scripts location is at `<AE_INSTALL_LOCATION>/Support Files/Scripts`. For example, on Windows this would be: `C:\\Program Files\\Adobe\\Adobe After Effects 2023\\Support Files\\Scripts`\n\n### Submitter Usage\n\nBefore using the script you must configure the following options in After Effects:\n\nNavigate to the `Edit` menu > `Preferences` > `Scripting & Expressions` and enable the following options:\n\n- Allow Scripts to Write Files and Access Network\n- Enable JavaScript Debugger (optional, for development)\n\nTo run the script:\n\n1. Open an After Effects project.\n2. Once inside the project, navigate to the `File` Panel at the top.\n3. Under the `Scripts` sub-menu, select the `DeadlineCloudSubmitter.jsx` script to start it.\n\n## Versioning\n\nThis package's version follows [Semantic Versioning 2.0](https://semver.org/), but is still considered to be in its \ninitial development, thus backwards incompatible versions are denoted by minor version bumps. To help illustrate how\nversions will increment during this initial development stage, they are described below:\n\n1. The MAJOR version is currently 0, indicating initial development. \n2. The MINOR version is currently incremented when backwards incompatible changes are introduced to the public API. \n3. The PATCH version is currently incremented when bug fixes or backwards compatible changes are introduced to the public API. \n\n## Security\n\nSee [CONTRIBUTING](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## Telemetry\n\nSee [telemetry](https://github.com/aws-deadline/deadline-cloud-for-after-effects/blob/release/docs/telemetry.md) for more information.\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n",
"bugtrack_url": null,
"license": null,
"summary": "AWS Deadline Cloud for After Effects",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/aws-deadline/deadline-cloud-for-after-effects",
"Source": "https://github.com/aws-deadline/deadline-cloud-for-after-effects"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4cbf0d327e05020459c75b2c2d6efb7c9ee7a45fe40df2930c0286dee65f4e2e",
"md5": "36560e1f6d6388662279853307bf7f06",
"sha256": "3f3094f60a5bcdcb18ff2715c61e13ec801de118850129eeda33e7c53468c305"
},
"downloads": -1,
"filename": "deadline_cloud_for_after_effects-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "36560e1f6d6388662279853307bf7f06",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 94110,
"upload_time": "2024-05-22T21:37:51",
"upload_time_iso_8601": "2024-05-22T21:37:51.591834Z",
"url": "https://files.pythonhosted.org/packages/4c/bf/0d327e05020459c75b2c2d6efb7c9ee7a45fe40df2930c0286dee65f4e2e/deadline_cloud_for_after_effects-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b41d2b7dc6df4191f3e0515ad69a6be4479bc225270c3b7ccd11e6030b01e297",
"md5": "fb5d1f587c5ab729de3c7f8f3fbb7c25",
"sha256": "7ae02c65fa902000c715f35341145ccc36668f78f0e51ac426b56d0e01c26dee"
},
"downloads": -1,
"filename": "deadline_cloud_for_after_effects-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "fb5d1f587c5ab729de3c7f8f3fbb7c25",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 81984,
"upload_time": "2024-05-22T21:37:52",
"upload_time_iso_8601": "2024-05-22T21:37:52.926631Z",
"url": "https://files.pythonhosted.org/packages/b4/1d/2b7dc6df4191f3e0515ad69a6be4479bc225270c3b7ccd11e6030b01e297/deadline_cloud_for_after_effects-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-22 21:37:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aws-deadline",
"github_project": "deadline-cloud-for-after-effects",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "deadline-cloud-for-after-effects"
}
JSON
