# QR scanning on a Mac

> macOS has no built-in QR scanner — Preview and Quick Look cannot decode codes. Use a browser-based scanner instead, upload a screenshot or point the webcam (or an iPhone via Continuity Camera) at the code. A client-side scanner decodes locally, so the image never leaves the Mac.

Source: https://useqr.app/docs/scanning/qr-scanning-on-mac · Last reviewed 2026-08-21 · UseQR is free forever, MIT licensed, no signup.

---

## What macOS gives you: nothing

Worth stating plainly, because people search for the setting: **macOS has no built-in QR
scanner**. Preview opens the image but cannot decode it. Quick Look shows it. Spotlight
ignores it. There is no Live Text-style long-press for QR codes on the Mac comparable to
the iPhone flow. Whatever you have read about hidden features, the honest answer is that
Apple put QR decoding into iOS and never into macOS.

So every working method brings its own decoder. Ranked:

## 1. Screenshot into a browser scanner (the default)

Most codes you meet on a Mac are already on the screen — in an email, a PDF, a web page,
a Zoom share. The flow:

1. **Cmd+Shift+4**, drag across the code. The PNG lands on the Desktop (or in the
   clipboard with **Ctrl** held).
2. Drag or paste it into a [browser-based scanner](/scan).
3. Read the decoded text, then open it if it looks right.

The scanner runs **client-side** — decoding happens in the browser's own code, the
screenshot is never uploaded, and you see the destination before visiting it. That
last property matters for anything unexpected; see
[checking a code before opening it](/docs/security/how-to-check-a-qr-code-before-opening).

## 2. The webcam, for codes on paper

For a physical code — a leaflet, a package, a printed ticket — use the same scanner's
**webcam mode** and hold the code up to the camera. Two tips: hold it 15–30 cm away so
the fixed-focus lens keeps it sharp, and avoid backlighting from a window. How the
in-browser camera pipeline works (and why Safari will ask for permission) is covered in
[browser scanning](/docs/scanning/qr-scanning-in-a-browser) and
[camera permissions](/docs/scanning/camera-permissions-and-qr-scanning).

## 3. Continuity Camera, for a better lens

Since macOS Ventura (2022), an iPhone can serve as the Mac's webcam over **Continuity
Camera**. Select the iPhone as the camera in the scanner's webcam mode and you get a
vastly better sensor with autofocus — useful for small or dense codes that defeat the
built-in webcam. It is a trick worth knowing, though it concedes the obvious: if the
iPhone is already in your hand, its own
[Camera app](/docs/scanning/how-to-scan-a-qr-code-on-iphone) pointed at the paper is
usually faster.

## The command line, if you live there

Homebrew's `zbar` package gives you the same tool Linux users rely on:

```bash
brew install zbar
zbarimg screenshot.png
# QR-Code:https://example.com
```

Fine for scripting and [bulk decode checks](/docs/developers/decode-a-qr-code-programmatically);
overkill for a one-off scan.

## The honest recommendation

Screenshot → browser scanner for anything on screen; phone camera for anything on paper
(with the webcam as the phone-free fallback). Do not install a Mac App Store "QR
reader" for a one-off scan — the category is ad-heavy and adds nothing the browser
route lacks.

## FAQ

### Does macOS have a built-in QR code scanner?
No. Preview and Quick Look cannot decode QR codes, and no macOS version has shipped a
system scanner. Use a browser-based scanner with a screenshot or the webcam, or point a
phone at the screen.

### How do I scan a QR code in a picture on my Mac?
Screenshot or save the image, then drag it into a browser-based scanner. A client-side
scanner decodes it locally in the browser and shows the destination text before you
open anything.

### Can Preview on Mac read QR codes?
No. Preview displays the image but has no decoder. This is the most common false lead in
Mac QR scanning — the decoding always has to come from a browser tool, a command-line
utility, or another device.

### Can I use my iPhone as a QR scanner for my Mac?
Two ways: point the iPhone's own camera at the code and share the link to the Mac, or
use Continuity Camera (macOS Ventura and later) so the iPhone acts as the Mac's webcam
inside a browser scanner.

## Try it

- https://useqr.app/scan
- https://useqr.app/validate