For designers, app developers, and tech journalists, the process of presenting a screenshot often requires more than just a capture; it requires context. The “Apple Frames” shortcut has long been a staple for those needing to wrap their screenshots in official Apple product bezels to create a polished, professional glance. Now, the tool has received a significant upgrade with the release of Apple Frames 4, which introduces a streamlined architecture and a modern way for power users to interact with the software.
The latest version of the Apple Frames shortcut gets massive overhaul, focusing on speed and precision. Federico Viticci, the creator behind the tool, has fundamentally rebuilt the shortcut to handle the expanding variety of Apple hardware. By optimizing the underlying logic, the shortcut’s complexity has been reduced from over 800 steps to approximately 300, resulting in a tool that is not only faster but significantly more reliable when processing various screen resolutions.
Beyond the performance gains, the update expands personalization and accuracy. Users can now select specific device variants—such as choosing between an iPhone 16 Pro and an iPhone 17 Pro—and apply official bezel colors offered by Apple. This level of granularity ensures that the final image accurately reflects the physical hardware being showcased, removing the guesswork from the framing process.
Solving the Proportional Scaling Problem
One of the most persistent issues in previous versions of Apple Frames was the lack of proportional scaling when merging multiple devices into a single image. In earlier iterations, if a user placed an iPhone screenshot next to an iPad Pro screenshot, the shortcut would often scale the iPhone to be as tall as the iPad, distorting the relative size of the devices.
Apple Frames 4 resolves this by implementing a mapping of the physical proportions of all supported devices. This ensures that when screenshots from different hardware are merged, the relative scale is respected. This change is particularly critical for marketers and developers who need to demonstrate how a user interface adapts across a device ecosystem without sacrificing visual accuracy.
Viticci noted that this was a substantial addition, stating: “the new Apple Frames likewise contains a mapping of all supported devices’ physical proportions, which are respected when merging different screenshots in the same image.”
A New CLI for Terminal and Agentic Workflows
While the shortcut is ideal for general users, the most significant addition for the technical community is the introduction of a command-line interface (CLI). This allows users to frame screenshots directly from the macOS Terminal, bypassing the Shortcuts app UI entirely.
The CLI is designed with an “agent-first” mindset, meaning it is built to be integrated into automated workflows. For those using AI-driven development tools like Claude or Codex to build and debug apps, the CLI can be slotted into the pipeline. This allows developers to automatically generate framed screenshots as part of their testing and documentation process.
According to Viticci, the CLI was built specifically “to help developers and marketers who deal with screenshots on a daily basis and save them a bit of extra time every day.”
Comparison of Apple Frames Versions
The shift from the previous version to Apple Frames 4 represents a move toward professional-grade automation. The following table highlights the primary technical shifts in the tool’s capabilities.
| Feature | Previous Versions | Apple Frames 4 |
|---|---|---|
| Logic Complexity | 800+ Steps | ~300 Steps |
| Scaling | Uniform Height | Proportional Scaling |
| Customization | Default Colors | Official Apple Bezel Colors |
| Interface | Shortcuts App Only | Shortcuts App & CLI |
| Workflow | Manual | Agentic/Automated |
Impact on the Development Ecosystem
The overhaul of the Apple Frames shortcut is more than a visual update; it is a utility improvement for the broader Apple development community. By reducing the step count of the shortcut, Viticci has lowered the overhead for the macOS and iOS systems when executing the task, making it “faster and vastly more reliable than before.”
For those who rely on high-fidelity mockups for App Store submissions or press releases, the addition of device variants (such as the distinction between iPhone 16 Pro and 17 Pro) ensures that the assets remain current as Apple updates its hardware lineup. The ability to customize colors per-device and per-orientation further removes the need for third-party image editing software to achieve a professional result.
The tool is available for download via MacStories, where the creator continues to document the evolution of the project and provide updated installation instructions for the CLI.
As Apple continues to introduce new screen sizes and bezel designs across its product line, the adaptive logic of Apple Frames 4 is designed to scale alongside these changes. Users can expect further refinements as new hardware is officially released and its physical proportions are mapped into the tool’s database.
Do you utilize Apple Frames in your design workflow? Let us know in the comments or share this article with your fellow developers.
