capcap: A macOS Tool That Completes Screenshots, Annotations, and Image Hosting with ⌘ Double-Click

--- Screenshots are an essential tool for content creation, documentation, and even the increasingly popular world of pair programming. However, many developers often find the default macOS screenshot tool lacking. External tools are an option but can feel cumbersome due to “feature overload” or the need for separate apps to upload images to hosting services. To address these challenges, the macOS menu bar screenshot tool capcap has been introduced. With a simple double-click of the ⌘ key, capcap allows users to take screenshots, add annotations, and upload images to hosting services—all in one seamless workflow.

A Single Core Interaction The operational framework of capcap is remarkably simple: everything starts with a double-click of the ⌘ key. This idea was inspired by the Claude app, which allows users to send images directly to a conversation window by double-clicking ⌘ on any application. For those who don’t prefer the ⌘ double-click, the global shortcut key can be customized in the settings menu. When triggered, capcap immediately enters selection mode. Simply hovering the cursor over a window will automatically recognize its boundaries, and a click captures the entire window. Dragging the cursor allows for pixel-perfect selection at Retina-native resolution. In multi-monitor setups, all screens are enabled for selection simultaneously. When the cursor nears a window, green dotted lines appear, and a single click completes the capture. This eliminates the stress of manually aligning edges, significantly improving the user experience.

Object-Based Annotation Features In most screenshot tools, annotations are “one-time rasterized,” meaning adjustments often require redoing the work from scratch. capcap treats annotations as objects. Arrows, for instance, can be reshaped from straight to curved by dragging their endpoints. Number annotations automatically increment and can be adjusted with leader lines through dragging. Text can be directly edited with a double-click, and font size can be adjusted between 10 and 100 points. Colors can also be changed freely. For additional tools like rectangles, ellipses, brushes, and highlight brushes, users can modify colors and line thickness even after they’ve been drawn. The mosaic tool allows for adjustable block sizes, ensuring sensitive information is properly obscured. Moreover, undo and redo operations are as intuitive as in a document editor. Selecting an existing annotation presents rotation, endpoint, and curve handles, allowing for post-screenshot refinements without having to start over.

Long Screenshots and Beautification When creating documentation, it’s common to capture entire pages, large tables, or lengthy chat logs. capcap comes with a built-in long screenshot feature. Users can enclose a scrollable area and scroll using a trackpad or mouse wheel. A real-time preview of the combined image appears alongside. Once the desired length is captured, the output can be easily merged into the main editor for further annotation. Notably, the long screenshot doesn’t just export as a “final image”; instead, it gets imported into the editor, enabling users to continue adding annotations like arrows, numbers, or mosaics. For creating images for social media posts, sometimes raw screenshots don’t suffice. capcap features a lightweight beautification mode that supports gradient backgrounds, desktop wallpaper backgrounds, rounded corners, soft shadows, and adjustable inner margins. Users can create polished images without needing to open a separate image editing application by simply toggling tabs within the editor.

Direct Upload to Image Hosting One of capcap’s standout features is its image hosting capability, which the developer has prioritized. After an initial setup, the upload button within the editor becomes active. Currently, the tool supports three object storage services: Tencent Cloud COS, Qiniu Cloud Kodo, and Alibaba Cloud OSS. Clicking the upload button directly copies a public URL to the clipboard while also saving the thumbnail and upload history. This makes it easy to paste the image link directly into Markdown documents using ⌘+V. Importantly, the image hosting keys are only stored locally in UserDefaults and do not pass through an intermediary server. Rather than using “capcap’s image hosting service,” users utilize their own chosen hosting service and are responsible for its management, security, and any associated risks.

Other Practical Features Another noteworthy feature is the ability to edit images directly within Finder. If an image is selected in the Desktop or Finder, pressing the screenshot shortcut key skips the screenshot process and directly loads the image into the editor. The original file remains unchanged, so adding arrows or sending the image is a task that takes just a few seconds. Recent screenshot thumbnails and color picker history are displayed in the menu bar, allowing one-click copying. All data is stored locally (~/Library/Application Support/capcap/History), and users can set storage limits between 5 and 20 images. The macOS native color picker retrieves HEX values (#RRGGBB format), which are copied to the clipboard and logged in history. Screenshots can also be pinned as floating windows atop all applications, making them extremely useful for design comparisons or as reference material.

Lightweight Implementation with Pure AppKit What makes capcap particularly intriguing to macOS developers is its technical stack. Built entirely with AppKit, the tool does not rely on SwiftUI. The developer emphasized a commitment to creating something distinctly “Mac-like,” which requires precise window control, smooth hit-testing, and predictable event loops—elements not yet achievable with SwiftUI as of macOS 14.0. Furthermore, there are no third-party dependencies. The Package.swift file includes only standard libraries and system frameworks. As a result, the package is lightweight, launches quickly, and remains easy to maintain. For screen captures, capcap uses ScreenCaptureKit, which supports Retina-native resolution. Custom global shortcut keys are registered using the Carbon Hotkey API, while ⌘ double-click monitoring is handled via CGEventTap, which requires accessibility permissions. capcap is compatible with macOS 14.0 and later, and is available as a universal binary for both Apple Silicon and Intel-based Macs.

Installation capcap can be installed in two ways. To use Homebrew, execute the following commands: ```

brew tap realskyrin/capcap https://github.com/realskyrin/capcap brew install —cask capcap Note that the repository name is `capcap`, not `homebrew-capcap`, so you must explicitly specify the URL. Alternatively, you can download the latest DMG file from the GitHub release page and drag it into the Applications folder. If you encounter a warning that "the software cannot be verified for malicious content," you can resolve it with the following command: xattr -dr com.apple.quarantine /Applications/capcap.app ``` However, this action should only be performed for sources you trust.

Developer Philosophy and Future Plans capcap is completely free and open-source software provided under the MIT license, with no telemetry or data reporting. The developer emphasizes that this is a tool they personally use every day, embodying a design philosophy of “not cramming in features no one uses.” As a disclosure, the article’s author is the developer of the product. For macOS users frustrated by the hassle of switching between multiple apps for screenshots, annotations, and image hosting, capcap is a solution worth trying. --- FAQ: Q: What are the system requirements for capcap? A: macOS 14.0 or later is required. It runs as a universal binary for both Apple Silicon and Intel-based Macs. Accessibility permissions are needed to enable the ⌘ double-click monitoring feature. Q: How are uploaded images managed in image hosting? A: Image hosting keys are stored locally in UserDefaults and do not pass through an intermediary server. Management and security of uploaded images are handled via the user’s chosen cloud storage service. Q: Where can I access capcap’s source code? A: The source code is available on GitHub under the MIT license. For Homebrew installation, refer to https://github.com/realskyrin/capcap.