Project

Properties

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

Static Methods

createProject

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Project

Create a new project

Parameters

Name
Type
Description
path
string
-

getActiveProject

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Project

Currently active project.

getProject

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Project

Get project referenced by given UID

Parameters

Name
Type
Description
projectGuid
Guid
-

isProject

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

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

Parameters

Name
Type
Description
projectPath
string
-

open

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Project

Open a project

Parameters

Name
Type
Description
path
string
-
openProjectOptions
OpenProjectOptions
-

Instance Methods

close

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Close a project

Parameters

Name
Type
Description
closeProjectOptions
CloseProjectOptions
-

closeSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Close a sequence and return true if successful.

Parameters

Name
Type
Description
sequence
Sequence
-

createSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Sequence

Create a new sequence using the default preset path.

Note: The presetPath parameter is deprecated. Use createSequenceWithPresetPath() instead.

Parameters

Name
Type
Description
name
string
-
presetPath
string
-

createSequenceFromMedia

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Sequence

Create a new sequence with a given name and medias

Parameters

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

deleteSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Delete a given sequence from the project

Parameters

Name
Type
Description
sequence
Sequence
-

executeTransaction

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Execute undoable transaction by passing compound action

Parameters

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

getActiveSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Sequence

Get the active sequence of the project

getColorSettings

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

ProjectColorSettings

Get project color settings object

getInsertionBin

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

ProjectItem

Get current insertion bin

getRootItem

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

FolderItem

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

getSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Sequence

Get sequence by id from the project

Parameters

Name
Type
Description
guid
Guid
-

getSequences

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

Sequence[]

Get an array of all sequences in this project.

importAEComps

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Parameters

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

importAllAEComps

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Parameters

Name
Type
Description
aepPath
string
-
TargetBin
ProjectItem
-

importFiles

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Import files in root/target bin of the project

Parameters

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

importSequences

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Parameters

Name
Type
Description
projectPath
string
-
sequenceIds
Guid[]
-

lockedAccess

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

void

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.

Parameters

Name
Type
Description
callback
() => void
-

openSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Open a sequence and return true if successful.

Parameters

Name
Type
Description
sequence
Sequence
-

pauseGrowing

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Pause growing of files instead swap the files

Parameters

Name
Type
Description
pause
boolean
-

save

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Save the project

saveAs

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Save the project at the provided path

Parameters

Name
Type
Description
path
string
-

setActiveSequence

<span class="minversion" style="display: block; margin-bottom: -1em; margin-left: 36em; float:left; opacity:0.5;">25.0</span>

boolean

Set the active sequence of the project

Parameters

Name
Type
Description
sequence
Sequence
-