PowerPhotos Help

AppleScript Command - export

Export photos or albums to a folder on disk.

When the using preset parameter is specified, the preset’s saved settings are used and all other optional parameters are ignored. When using preset is omitted, the user’s last configured export settings are used as defaults, and any explicitly specified parameters override those defaults.

Syntax

export <photos or albums> to <folder> [with various options]

Parameters

Parameter	Type	Required	Description
direct parameter	list of photo or album	yes	The photos or albums to export.
to	file	yes	The destination folder.
folder organization	folder organization	no	How to organize exported files into subfolders.
file naming	file naming	no	How to name exported files.
file naming prefix	text	no	A prefix to use when naming exported files sequentially.
file creation date	file date	no	What to set the exported file’s creation date to.
file modification date	file date	no	What to set the exported file’s modification date to.
export type	export type	no	Which version of each photo to export (original or edited).
quality	quality	no	The quality level for compressible formats like JPG and HEIC.
format	format	no	The image format for exported files.
fallback format	fallback format	no	The fallback format when exporting with Match Original and the original format cannot be exported.
when file exists	when file exists	no	What to do when a file with the same name already exists.
resizing	resizing	no	How to size the exported photos.
maximum size	integer	no	The maximum size in pixels when resizing is enabled.
preserve date	boolean	no	Include the photo’s date in its EXIF metadata.
preserve keywords	boolean	no	Include the photo’s keywords in its EXIF metadata.
preserve title	boolean	no	Include the photo’s title in its EXIF metadata.
preserve caption	boolean	no	Include the photo’s caption in its EXIF metadata.
preserve location	boolean	no	Include the photo’s location in its EXIF metadata.
video quality	video quality	no	The encoding to use for exported videos.
include bursts	boolean	no	Include all photos in a burst.
include Live Photos	boolean	no	Include videos for Live Photos.
album linking	album linking	no	When exporting multiple albums, how to handle photos appearing in more than one album.
using preset	export preset	no	A saved export preset to use. When specified, other parameters are ignored.

Result

None.

Example

-- Export with specific settings
tell application "PowerPhotos"
	set theLibrary to first library whose name is "Main Library"
	set favAlbum to first album of theLibrary whose name is "Favorites"
	set exportFolder to POSIX file "/Users/me/Desktop/Exported Photos"

	export (every photo of favAlbum) to exportFolder ¬
		export type edited ¬
		format JPG ¬
		quality high ¬
		preserve keywords true ¬
		preserve location true ¬
		include Live Photos true
end tell

You can also use a saved export preset, which applies all the settings you configured in the PowerPhotos app:

-- Export using a saved preset
tell application "PowerPhotos"
	set theLibrary to first library whose name is "Main Library"
	set theAlbum to first album of theLibrary whose name is "Portfolio"
	set exportFolder to POSIX file "/Users/me/Desktop/Portfolio Export"
	set thePreset to first export preset whose name is "Web Upload"

	export (every photo of theAlbum) to exportFolder using preset thePreset
end tell