Project

Since: 25.6

Properties

Name
Type
Access
Min Version
Description
guid
Guid
R
25.6
The unique identifier of the project.
name
string
R
25.6
The project name.
path
string
R
25.6
The absolute file path to the project file.

Static Methods

createProject

Create a new project

Since: 25.6

Returns: Promise<Project>

Parameters

Name
Type
Description
path
string
-

getActiveProject

Currently active project.

Since: 25.6

Returns: Promise<Project>

getProject

Get project referenced by given UID

Since: 25.6

Returns: Project

Parameters

Name
Type
Description
projectGuid
Guid
-

isProject

Returns true if the file at the given path is openable as a Premiere project

Since: 26.2

Returns: boolean

Parameters

Name
Type
Description
projectPath
string
-

open

Open a project

Since: 25.6

Returns: Promise<Project>

Parameters

Name
Type
Description
path
string
-
openProjectOptions
OpenProjectOptions
-

Instance Methods

close

Close a project

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
closeProjectOptions
CloseProjectOptions
-

closeSequence

Close a sequence and return true if successful.

Since: 26.2

Returns: Promise<boolean>

Parameters

Name
Type
Description
sequence
Sequence
-

createSequence

Create a new sequence with the default preset path - Parameter presetPath is deprecated, instead use createSequenceWithPresetPath()

Since: 25.6

Returns: Promise<Sequence>

Parameters

Name
Type
Description
name
string
-
presetPath
string
-

createSequenceFromMedia

Create a new sequence with a given name and media

Since: 25.6

Returns: Promise<Sequence>

Parameters

Name
Type
Description
name
string
-
clipProjectItems
ClipProjectItem[]
-
targetBin
ProjectItem
-

createSequenceWithPresetPath

Create a new sequence with a preset path

Since: 26.3

Returns: Promise<Sequence>

Parameters

Name
Type
Description
name
string
-
presetPath
string
-

deleteSequence

Delete a given sequence from the project

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
sequence
Sequence
-

executeTransaction

Execute undoable transaction by passing compound action

Since: 25.6

Returns: boolean

Parameters

Name
Type
Description
callback
(compoundAction: CompoundAction) => void
-
undoString?
string
-

getActiveSequence

Get the active sequence of the project

Since: 25.6

Returns: Promise<Sequence>

getColorSettings

Get project color settings object

Since: 25.6

Returns: Promise<ProjectColorSettings>

getInsertionBin

Get current insertion bin

Since: 25.6

Returns: Promise<ProjectItem>

getRootItem

The root item of the project which contains all items of the project on the lowest level.

Since: 25.6

Returns: Promise<FolderItem>

getSequence

Get sequence by id from the project

Since: 25.6

Returns: Sequence

Parameters

Name
Type
Description
guid
Guid
-

getSequences

Get an array of all sequences in this project.

Since: 25.6

Returns: Promise<Sequence[]>

importAEComps

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
aepPath
string
-
compNames
string[]
-
targetBin
ProjectItem
-

importAllAEComps

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
aepPath
string
-
targetBin
ProjectItem
-

importFiles

Import files in root/target bin of the project

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
filePaths
string[]
-
suppressUI
boolean
-
targetBin
ProjectItem
-
asNumberedStills
boolean
-

importSequences

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
projectPath
string
-
sequenceIds
Guid[]
-

lockedAccess

Get a read/upgrade locked access to Project, project state will not change during the execution of callback function. Can call executeTransaction while having locked access.

Since: 25.6

Returns: void

Parameters

Name
Type
Description
callback
() => void
-

openSequence

Open a sequence and return true if successful.

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
sequence
Sequence
-

pauseGrowing

Pauses or resumes monitoring of actively-captured (growing) media files in the project. When paused, Premiere stops refreshing clips whose source files are still being written to disk, allowing stable playback at the current captured duration. Pass true to pause, false to resume.

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
pause
boolean
-

save

Save the project

Since: 25.6

Returns: Promise<boolean>

saveAs

Save the project at the provided path

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
path
string
-

setActiveSequence

Set the active sequence of the project

Since: 25.6

Returns: Promise<boolean>

Parameters

Name
Type
Description
sequence
Sequence
-