AppleScript

PowerPhotos provides a full AppleScript dictionary that lets you script nearly every aspect of managing your photo libraries. You can use AppleScript to browse libraries and albums, read and modify photo metadata, copy and move photos between libraries, export photos, merge libraries, and more.

To explore PowerPhotos’s AppleScript dictionary, open Script Editor (located in /Applications/Utilities/), then choose File > Open Dictionary and select PowerPhotos from the list. This will show you all of the available classes, commands, and properties that you can use in your scripts. You can also write and run scripts directly in Script Editor to test them out.

For more information about writing AppleScripts, see Apple’s AppleScript Language Guide and the Mac Automation Scripting Guide.

Data model objects

These are the main objects you work with when scripting PowerPhotos.

Object	Description
application	The top-level scripting object representing the PowerPhotos app.
window	An open window in PowerPhotos.
library	A Photos library in PowerPhotos.
library group	A group of libraries in the library list.
album	An album, smart album, or folder in a library.
photo	A photo or video in a library.
export preset	A saved export preset that defines export settings.

Standard Suite commands

These are standard commands that PowerPhotos supports.

Command	Description
count	Return the number of elements of a particular class within an object.
delete	Delete an object such as a library, album, or photo.
exists	Verify that an object exists.
make	Create a new object such as a library, album, or folder.
move	Move photos or albums to a different library.

PowerPhotos Suite commands

These are commands specific to PowerPhotos.

Command	Description
add	Add photos to an album.
remove	Remove photos from an album.
merge	Merge multiple libraries into one.
duplicate	Copy albums or photos to another library.
import	Import files and folders into a library.
export	Export photos or albums to a folder on disk.

Enumerations

PowerPhotos defines several enumerations used as parameter values in commands and properties. See the enumerations reference for a complete list.