Skip to content

API Reference

The public entry point:

Parse a .prproj file and return an Application object.

preferences_path optionally points at a Premiere Adobe Premiere Pro Prefs file to read machine defaults from (import label/still-duration defaults). When omitted, the most recently used profile under ~/Documents/Adobe/Premiere Pro/ is used, or factory constants on a machine Premiere never ran on.

Source code in src/py_premiere/__init__.py
def parse(
    path: str | Path,
    *,
    preferences_path: str | Path | None = None,
) -> Application:
    """Parse a `.prproj` file and return an `Application` object.

    `preferences_path` optionally points at a Premiere `Adobe Premiere Pro
    Prefs` file to read machine defaults from (import label/still-duration
    defaults). When omitted, the most recently used profile under
    `~/Documents/Adobe/Premiere Pro/` is used, or factory constants on a
    machine Premiere never ran on.
    """
    path = Path(path)
    application = parse_application(parse_prproj(path), path)
    if preferences_path is not None:
        application.project._preferences_path = Path(preferences_path)
    return application

Models mirror the Premiere Scripting Guide object model: Application > Project > ProjectItem tree and Sequence > Track > TrackItem, with Time as the time value object.