Tools reference

Project Management

Open, save, and configure projects. Import footage. Manage the project panel and handle missing or duplicate assets.

Project file

new_project

Create a new empty After Effects project.

open_project

Open an existing .aep or .aepx project file from disk.

save_project

Save the current project to its existing file path.

save_project_as

Save the current project to a new file path.

close_project

Close the current project, optionally saving first.

project_info

Get basic info about the current project: name, path, items, and unsaved changes.

get_project_settings

Get the current project settings: color depth, working color space, renderer.

set_project_settings

Update project settings: display style, auto-save, expression engine.

set_project_color_settings

Set the project color management settings: working space, bit depth, linearization.

Import

import_file

Import a single file (video, image, audio, AEP) into the project panel.

import_folder

Import all supported media files from a folder.

import_sequence

Import an image sequence as a single footage item.

import_solid

Create a solid footage item in the project (without adding it to a comp).

import_placeholder

Create a placeholder footage item for footage not yet available.

Project panel

find_project_items

Search project items by name, type, or comment.

list_project_items

List all items in the project panel: footage, comps, and folders.

rename_item

Rename a project item.

delete_items

Delete one or more project items.

duplicate_item

Duplicate a project item (comp or footage).

move_items_to_folder

Move project items into a folder in the project panel.

create_folder

Create a new folder in the project panel.

set_item_comment

Set the comment on a project item.

set_item_label

Set the label color of a project item.

Footage & asset management

collect_files

Collect all project assets into a single folder (like 'File > Collect Files').

reduce_project

Remove all unused footage and comps from the project.

collect_asset_report

Generate a report of all assets used in the project with their paths and status.

list_missing_footage

List all footage items with missing or offline files.

relink_missing_footage

Relink a missing footage item to a new file path.

replace_footage

Replace a footage item with a different file.

batch_replace_footage

Replace multiple footage items in one call, matching by name or path pattern.

consolidate_footage

Remove duplicate footage items, keeping one reference.

interpret_footage

Set the interpretation settings for a footage item: frame rate, loop, start frame.

set_footage_color_profile

Assign a color profile to a footage item for color management.

set_alpha_mode

Set the alpha interpretation of a footage item: ignore, straight, premultiplied.

set_footage_fields

Set field separation settings on interlaced footage.

set_footage_loop

Set the loop count for a footage item.

set_footage_pixel_aspect

Override the pixel aspect ratio of a footage item.

set_proxy

Assign a proxy file to a footage item.

clear_proxy

Remove the proxy from a footage item.