aep-parser 0.6.0

A .aep (After Effects Project) parser

aep_parser

An After Effects file parser in Python!
Explore the docs »

About The Project

This as a .aep (After Effects Project) parser in Python. After Effects files (.aep) are mostly binary files, encoded in RIFX format. This parser uses Kaitai Struct to parse .aep files and return a Project object containing items, layers, effects and properties. The API is as close as possible to the ExtendScript API, with a few nice additions like iterators instead of collection items.

(back to top)

Installation

uv (recommended)

uv add aep-parser

pip

pip install aep-parser

(back to top)

Usage

import aep_parser

app = aep_parser.parse("myproject.aep")
comp = app.project.compositions[0]

# Modify composition settings
comp.frame_rate = 24

# Modify a layer property
comp.layers[0].transform.opacity.value = 50

# Save to a new file
app.save("modified.aep")

For more examples, see the Quick Start guide.

(back to top)

Roadmap

See the open issues for a full list of proposed features and known issues.

If you encounter a bug, please submit an issue and attach a basic scene to reproduce your issue.

(back to top)

Contributing

See the full Contributing Guide on GitHub.

(back to top)

License

Distributed under the MIT License.

(back to top)

Contact

Aurore Delaunay - [e-mail]

(back to top)

Acknowledgments

• aftereffects-aep-parser in Go
• Kaitai Struct
• The invaluable Lottie Docs
• After Effects Scripting Guide
• AE version parsing

(back to top)