Support

Why does ToneLoupe need the Screen Recording permission?

Analysing the pixels under the loupe is the product — the permission is how macOS allows an app to read the screen. ToneLoupe analyses frames on the GPU and discards them immediately; nothing is recorded or transmitted. See the privacy policy.

How do I grant (or re-grant) the permission?

System Settings → Privacy & Security → Screen & System Audio Recording → enable ToneLoupe, then relaunch the app. If the loupe ever shows a permission error, the panel has a button that takes you to the right settings pane.

The loupe blocks my clicks — how do I work underneath it?

You already can: the loupe's interior passes clicks through to the app below. Only the border band takes the mouse (outer edge resizes, inner edge moves). The two yellow chips in the top-right corner move the loupe and toggle the scopes panel, and Lock makes the whole loupe click-through.

What do the colors mean?

In Skin mode: yellow = skin sits on the vectorscope skin-tone line; green or pink = hue drifting off it. In Exposure mode, luminance maps to a false-color scale with the skin target on the yellow band and clipping in red — the legend under the scopes shows the full scale.

Which Macs are supported?

macOS 14 (Sonoma) or later, Apple silicon and Intel. Performance cost is roughly 3% CPU at the default 15 fps.

Does it work in fullscreen apps and across Spaces?

Yes — the loupe and panel float above fullscreen apps and follow you across Spaces. The global shortcut (default ⌃⌥⌘S, changeable) hides everything to the menu bar and brings it back.

Still stuck?

Write to omercesim@gmail.com — include your macOS version and what you expected to happen. Replies usually within a day or two.