screen-loupe

Screen Loupe Guide

Screen Loupe shows one spot of your screen magnified in a window of its own, while you keep working in that spot. The workflow is place → zoom → pan → inspect → copy.

Home · Download · Support

Getting started

  1. Install it: open the DMG from Releases and drag Screen Loupe to Applications, run brew install --cask ayenora/tap/screen-loupe, or get it from the Mac App Store. It needs macOS 15.2 Sequoia or later.
  2. Open it. The first time, the Viewer asks for Screen Recording access: click Continue, turn Screen Loupe on in System Settings › Privacy & Security › Screen & System Audio Recording, and reopen the app when macOS asks. The app captures no audio.
  3. A blue frame — the Capture Area — appears on screen, and the Viewer window beside it shows what is inside the frame, live.

Closing the Viewer hides the frame too; the app stays in the menu bar (the magnifier icon). Show Viewer there, or click the Dock icon, brings both back.

The Capture Area

A Safari window with the Capture Area fitted to it and a top margin over its toolbar, the Viewer showing only the page

The Viewer

The Viewer zoomed in on an icon with the Corner Ruler and the crosshair, beside the Simulator with the Capture Area over it

Copying and saving

Command What you get
Copy View ⌘C Exactly what the Viewer shows, at its zoom — with a colour vision simulation while one is on, and a split with its line and side labels, so the person you send it to can tell the sides apart.
Copy Source ⇧⌘C The area as it is on screen, unmagnified, at native resolution.
Save View… ⌘S / Save Source… ⇧⌘S The same as a PNG file.

The toolbar’s Copy button copies the view and its ▾ offers Copy Source too; Save saves the view and its ▾ offers Save Source.

To copy just a part of the view:

To copy the text in what the Viewer shows — a button’s label, a heading, text in an app that doesn’t let you select it, such as the Simulator:

Freezing a moment

Tools

The Color Meter with a colour's values, a contrast pair and its WCAG verdicts, Favorites and Recent

A design export laid over a web page in Difference: matching pixels turn black, the shifted button glows

The Viewer simulating deuteranopia, its colour vision menu open, beside the Simulator in normal colours

Recent Captures with two linked snapshots, one shown in the Viewer with the Selection Ruler on a label

Screenshot studio

A screenshot tool of its own, for exact, clean pictures — App Store and website screenshots, docs, bug reports. Screenshot › Show Screenshot Studio, or the menu bar item, shows an orange frame and a floating palette; the palette’s close button hides them. They are apart from the Capture Area and the Viewer, so the Viewer can be in the picture, and every palette button is also in the Screenshot menu. Size, Timer, Output, Background and One Window’s ▾ open their menus beside the palette, leaving the app you work in active; Background shows its colours and gradients as rows of swatches.

In the official build

The core is open source (MIT); official builds add free closed-source features. The DMG, Homebrew and the Mac App Store ship the official build; a build from the source on GitHub has the core only. Everything in this section is in the official build.

Follow Pointer

The Capture Area follows the pointer, to look along a page, a design or a long list without dragging the frame. Turn it on and off with the toolbar’s first button, before the loupe (a pointer over dashed squares), Window › Follow Pointer, ⌃⌥⌘F from any app, or the Shortcuts action. It needs the Viewer open; closing the Viewer turns it off.

Shortcuts actions

The app’s commands as actions in the Shortcuts app, so a shortcut, Spotlight, Siri or a launcher that runs shortcuts can drive the Viewer: Copy View, Copy Source, Freeze (On, Off or Toggle), Follow Pointer (On, Off or Toggle), Take Snapshot, Fit Capture Area to Window, Set Zoom (a preset or a percentage), Use Frozen Frame as Reference, Show Viewer and Pick Color, the colour under the pointer in the Capture Area. Each does what its menu command does; where the command would be off, the action fails with a sentence that says why. Copy View and Copy Source pass their image on to the next action, and Pick Color its HEX. Each is also an App Shortcut, such as “Copy View in Screen Loupe”, with no shortcut to make first.

Open With

Screen Loupe is in Finder’s Open With for images and takes images dropped on its Dock icon. Each file opens as a Recent Captures row, as a drop on the Viewer for inspection does. It is never made the default app: double-clicking an image still opens it where it did.

Color Meter: more formats and a larger sample

Favorites in every app’s colour panel

The Color Meter’s Favorites are also the system colour list “Screen Loupe”: the colour panel of TextEdit, Pages, Keynote and every other app that has one lists it under Color Palettes, each colour named by its HEX. It follows every change; an app that is already open shows a change after it is relaunched. There is nothing to set up.

Colour vision: severity and confusable pairs

Keyboard shortcuts

In the Viewer:

Shortcut Action
⌘O Open Image…
⌘V Paste an image
⌘C / ⇧⌘C Copy View / Copy Source
⌘S / ⇧⌘S Save View… / Save Source…
Space Freeze / resume
⌘T Take Snapshot
⌘E Select tool
⇧⌘E Copy Text
⌘A Select the whole Capture Area (all the text while Copy Text is on)
⌘R Corner Ruler
⌥⌘R Selection Ruler
⌘Y Colour vision simulation on / off
⌥⌘Y Split with Normal Vision
⌘0 Reset zoom
⌥⌘0 Size Window to Area
+ / - Zoom in / out
⌥-drag Copy a region
Escape With Copy Text on: clear the text selection, then leave Copy Text; else clear a selection; else drop the Color Meter’s target; else cancel a countdown and go back to live

On the Capture Area and the studio’s frame (click it first): arrows move by 1 px, ⇧ by 10 px, ⌥ resizes; hold ⌘ while dragging to snap, ⇧ on a corner for a square.

Global, from any app — each can be changed or cleared in Settings › Shortcuts:

Shortcut Action
⌃⌥⌘L Show / Hide Capture Area
⌃⌥⌘V Show / Hide Viewer
⌃⌥⌘C Copy View
⌃⌥⇧⌘C Copy Source
F13 Freeze / Resume Viewer
⌃⌥⌘W Fit Capture Area to Window
⌃⌥⌘M Show / Hide Viewport Handle
⌃⌥⌘F Follow Pointer on / off (official build)

Settings

Settings… (⌘,) has five tabs: General (launch at login, Dock or menu bar only), Capture Area (frame colour, line and labels), Viewer (background, grid, crosshair colour, wheel zoom), Screenshots (folder, file names) and Shortcuts.

Updates

Help › Check for Updates…, also in the menu bar item, opens the latest release on GitHub in your browser; the app itself never goes online. Homebrew users get new versions with brew upgrade. The downloaded copy has the item; a copy from the Mac App Store, updated by the store, and a copy built from source don’t.

If something doesn’t work