Parsers¶

Main Entry Point¶

parse ¶

parse(
    aep_file_path: str | PathLike[str],
    *,
    ae_preferences_dir: str | PathLike[str] | None = None,
) -> Application

Parse an After Effects (.aep) project file and return an Application instance.

This is the main entry point for the library. It parses the binary RIFX data and returns an Application object whose project attribute holds the full project tree.

Parameters:

aep_file_path (str | PathLike[str]) –

Path to the .aep file.
ae_preferences_dir (str | PathLike[str] | None, default: None ) –

Optional path to the AE preferences directory (e.g. C:/Users/<user>/AppData/Roaming/Adobe/After Effects/25.6). When provided, render settings and output module templates are parsed lazily when needed.

Example

import py_aep

app = py_aep.parse("project.aep")
project = app.project
print(app.version)