COMMENT
Add device frames to screenshots for iPhones (11, 8/SE, and 12-13-14 generations in mini/standard/Plus/Pro Max sizes), iPad Pro (11" and 12.9", 2018-2022 models), iPad Air (10.9", 2020-2022 models), iPad mini (2021 model), Apple Watch S4/5/6/7/8/Ultra, iMac (24" model, 2021), MacBook Air (2020-2022 models), and MacBook Pro (2021 models). The shortcut supports portrait and landscape orientations, but does not support Display Zoom; on iPadOS and macOS, the shortcut supports Default and More Space resolutions. If multiple screenshots are passed as input, they will be combined in a single image. The shortcut can be run in the Shortcuts app, as a Home Screen widget, as a Finder Quick Action, or via the share sheet. The shortcut also supports an API for automating input images and framed results.
COMMENT
Create a control variable that checks if the input is empty or not. We can use this to define how input is passed to the shortcut.
VARIABLES
Set variable
Input to Frames
to
Shortcut Input
COMMENT
Next, check if the input contains an `&command` to skip the final list of actions. To do this, we're going to save this variable for later as a plain text string.
Potential options:
- quickLook
- photos
- quickSave
- copy
- airDrop
- upload
- passthrough
DOCUMENTS
Get text from
Input to Frames
Text
VARIABLES
Set variable
Text Commands in Input
to
Text
COMMENT
📁📁📁
Pick the Files/Finder folder you want to use as the SOURCE of screenshots when framing images via the Apple Frames API.
MISSING
folder Under Construction
VARIABLES
Set variable
Source Folder
to
Folder
COMMENT
📁📁📁
Pick the folder you want to use as the DESTINATION of framed images when saving to Files or Finder.
MISSING
folder Under Construction
VARIABLES
Set variable
Quick Save Folder
to
Folder
TEXT
3.1
Text
VARIABLES
Set variable
Latest Version of Frames
to
Text
URL
https://cdn.macstories.net/frames-1677496110801.zip
URL
VARIABLES
Set variable
Frames CDN URL
to
URL
COMMENT
A variable that controls whether multiple framed screenshots should be merged into a single one or not.
By default, it is set to True, meaning that Apple Frames will merge multiple images into a single one.
DICTIONARY
Dictionary
VARIABLES
Set variable
Merge Images
to
Dictionary
COMMENT
The default is True.
However, users can override this via shortcut input by using: +mergeImages=False
SCRIPTING
If
Text Commands in Input
contains
+mergeImages=False
DICTIONARY
Dictionary
VARIABLES
Set variable
Merge Images
to
Dictionary
SCRIPTING
End If
If Result
COMMENT
Start defining input types for Apple Frames. These are strings of text that are sent to Apple Frames using the 'Run Shortcut' action, and they tell Apple Frames where to get images from. They are a way to automate Apple Frames.
Potential options:
- clipboard: get an image from the system clipboard.
- latest: get the latest screenshot.
- number: pass a numeric value to the shortcut that tells it how many recent screenshots to retrieve.
- capture: tell Apple Frames to capture a screenshot when it runs. Best used on macOS.
- folder: pick all images from a specific folder in Finder or Files.
- pick: pick images manually. This basic command is necessary if you want to use one of the &output modes later.
SCRIPTING
If
Input to Frames
contains
clipboard
SCRIPTING
If
WFInput?
contains
Mac
SCRIPTING
Show alert
⚠️ macOS Issue ⚠️
SCRIPTING
End If
If Result
COMMENT
You passed the clipboard type to Apple Frames. This means you want to get an image from the clipboard.
TEXT
(Image|Photo media)
Text
VARIABLES
Set variable
Clipboard Regex
to
Text
SCRIPTING
Get type of
Clipboard
Type
TEXT
Match
Clipboard Regex
in
Type
Matches
SCRIPTING
If
Matches
has any value
MEDIA
Get images from
Clipboard
Images
VARIABLES
Set variable
Input to Frames
to
Images
SCRIPTING
Otherwise
SCRIPTING
SCRIPTING
Exit shortcut with
Result
SCRIPTING
End If
If Result
SCRIPTING
Otherwise
SCRIPTING
If
Input to Frames
contains
latest
COMMENT
You passed the latest type to the Apple Frames API. This means you want to get the latest screenshot from the Photos app.
PHOTOS
Get the latest
1 screenshot
Latest Screenshots
MEDIA
Get images from
Latest Screenshots
Images
VARIABLES
Set variable
Input to Frames
to
Images
SCRIPTING
Otherwise
SCRIPTING
If
Input to Frames
contains
number
TEXT
Match
number\((\d+)\)
in
Input to Frames
Matches
TEXT
Get
Group At Index
1
in
Matches
Text
NUMBER
Text
Number
PHOTOS
Get the latest
Number
Latest Screenshots
MEDIA
Get images from
Latest Screenshots
Images
VARIABLES
Set variable
Input to Frames
to
Images
SCRIPTING
Otherwise
SCRIPTING
If
Input to Frames
contains
capture
COMMENT
The input command says to capture a screenshot immediately and frame it. This is best used on macOS.
MISSING
takescreenshot Under Construction
MEDIA
Get images from
Screenshot
Images
VARIABLES
Set variable
Input to Frames
to
Images
SCRIPTING
Otherwise
SCRIPTING
If
Input to Frames
contains
pick
DICTIONARY
Dictionary
VARIABLES
Set variable
Input to Frames
to
Dictionary
SCRIPTING
Otherwise
SCRIPTING
If
Input to Frames
contains
folder
MISSING
file.getfoldercontents Under Construction
FILES
Filter
Contents of Folder
Files
MEDIA
Get images from
Files
Images
VARIABLES
Set variable
Input to Frames
to
Images
SCRIPTING
Otherwise
COMMENT
More input conditions here
SCRIPTING
End If
If Result
SCRIPTING
End If
If Result
SCRIPTING
End If
If Result
SCRIPTING
End If
If Result
SCRIPTING
End If
If Result
SCRIPTING
End If
If Result
COMMENT
Type contents of alerts below
TEXT
It looks like the Frames folder for Apple Frames 3.1 is not installed on your device.
You'll have to download this zipped folder ONCE for Apple Frames to work.
Click OK and Shortcuts will download the zipped folder from MacStories.net and take care of installing it for you.
(The download will take a few seconds.)
Text
VARIABLES
Set variable
Setup File Message
to
English Setup File Message
TEXT
The Frames folder has been successfully saved in iCloud Drive/Shortcuts.
There's nothing else you have to do now. Do NOT modify the contents of iCloud Drive/Shortcuts/Frames.
In the future, to install new versions of Apple Frames, you may have to delete the Frames folder and download it again.
But for now: welcome to Apple Frames, and enjoy. ☺
- Federico
Text
VARIABLES
Set variable
Thank You Message
to
Text
COMMENT
Start routine to check for JSON file
DOCUMENTS
File
VARIABLES
Set variable
Frames Dictionary
to
File
SCRIPTING
Count
Items
in
Frames Dictionary
Count
SCRIPTING
If
Count
is
0
COMMENT
Frames.json file is not installed. It needs to be downloaded alomg with the entire folder.
SCRIPTING
NETWORK
Get contents of
Frames CDN URL
Options Under Construction
Contents of URL
VARIABLES
Set variable
Downloaded File
to
Contents of URL
DOCUMENTS
Extract
Downloaded File
Files
DOCUMENTS
Save
Files
Destination Path
/Shortcuts//Frames/Overwrite If File Exists
Saved File
SCRIPTING
Wait
2 seconds
SCRIPTING
DOCUMENTS
File
VARIABLES
Set variable
Frames Dictionary
to
File
SCRIPTING
Otherwise
