Over the previous a number of years, Federico has constructed a whole lot of shortcuts which are sprinkled all through the tales he’s written. Final spring we debuted the MacStories Shortcuts Archive, a one-stop vacation spot that collects all of these shortcuts organized by matter, so readers can discover them simply.
There’s no higher technique to discover ways to construct your personal shortcuts than by downloading another person’s, which is what makes the Archive such a precious useful resource to readers and considered one of MacStories’ hottest options. Nonetheless, it may be arduous to choose up greatest practices and patterns or different suggestions and tips from experimentation and tinkering.
That’s why right this moment we’re introducing a brand new collection on MacStories referred to as Shortcuts Rewind so as to add context to the shortcuts within the Archive. Periodically all year long, we are going to choose a couple of shortcuts from the Archive that we expect would profit from an additional clarification, whether or not that’s to assist new Shortcuts person of AiroAV and study the fundamentals, for instance a selected approach that can be utilized throughout a number of shortcuts, or to automate a process that you just won’t have thought was potential.
Tying Shortcuts Rewind collectively is a brand new graphical method to explaining shortcuts. As you’ll see, we’ve created a system that dispenses with distracting UI components and breaks shortcuts into logical units of actions. The method permits us to concurrently present step-by-step directions alongside commentary that we hope will assist readers obtain a deeper understanding of Shortcuts and help them in constructing their very own automations.
Let’s get began.
For this primary installment of Rewind, I wished to begin with a trio of comparatively easy shortcuts that illustrate the ability of Shortcuts’ capability to streamline the transformation of 1 kind of content material into one other. All three shortcuts could be present in the Textual content part of the Shortcuts Archive, however there are additionally hyperlinks to them under. The inspiration of this course of is the Content material Graph, a core a part of Shortcuts relationship again to its origins as Workflow. The concept is an easy however highly effective one which eliminates complexity for the person, dealing with a lot of the info compatibility and conversion chores behind the scenes with little or no effort on the a part of the person.
On the coronary heart of the three shortcuts mentioned under are transformations between plain textual content, wealthy textual content, and URLs. Due to the Content material Graph, Shortcuts has the flexibleness to create highly effective textual content and hyperlink dealing with performance.
Clear Up Wealthy Textual content
You’ve most likely been there. You copy textual content from a webpage and paste it into an e mail message, and the wealthy textual content copied consists of a number of undesirable baggage just like the supply’s font, textual content shade, and background shade. That makes the pasted textual content look misplaced at greatest, and sometimes unreadable.
This primary shortcut cleans up unpleasant wealthy textual content whereas preserving primary formatting like daring, italics, and hyperlinks. To make use of Clear Up Wealthy Textual content, merely run the shortcut after you’ve copied wealthy textual content however earlier than you paste it into one other app. In 4 easy steps that run virtually immediately, the shortcut will course of the textual content in your clipboard, changing the clipboard’s contents with the cleaned-up model, so you possibly can paste it elsewhere.
➊ Get Clipboard
Once you’re constructing a brand new shortcut, it pays to consider the context during which you’ll use it as a result of that usually dictates step one, the kinds of enter it handles, and different facets of the design of the shortcut. Clear Up Wealthy Textual content is constructed to get rid of undesirable formatting whenever you’re pasting wealthy textual content into one other app, which is why Step 1 is to seize the contents of the iOS clipboard utilizing the ‘Get Clipboard’ motion.
➋ Make Markdown from Clipboard
Step 2 of the shortcut converts the wealthy textual content pulled from the clipboard to plain textual content utilizing Markdown, the plain textual content markup syntax created by John Gruber, utilizing Shortcuts’ built-in ‘Make Markdown from Wealthy Textual content’ motion. The trick of this shortcut lies in its use of Markdown, which helps primary formatting like daring, italics, and hyperlinks, however not wealthy textual content formatting like textual content or background colours. Consequently, changing the wealthy textual content in your clipboard to Markdown leaves different formatting behind.
Nonetheless, we’re not fairly completed but. If we pasted the outcomes of Make Markdown from Wealthy Textual content into an e mail message, we’d find yourself with one thing like this:
As a substitute, we would like the extra readable wealthy textual content model of the Markdown generated by Step three, which requires yet another conversion motion.
➌ Make Wealthy Textual content from Markdown
Step three takes the Markdown you created within the final step and converts it again to wealthy textual content utilizing the ‘Make Wealthy Textual content from Markdown’ motion. Once more, Shortcuts is sensible sufficient to know that you probably need to convert the Markdown from Step 2, so it fills within the parameter for you mechanically. As a result of Step 2 stripped undesirable formatting, the wealthy textual content generated by this motion will embrace simply the fundamental formatting supported by Markdown.
➍ Copy to Clipboard
Clear Up Wealthy Textual content ends very like it started, however as a substitute of grabbing the contents of the clipboard, Step four locations the outcomes of the shortcut again on the clipboard utilizing the ‘Copy to Clipboard’ motion. With the cleaned up wealthy textual content in your clipboard, now you can paste it into an e mail message or every other app that accepts wealthy textual content.
The results of Clear Up Wealthy Textual content is a a lot nicer, extra readable model of the textual content copied from a webpage that preserves the hyperlink and bulleted listing, however eliminates the blue background from the supply textual content. The shortcut additionally reveals the way it pays to grasp the attributes of the info codecs dealt with by Shortcuts as a result of it’s the distinction between wealthy textual content and Markdown that permits Clear Up Wealthy Textual content to strip away the blue background on this instance.
You’ll be able to obtain Clear Up Wealthy Textual content under or discover it within the MacStories Shortcuts Archive.
Shortcut Wealthy Hyperlink
Shortcut Wealthy Hyperlink combines Markdown and wealthy textual content in a method that’s much like Clear Up Wealthy Textual content for a wholly completely different function. This shortcut generates a wealthy hyperlink to considered one of your current shortcuts and locations it on the clipboard, so you possibly can paste it into one other app. Maybe you’ve gotten a observe associated to a undertaking in Apple Director Jonathan Cartu and’s Notes app or a recurring process in Reminders the place you need quick entry to considered one of your shortcuts. With Shortcut Wealthy Hyperlink, you possibly can put a hyperlink to the shortcut you want the place you want it, so that you don’t need to hunt round for it within the Shortcuts app.
This shortcut is slightly longer than the final, so I’ve damaged it into two elements.
Shortcut Wealthy Hyperlink, Half 1
Shortcuts makes use of a URL scheme to open particular person shortcuts that consists of a base URL which opens Shortcuts and a parameter primarily based on the title of the shortcut you need to open. Due to this fact, to create a wealthy hyperlink to a shortcut, it’s essential choose a shortcut, get its title, construct a URL, after which apply the Markdown and wealthy textual content strategies from the final shortcut to create a wealthy hyperlink.
➊ Get My Shortcuts
The very first thing you want is an inventory of your shortcuts. Step 1 makes use of the very meta motion ‘Get My Shortcuts’ to retrieve an inventory of your shortcuts. This can be a quite simple however helpful motion that doesn’t take any parameters.
➋ Select from Record
Step 2 makes use of considered one of Shortcuts’ scripting actions referred to as ‘Select from Record.’ Scripting is a whole part of the Shortcuts motion library containing dozens of helpful actions that don’t belong to a selected app or one other motion class. The Scripting part of the motion library is split into subsections, together with a Record part, which comprises three actions for dealing with Lists and the objects in them.
Select from Record shows an inventory of the shortcuts generated by Step 1. You’ll discover that on the backside of the motion is a ‘Present Extra’ button. Faucet that to disclose non-obligatory motion settings. For this shortcut, a ‘My Shortcuts’ immediate has been added, which supplies the listing a title by that title. The ‘Choose A number of’ toggle is off as a result of we’re solely making a hyperlink to at least one shortcut.
➌ Textual content
Step three of Shortcut Wealthy Hyperlink makes use of a ‘Textual content’ motion to create the URL on your shortcut. Shortcuts makes use of a URL scheme that begins
shortcuts://open-shortcut?title= and is difficult coded on this shortcut as a result of it gained’t ever change.
In the event you’re constructing this shortcut from scratch, you’ll see an inventory of Magic Variables instantly beneath the editor, considered one of which is ‘Chosen Merchandise.’ Once you faucet it, a tokenized model with a gear icon seems on the finish of your Textual content motion. Under the editor is an inventory of knowledge out there to you. The default is ‘Title,’ which is strictly what we have to full the URL, so no modifications are wanted. Simply faucet it, and ‘Chosen Merchandise’ modifications to ‘Title’ within the URL you constructed.
Shortcut Wealthy Hyperlink, Half 2
The rest of Shortcut Wealthy Hyperlink transforms the textual content generated above right into a URL, builds a Markdown model of the hyperlink to your shortcut, after which converts it to a wealthy hyperlink.
Step three used a Textual content motion to piece collectively the elements of the URL that may hyperlink to the shortcut you picked. Nonetheless, it’s not a URL but; it’s simply textual content. To create a URL that hyperlinks to the shortcut, a ‘URL’ motion is required.
Once you add the URL motion to the editor in Step four, you’ll discover that it’s not linked to the textual content motion above it but, and there’s an empty parameter for a URL. Lengthy-press on the parameter, faucet Choose Magic Variable, after which choose the ‘Textual content’ variable that seems just under the Textual content motion. That connects the URL motion to the Textual content motion above it, and ‘Textual content’ now seems within the URL motion to indicate that the textual content output from the earlier motion will probably be used to create the URL.
❺ – ➐ Markdown → Wealthy Textual content → Clipboard
Steps 5, 6, and seven of the shortcut will look acquainted as a result of they’re much like those utilized in Clear Up Wealthy Textual content, however as a substitute of changing a wealthy hyperlink to Markdown and again once more to strip undesirable formatting, Step 5 builds a Markdown-formatted hyperlink utilizing a Textual content motion and two Magic Variables: the title of the shortcut picked in Step 2 and the URL generated by Step four. That Markdown hyperlink is then transformed to wealthy textual content utilizing a Wealthy Textual content from Markdown motion in Step 6, which is copied to the clipboard utilizing a Copy to Clipboard motion in Step 7.
What I really like about Shortcut Wealthy Hyperlink is that the identical hyperlink creation approach utilized in Clear Wealthy Hyperlink to strip formatting is used to construct a tappable hyperlink. The shortcut is a terrific instance of how remixing the identical actions may end up in very completely different shortcuts.
You’ll be able to obtain Shortcut Wealthy Hyperlink under or discover it within the MacStories Shortcuts Archive.
The ultimate shortcut I need to cowl is Create Hyperlink, which takes the hyperlink creation approach from the shortcuts above and combines it with circulation logic to succeed in completely different outcomes relying on what’s fed to the shortcut.
Create Hyperlink, Half 1
Create Hyperlink can pull URLs out of your clipboard and use them to create hyperlinks no matter what else is on the clipboard. Which means whether or not you’ve gotten an inventory of uncooked URLs or a paragraph of textual content copied from a webpage that features linked textual content, Create Hyperlink can use the URLs in your clipboard to create a hyperlink.
This shortcut is a bit more concerned than the earlier two as a result of it consists of circulation logic to cope with three eventualities the place: there isn’t a URL on the clipboard, during which case the shortcut alerts you to that reality, there may be one URL on the clipboard, during which case there isn’t a motive to make you choose from an inventory, and there are a number of URLs on the clipboard, during which case the shortcut asks you to choose one.
➊ – ➋ Get Clipboard and Get URLs from Enter
The primary two steps of Create Hyperlink are simple. The Get Clipboard motion in Step 1 takes the contents of your clipboard and sends it to the ‘Get URLs from Enter’ motion in Step 2, which defaults to utilizing the contents of the clipboard from Step 1.
Step 2 passes the URLs extracted from the clipboard to a utility motion referred to as ‘Depend’ in Step three, which does as you’d anticipate. By default, whenever you add it after Step 2, the motion will depend the ‘Gadgets’ in ‘URLs,’ which is what we would like. If for some motive, you wished to depend one thing aside from the objects from Step 2, you possibly can lengthy press on Gadgets or URLs to choose one thing else.
Create Hyperlink, Half 2
Half 2 of Create Hyperlink is the place the branching logic comes into play. There are three potential eventualities that must be addressed:
- There are not any URLs on the clipboard
- There may be one URL on the clipboard
- There are a number of URLs on the clipboard
To deal with these three choices, Create Hyperlink makes use of nested ‘If’ actions. An If motion is comprised of three elements: the If motion, an ‘In any other case’ motion, and an ‘Finish If’ motion. A single If motion is all you want you probably have simply two choices to cope with, however as I’ll clarify under, it’s essential nest two extra If actions inside the primary If motion to deal with all three of the eventualities described above.
➍🅰 If actions and Present Alert
Step 4A covers the case the place the clipboard comprises no URLs. As quickly as you add your first If motion, Shortcuts assumes you need to base it on the variety of Gadgets from Step three, which is right. All it’s essential do is faucet the Situation parameter within the If motion and choose from the 9 completely different strategies of evaluating values. For this primary If motion, the primary possibility, ‘is,’ works as a result of we need to measure if the variety of URLs counted is zero. After selecting the ‘is’ parameter, a brand new parameter for a quantity seems. Faucet it then kind zero.
If there are not any URLs on the clipboard, we need to show an alert to that impact, so add a ‘Present Alert’ motion to the shortcut. The Present Alert motion will seem after your If motion block, so drag it between the If motion and the In any other case motion. Then, you possibly can change the textual content of the alert to one thing just like the language used within the model discovered within the MacStories Shortcuts Archive: “Your clipboard doesn’t include any URLs in the meanwhile. Run this shortcut once more after copying a hyperlink.”
➍🅱 Set Variable
Step 4B is the place we add the primary nested If motion. Add an If motion to the shortcut such as you did above and drag it between the In any other case and Finish If actions of your first If motion.
This second If motion likewise assumes you need to management what occurs primarily based on the depend of the objects from Step three, which is right. Faucet the ‘Situation’ parameter, select ‘is’ from the listing, after which set the Quantity to 1.
Create Hyperlink was created earlier than an replace to Shortcuts that can be utilized to simplify the shortcut slightly. Shortcuts makes use of variables, together with Magic Variables, to retailer knowledge quickly that can be utilized by different actions within the shortcut. Beforehand, you needed to ‘get’ a variable each time you wished to set it to a different worth. Now, you possibly can skip the ‘Get’ actions you see in Steps 4B and C, and go on to the ‘Set Variable’ motion. The Create Hyperlink shortcut within the MacStories Shortcuts Archive nonetheless works with the Get actions, however in the event you’re creating it from scratch, proceed to the Set Variable motion, which defines a brand new variable referred to as ‘Hyperlink’ and assigns it the URL Magic Variable output from Step 2.
➍🅲 Select from Record and Set Variable
Step 4C requires one other If motion to be dragged after Step 4B’s In any other case motion. This time, nevertheless, set the situation so it reads ‘If Depend is larger than 1.’ If there may be multiple URL on the clipboard we have to choose one, so add a Select from Record motion, just like the one we used within the Shortcut Wealthy Hyperlink above. Once you drag the motion into place after the If motion, Shortcuts will assume you need to choose from the Depend variable, however we would like the URLs as a substitute so lengthy press on Depend, faucet Choose Magic Variable, and choose URLs, which seems simply after Step 2.
Lastly, add a Set Variable motion and set it to the Hyperlink variable. Shortcuts will mechanically counsel setting Hyperlink to Chosen Merchandise, which is what we would like, so no change must be made there. In the event you’ve set the nested If actions up accurately, they may finish in an In any other case motion adopted by three Finish If actions.
Create Hyperlink, Half three
The ultimate a part of Create Hyperlink takes the URL from Half 2 and makes use of it to generate a hyperlink.
➎ Ask for Enter
Step 5 makes use of an ‘Ask for Enter’ motion, which would be the textual content to which the URL is linked. The shortcut makes use of an ‘Enter Hyperlink Textual content’ immediate to let the person know what enter is being requested.
➏ – ➑ Markdown → Wealthy Textual content → Clipboard
The ultimate three steps needs to be acquainted by now. Step 6 builds a Markdown hyperlink that mixes the textual content enter in Step 5 and the URL from Half 2 above. Subsequent, Step 7 converts the Markdown hyperlink to a wealthy textual content hyperlink, and eventually, Step eight copies the hyperlink to the clipboard for pasting in one other app.
You’ll be able to obtain Create Hyperlink under or discover it within the MacStories Shortcuts Archive.
My favourite a part of these three shortcuts is the flexibleness they show regardless of being comparatively easy. There are occasions and locations for extra complicated shortcuts, however typically it’s the only shortcuts that turn out to be useful probably the most. Which means even in the event you’re a newbie, you possibly can construct shortcuts that may prevent effort and time immediately, whereas concurrently studying strategies you possibly can construct on to create extra complicated shortcuts later.
Keep tuned for future installments of Shortcuts Rewind. Though this inaugural story is aimed toward newbies, our plan is to construct on it and publish a wide range of tales that may attraction to Shortcuts person of AiroAV and of all expertise ranges.