This Week's Sponsor:

Textastic

The Powerful Code Editor for iPad and iPhone — Now Free to Try

Posts tagged with "automation"

Apple Frames 3.1.1 with Support for Passthrough Mode→

The 'Shortcut Result' variable, used as an image variable in a shortcut that calls Apple Frames.

The ‘Shortcut Result’ variable, used as an image variable in a shortcut that calls Apple Frames.

I just released a small update to Apple Frames 3.1, which came out earlier this week, with a new output command: &passthrough. With this output command for the Apple Frames API, you’ll be able to generate a framed image (from whatever source you like) and simply pass its result to the next action in a shortcut as a native image variable.

I wrote about this as part of my Extension column in MacStories Weekly today, where I also covered the ability to run Apple Frames from the command line on macOS. Here’s the excerpt about version 3.1.1 of Apple Frames and the new passthrough mode:

As I was researching this column for Weekly, I realized there was an obvious candidate for an output command I did not include in Apple Frames 3.1: a passthrough command to, well, pass framed images along as input for the next action of a shortcut.

Here’s what I mean: when you run Apple Frames from a helper shortcut using the ‘Run Shortcut’ action, that action produces an output variable called ‘Shortcut Result’. If you’re running Apple Frames as a function, thus turning it into a feature of another workflow, it can be useful to take the framed images it produces and use them as a native variable in other actions of the shortcut. The problem is that the output commands I launched with Apple Frames 3.1 all involved “storing” the framed images somewhere, whether it was Files or the system clipboard.

This is no longer the case with the &passthrough output command I added to Apple Frames 3.1.1, which you can redownload from the MacStories Shortcuts Archive or directly from this link. If you run the Apple Frames API with this command, framed images will be passed along as native output of the shortcut, which you can reuse as a variable elsewhere in a shortcut that’s invoking Apple Frames.

And:

Any shortcut or longer workflow that involves running Apple Frames in the background and retrieving the screenshots it frames can take advantage of this method, allowing you to bypass the need to store images in the clipboard, even if temporarily. Essentially, passthrough mode turns Apple Frames into a native action of the Shortcuts app that returns a standard image variable as its output.

This is the only change in version 3.1.1 of Apple Frames, and I’m excited to see how people will take advantage of it to chain Apple Frames with other shortcuts on their devices. You can download the updated version of Apple Frames below.

Apple Frames

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.

Get the shortcut here.

Permalink

Apple Frames 3.1: Extending Screenshot Automation with the New Apple Frames API

Apple Frames 3.1 comes with a lightweight Apple Frames API to extend its automation capabilities.

Apple Frames 3.1 comes with a lightweight Apple Frames API to extend its automation capabilities.

Update, March 3: Version 3.1.1 of Apple Frames has been released with support for a new passthrough output command. This post has been updated to reflect the changes. You can redownload the updated shortcut at the end of this post.

Today, I’m happy to introduce something I’ve been working on for the past couple of months: Apple Frames – my shortcut to put screenshots captured on Apple devices inside physical device frames – is getting a major upgrade to version 3.1 today. In addition to offering support for more devices that I missed in version 3.0 as well as some bug fixes, Apple Frames 3.1 brings a brand new API that lets you automate and extend the Apple Frames shortcut itself.

By making Apple Frames scriptable, I wanted to allow power users – such as designers and developers who rely on this shortcut to frame hundreds of images each week – to save valuable time without compromising the accessible nature of Apple Frames for other people. This is why all of the new advanced features of Apple Frames are optional and hidden until you go look for them specifically. Furthermore, even if you do want to use the Apple Frames API, you’ll see that I designed it in the spirit of Shortcuts: it does not require any code and it’s entirely powered by simple, visual ‘Text’ actions.

I’m incredibly excited about what Apple Frames can do in version 3.1, so let’s dive in.

Read more

Masto-Redirect, a Mastodon Shortcut to Redirect Profiles and Posts to Your Own Instance

Using Masto-Redirect in Safari.

Using Masto-Redirect in Safari.

Like many others over the past month, I’ve been thinking deeply about my experience with Twitter and whether I want to align my social media usage with the kind of platform Twitter is rapidly becoming. It’s a complex discussion (if my readers are still on Twitter, am I doing them a disservice by not using Twitter?), but in the meantime, I’ve decided to learn more about Mastodon. And in doing so, I came across an aspect of the service that I wanted to improve with a shortcut.

