A Script For Adding Borders and Captions To Photos

Want to know more about how to use Automator on your Mac?
Check out this MacMost course!

You can also watch this video at YouTube (but with ads).

Here’s the script:

// remember the Photos app
var photosApp = Application.currentApplication();

// get Pixelmator Pro
var pixelmatorPro = Application("Pixelmator Pro");
pixelmatorPro.includeStandardAdditions = true;

var currentlyOpenedDocuments = pixelmatorPro.documents.length;

// send the keystroke to launch the external editor
var seApp = Application('System Events');
seApp.keystroke('\r', { using: 'command down' });

// wait for the document to open
while (true) {
	if (pixelmatorPro.documents.length > currentlyOpenedDocuments) break;
	delay(0.1);
}

// prompt for the caption
var inputDialog = pixelmatorPro.displayDialog('Caption?', {defaultAnswer: "Test Caption"});
var captionText = inputDialog.textReturned;

// get variables and calculate new size
var borderWidth = 20;
var doc = pixelmatorPro.documents[0];
var photo = doc.layers()[0]
var photoWidth = photo.width();
var photoHeight = photo.height();
var newWidth = photoWidth + borderWidth*2;
var newHeight = photoHeight + borderWidth*2;

// resize the document, adding room for a border
doc.resizeCanvas({width: newWidth, height: newHeight});

// add rectangle behind photo for border
var borderLayer = pixelmatorPro.RectangleShapeLayer({width: newWidth, height: newHeight});
doc.layers.push(borderLayer);
borderLayer.styles.fillColor = [0,0,0];

// create a text caption
var captionLayer = pixelmatorPro.TextLayer({textContent: captionText});
doc.layers.unshift(captionLayer);

// set the font, color an size of text
var captionContent = captionLayer.textContent;
captionContent.font = "Gill Sans";
captionContent.color = [65535,65535,65535];
captionContent.size = photoWidth/20;

// position the caption to the lower left
captionLayer.position = {"x":borderWidth + photoWidth * 0.01, "y":(newHeight - borderWidth - captionLayer.height())};

// add an outline and shadow to the caption
captionLayer.styles.strokeWidth = 2;
captionLayer.styles.strokeColor = [0,0,0];
captionLayer.styles.shadowDistance = 0;
captionLayer.styles.shadowAngle = 315;
captionLayer.styles.shadowOpacity = 100;

// save and close, waiting a little before closing
seApp.keystroke('s', { using: 'command down' });
delay(2);
seApp.keystroke('w', { using: 'command down' });

// go back to the Photos app
photosApp.activate();