In this guide
Mac
Wake, lock, screenshot and press keys on your Mac from Apple Shortcuts on your iPhone. Nothing to install on the Mac.
What you can do #
The Mac integration signs in to your Mac over SSH, the secure connection macOS uses for Remote Login, and runs tools that come with macOS. There is no helper app to install. Your iPhone and Mac need to be on the same network, such as your home Wi-Fi.
You can wake the display, sleep the Mac, lock it, take a screenshot or a short screen recording, press keys in an app you choose, copy a file from Shortcuts onto the Mac, and type your password at the login screen. Screenshots and recordings come back to your shortcut as a File, ready to save, share or send.
Connect Mac #
- On your Mac, open System Settings → General → Sharing and turn on Remote Login. Select the ⓘ button next to it: the window shows the Mac’s address, such as MacBook.local, and which users may sign in.
- In Shortcutify, open Services → Mac and tap Add a Mac. Enter the Mac’s address and your Mac user name. Give it a Name if you will add more than one Mac. Leave Port empty.
- Under Sign In, choose Password and enter your Mac login password, or choose Key to sign in without one (see below).
- Tap Connect. When iPhone asks to find devices on your local network, tap Allow. You see Connected to and your Mac’s name when it works.
- Under Permissions on the Mac, tap Accessibility and Screen Recording to check them. Checking also asks the Mac for the permission, so the first check often fails. Allow it on the Mac (see “Mac permissions” below), then tap Check Again.
Choose Key, then Make a Key on This iPhone. Shortcutify shows a line under Run once in Terminal on your Mac. Tap it to copy it, run it once in Terminal on the Mac, then tap Connect. The private key never leaves your iPhone, and your Mac password is not stored. You can also choose Paste a Private Key if you already have one in OpenSSH format.
The first time Shortcutify connects, it remembers the Mac’s identity, shown under Server Identity. If a different computer later answers at the same address, actions stop instead of signing in to it. Use Forget Server Identity only after replacing or reinstalling the Mac.
Example: send yourself a screenshot of your Mac #
- In Actions, tap +, choose Mac, then Wake.
- Tap Add Step, choose Mac, then Capture Screenshot. The action now wakes the display first, so the picture is not black.
- Check that Output shows Shortcuts Type: File. Tap Run Test to see the screenshot, then name and save the action.
- In Apple Shortcuts, add Execute Action and choose the saved action. Add a block such as Save to Photo Album or Send Message. Tap the Execute Action result in that block and choose File. Without that, the block gets only the screenshot’s name and size as text.
Keystrokes and Wake and Log In need Accessibility. Screenshots and recordings need Screen Recording. When you check one, the Mac may show a prompt: allow it, then tap Check Again in Shortcutify. If there is no prompt, open System Settings → Privacy & Security on the Mac, choose Accessibility or Screen & System Audio Recording, and turn on sshd-keygen-wrapper, the entry for remote sessions. If it isn’t in the list, click +, press Command-Shift-G, enter /usr/libexec/sshd-keygen-wrapper, and add it.
Choose the right task #
Several Macs
Tap Add a Mac again for each Mac, and give each a Name. When you choose a Mac action, pick the Mac at the top of the list. Each step remembers its Mac; change it with the Mac row in the step. A step whose Mac you removed stops and asks you to choose another.
Wake and Log In
Wakes the display, then types the Password you give it and presses Return, as if you were at the keyboard. Needs Accessibility. It types wherever the keyboard is on the Mac: if the Mac is already awake and unlocked, your password goes into whatever is open, such as a chat, followed by Return, which sends it. Run it only when the Mac is at its lock screen. The Password field is masked, and Logs never show the password. It is saved in the action unless you bind it to a Shortcuts input or choose Ask, so it is asked for on each run.
Trigger Keyboard Shortcut
Choose an Application from the list of apps on your Mac, add Modifiers such as Command or Shift, and enter Keys. Keys can be a letter, a few words to type, or one special key by name: Return, Space, Tab, Escape, Delete, Left Arrow, Right Arrow, Up Arrow or Down Arrow. For example, Music with Keys Space plays or pauses.
Capture Screen Video
Records the whole screen for the number of Seconds you choose and returns a .mov File. Shortcuts gives an action about half a minute, so keep recordings short when you run them from a shortcut.
Lock Screen, Sleep and Wake
Lock Screen turns the display off. The Mac locks if System Settings → Lock Screen asks for a password when the display turns off. Sleep puts the whole Mac to sleep. Wake turns the display on.
Upload File
Copies a file from your shortcut onto the Mac. Bind File to File 1 in Execute Action. A Destination ending in / is a folder, such as ~/Desktop/, and the file keeps its own name there. A file with the same name is replaced.
If something does not work #
Shortcutify can’t reach my Mac
Check that Remote Login is on, that the address matches the one shown in Sharing, and that your iPhone is on the same network as the Mac. If you denied local network access, allow it in the iPhone’s Settings → Privacy & Security → Local Network → Shortcutify. To reach your Mac away from home, use a VPN such as Tailscale and enter the Mac’s Tailscale name as the address.
The Mac refused to sign me in
Check the user name and password. The user name is your Mac account name, shown in the Remote Login window, not your Apple Account email. If you use a key, run the Terminal line again on the Mac.
My shortcut gets a name and size instead of the picture
The result is shown as text by default, and for a file that text is its name and size. In Shortcuts, tap the Execute Action result where you use it, such as in the next block, and choose File. The screenshot or recording is attached there.
A screenshot comes back black
The display was asleep or the screen was locked. Add a Wake step first. A locked Mac shows its lock screen in the picture.
Keys or screenshots fail with a permission message
Allow the permission the message names on the Mac, as described under Mac permissions, then run the action again. If the Mac shows a prompt while the action waits, Shortcutify stops after 30 seconds; allow the prompt and run it again.
Screen Recording stays red and the Mac never asks
macOS doesn’t always prompt for remote sessions. Add the entry yourself: in System Settings → Privacy & Security → Screen & System Audio Recording, click +, press Command-Shift-G, enter /usr/libexec/sshd-keygen-wrapper, add it and make sure it’s on. Then tap Check Again.
My Mac is asleep and doesn’t answer
A sleeping Mac answers only when it can wake for network access. Turn on Wake for network access in the Mac’s Energy or Battery settings. It works best on power.
My key is refused
Use Make a Key on This iPhone. It makes an Ed25519 key, which current Macs accept. Pasted RSA keys are refused by current versions of macOS, because Shortcutify signs them in an older way.
It says the Mac answered with a different identity
The computer at that address isn’t the one Shortcutify first connected to. If you replaced or reinstalled your Mac, open Services → Mac, choose that Mac, and tap Forget Server Identity, then Save and Test. Otherwise, don’t connect.
All Mac actions #
These are the actions available in the app’s request picker. Open one for its inputs, returned fields, and permissions.
Wake and Log In
Wake the Mac and type your password at the login screen.
Capture Screenshot
A picture of the Mac's screen, as a file.
Trigger Keyboard Shortcut
Press keys on the Mac, in an app you choose.
Lock Screen
Turn the display off, which locks the Mac.
Wake
Wake the Mac's display.
Sleep
Put the Mac to sleep.
Capture Screen Video
Record the Mac's screen for some seconds, as a file.
Upload File
Put a file from Shortcuts on your Mac.
List Applications
The apps on the Mac, by name.
Service setup references #
The service controls its account requirements and permissions. These references explain its setup in more detail.