I created an account on Mastodon.social all the way back in 2018, and you can find me as @viticci there as well. I don’t want to turn this post into a guide to Mastodon (you can find an excellent one here), but, long story short, Mastodon is a decentralized service that is based on a federated network of instances. Essentially, there isn’t a single “Mastodon website” like, say, twitter.com; instead, there can be multiple Mastodon instances across different domains (hence why it’s “decentralized”) but, thanks to an underlying API, you can follow and be followed by people regardless of the instance they’re on. I can be on Mastodon.social, and you can be on Journa.host or Mastodon.online (different instances of Mastodon), but we can still communicate with one another via the protocol Mastodon uses. It’s like living in different countries but speaking the same language. You can read more about this here.

Read more

Apple Frames 3.0: Completely Rewritten, Support for iPhone 14 Pro and Dynamic Island, New Devices, Multiple Display Resolutions, and More

Apple Frames 3.0.

Apple Frames 3.0.

Today, I’m pleased to announce the release of version 3.0 of Apple Frames, my shortcut to put screenshots taken on various Apple devices inside physical frames for iPhone, iPad, Mac, and Apple Watch.

Apple Frames 3.0 is a major update that involved a complete re-architecture of the shortcut to improve its performance and reliability on all Apple platforms. For Apple Frames 3.0, I entirely rebuilt its underlying file structure to move away from base64 and embrace Files/Finder to store assets. As a result, Apple Frames 3.0 is faster, easier to debug, and – hopefully – easier to maintain going forward.

But Apple Frames 3.0 goes beyond a new technical foundation. This update to the shortcut introduces full compatibility with the iPhone 14 Pro and 14 Pro Max with Dynamic Island, Apple Watch Ultra, and the M2 MacBook Air. And that’s not all: Apple Frames 3.0 also brings full support for resolution scaling on all iPad models that offer the ‘More Space’ display mode in iPadOS 16. And in the process, I also added support for ‘Default’ and ‘More Space’ options on the Apple Silicon-based MacBook Airs, MacBook Pros, and iMac. All of this, as always, in a native shortcut designed for high performance that uses Apple’s official device images and requires no manual configuration whatsoever.

Apple Frames 3.0 is the biggest, most versatile version of Apple Frames to date, and I’m proud of the results. Let’s dive in.

Read more

Creating Lock Screen Widgets for Specific Notes via the Apple Notes URL Scheme

All I wanted was a widget.

All I wanted was a widget.

A few days ago, as I was playing around with my Lock Screen on iOS 16, I wondered: would it be possible to use the hidden Apple Notes URL scheme to create widget launchers to reopen specific notes in the Notes app?

That led me down a fascinating rabbit hole filled with hidden Shortcuts tricks and discoveries I thought would be useful to document on MacStories for everyone to see.

You know, for posterity.

Read more

Shortcuts in iOS 16: The Potential of App Shortcuts for Everyone

App Shortcuts in iOS 16.

App Shortcuts in iOS 16.

A note from Federico: This year, I’ve decided to try some new things for my annual iOS 16 review. Some you’ll see on Monday. One of them is previewing small excerpts from the review in the OS Preview series on MacStories and MacStories Weekly for Club MacStories. Today, I’m posting a preview of a section of the Shortcuts chapter here, and a section of the Everything Else chapter in MacStories Weekly. I hope you enjoy these. I’ll see you for the full story – and more reveals – on Monday.

In iOS 16, the Shortcuts app hasn’t undergone a major redesign or technical rewrite; instead, Apple’s efforts have focused on adding more actions for system apps, extending the developer API, bringing more stability, and making Shortcuts more approachable for new users.

The last point is both important and likely the reason why some Shortcuts power users will be disappointed by this year’s update. There isn’t a lot for them in this new version of the app: as we’ll see in my iPadOS review, there’s no integration with Files quick actions, no support for Stage Manager actions, and no system-wide hotkeys still. If you’re an advanced Shortcuts user and were wishing for more system-level enhancements in addition to stability this year: I hear you, but we’ll talk about this later on.

What we do have in iOS 16 is a fascinating new feature to get newcomers started with the Shortcuts app, a grab bag of useful new actions for Apple apps, and some solid developer-related enhancements that will make third-party actions much better than before. Let’s take a look.

Read more

Generating Markdown Links to Mail Messages with Shortcuts and AppleScript

