AppleScript Reference - Enumerations

These are the enumeration types used as parameter values in PowerPhotos AppleScript commands and properties. Each enumeration defines a set of named constants that can be passed to specific command parameters or read from object properties.

album type

The type of an album in a photo library.

Value	Description
library	The main Library album containing all the photos in the library
favorites	The user’s favorite photos
my albums	The main albums folder
regular	A regular album created by the user
smart	A custom smart album created by the user
folder	A folder created by the user
media types	The folder containing all the special media type albums
videos	The Videos media type album
selfies	The Selfies media type album
live photos	The Live Photos media type album
panoramas	The Panoramas media type album
portrait	The Portrait media type album
time-lapse	The Time-lapse media type album
slo-mo	The Slo-mo media type album
bursts	The Bursts media type album
screenshots	The Screenshots media type album
animated	The Animated media type album
RAW	The RAW media type album

album linking

Specifies how exported photo files are linked to the originals when exporting albums.

Value	Description
separate copies	Create separate copies of each photo.
hard link	Create hard links to save disk space (same filesystem only).
symbolic link	Create symbolic links (fragile if source moves).
file clone	Create file clones to save space (APFS only).

folder organization

Controls how exported photos are organized into folders.

Value	Description
flat folder	Export all photos to a single flat folder with no subfolders.
album hierarchy	Create subfolders based on the hierarchy of the albums being exported.

file naming

Controls how exported photo files are named.

Value	Description
title	Use each photo’s title as its filename.
filename	Use the photo’s original imported filename.
sequential	Name the exported files sequentially.

when file exists

Specifies what to do when an exported file already exists at the destination.

Value	Description
rename	Append a number to the exported photo’s name.
replace	Replace the existing file with the newly exported photo.
skip	Skip exporting the photo and keep the existing file instead.

file date

Controls the file date assigned to exported photos.

Value	Description
export date	Use the date the photos are being exported (today).
photo date	Use the date the photo was taken or modified.

export type

Specifies which version of a photo to export.

Value	Description
original	Export the unmodified original photo.
edited	Export the edited version of the photo.

quality

The JPEG compression quality level for exported photos.

Value	Description
low	Lowest quality (smallest file size)
medium	Medium quality (balanced quality vs. size)
high	High quality (larger file size, good quality)
maximum	Maximum quality (largest file size)

format

The image format for exported photos.

Value	Description
JPG	JPG
HEIF	HEIF
PNG	PNG
TIFF	TIFF
Match Original	Match the original format of each photo

fallback format

The format to use when the original format cannot be converted to the requested format.

Value	Description
Unmodified Original	Export the unmodified original file without conversion
JPG	Convert to JPG
HEIF	Convert to HEIF
PNG	Convert to PNG
TIFF	Convert to TIFF

resizing

Controls how exported photos are resized.

Value	Description
full size	Export at the photo’s original size
max width	Resize each photo to a given maximum width.
max height	Resize each photo to a given maximum height.
max dimension	Resize each photo so its largest dimension is a given maximum size.

video quality

The encoding quality for exported videos.

Value	Description
480p	H.264 at 480p
720p	H.264 at 720p
1080p	H.264 at 1080p
4K	H.264 at 4K
HEVC 1080p	H.265 at 1080p
HEVC 4K	H.265 at 4K