One of the system app updates we covered on AppStories this week that I’m most excited about is Mail. The app will finally introduce several advanced features this fall, including:

  • Undo send, allowing you to recall a message for 10 seconds after sending a message
  • Message scheduling with suggested and fully-customizable future delivery times and dates
  • Follow Up, which surfaces requests you’ve made in messages for which you haven’t received a response
  • Remind Me, a snooze-like feature for scheduling messages to reappear in your inbox later
  • Missing recipient and attachment alerts
  • Improved search

For the first time in quite a while, that list makes Mail a much more attractive alternative to third-party apps. Mail won’t match every feature offered by third parties, but my needs for advanced email client features are fairly modest, which I expect puts me squarely in the demographic that Apple is targeting.

Mimestream offers Gmail's excellent search and other features in a native Mac package.

Mimestream offers Gmail’s excellent search and other features in a native Mac package.

Until recently, my email use was split between Mimestream, which is only available on the Mac, and Spark on iOS and iPadOS. The split wasn’t ideal, but because I handle most of my email on my Mac, I tolerated it.

For the past several weeks, I’ve been using Mail exclusively on all of my devices, which has been a refreshing change of pace. Still, it’s not perfect. Of the features I use most in third-party mail clients, the single biggest shortcoming of Mail is its clunky implementation of deep linking.

I drop links to email messages in my notes and tasks all the time as a way to quickly access important contextual information. Mimestream offers Gmail URLs, and Spark can create its own app-specific and web URLs right within those apps’ UIs.

I like the way drag and drop on the iPhone and iPad links a message to its subject, but having to use drag and drop is clunky.

I like the way drag and drop on the iPhone and iPad links a message to its subject, but having to use drag and drop is clunky.

In contrast, on iOS and iPadOS, you can only link to a Mail message by dragging it out of Mail into another app’s text field. I’ll take it, but I’d prefer if I could quickly generate a link from the share sheet or with Shortcuts instead. The situation on the Mac isn’t much better, requiring users to resort to AppleScript to construct a URL that links back to a Mail message.

With weeks of Ventura testing ahead of me, I decided to see what I could do to improve the situation. The result isn’t perfect: I still have no choice on iOS and iPadOS but to drag and drop messages. However, I’ve improved the experience on the Mac using a combination of AppleScript and a shortcut that I trigger using Raycast to link the subject of a Mail message to its URL. For added context, my shortcut adds the sender’s name too.

Read more

Introducing the 2022 Automation April Shortcuts Contest Winners

John: One of the hardest things about a new project is keeping it under wraps until it’s ready. That was true of Automation April in general, but it was especially true of the Shortcuts Contest. As soon as we’d decided on the outline of what the contest would be, we knew it was something that had the potential to be special by bringing together the MacStories and broader Shortcuts communities for a single event.

We couldn’t be happier with how this year’s inaugural Automation April Shortcuts Contest went. We had over 200 shortcuts submitted to compete in six categories:

  • Best Everyday Shortcut
  • Best HomeKit Shortcut
  • Best Mac Shortcut
  • Best Media Shortcut
  • Best Productivity Shortcut
  • Best Overall Shortcut

The shortcuts we received were remarkable, and as we’d hoped, they ran the gamut from simple automations that solved one problem exceptionally well to shortcuts that offered broad functionality more like an app than an automation.

Having gone through every one of this year’s submissions, we’ve got a deeper appreciation than ever for just how vibrant and creative the Shortcuts community is. Across every Apple platform, its users are creating clever automations to extend the power of their devices and sharing them with a community that is incredibly generous with their time and efforts in helping others to learn how to build their own shortcuts.

With so many excellent shortcuts from which to choose, picking the winners was tough, but fortunately, we had a crack team of Shortcuts experts to help judge the submissions. Thanks to Simon Støvring, Matthew Cassinelli, Christopher Lawley, Jason Snell, Rosemary Orchard, Alex Cox, and David Sparks for their participation. We appreciate the time each was able to take sifting through this year’s contest submissions.

We’ve also got a little surprise for readers. Alongside the winners in each category, we’ve included a handful of honorable mentions to showcase some of our favorite shortcuts that didn’t win a category. I think you’ll see from the quality of these bonus shortcuts just how deep the field of submissions was.

With that, it’s time to reveal our first ever Automation April Shortcuts Contest winners and share the shortcuts they’ve created.

Read more