How to Scan QR Codes on Mac (macOS)
By Codexengr, QR Systems Engineer · Last reviewed
Scanning QR Codes on Mac
macOS ships no built-in QR scanner, which surprises iPhone owners. The good news: you almost certainly have a superb scanner already — your iPhone. And for everything else, a web-based scanner with the Mac camera covers it.
Method 1: iPhone-to-Mac workflow (fastest)
- Point your iPhone camera at the QR code.
- Tap the banner to open the link (or copy the decoded text).
- Use the result on your Mac — open the link, paste the text, or AirDrop a screenshot of the code to the Mac and decode it there.
Since the iPhone decodes instantly and accurately, this is the path of least resistance for anyone with both devices.
Method 2: Web-based scanner with the Mac camera
- Open Safari or Chrome on the Mac.
- Navigate to a web-based QR scanner served over HTTPS.
- Allow camera access when prompted.
- Hold the QR code up to the Mac camera at about arm's length.
Mac webcams are fixed-focus and tuned for faces, so hold the code 40 to 60 cm away under good light rather than close up.
Method 3: Decode from an image file
Web scanners usually accept uploads too. Screenshot the code, or open a PDF containing one, and upload the image to the scanner. This is the best method for codes embedded in documents — no camera involved at all.
Camera permission in Safari
If Safari blocks camera access, check the prompt when the scanner loads, or go to Safari → Settings → Websites → Camera to allow it for the scanner site. The page must be HTTPS or the browser will refuse outright.
Wi-Fi and other payloads
macOS will not auto-join Wi-Fi from a scanned code. Copy the network name and password from the result and join via the Wi-Fi menu. URLs and text work immediately — paste or click through.
When to just use the phone
If a code is small, damaged, or on a curved surface, do not fight the Mac webcam: scan it with the iPhone and transfer the result. The phone's decoder and autofocus are simply better tools for hard codes.
Where the scanner lives on this device
Built-in scanner: none — no system-wide scanner — use Photo Booth/Preview with a web scanner, or Continuity with iPhone.
How to reach it: Fastest: point your iPhone camera at the code and use the result on the Mac (Continuity/handoff of links). Alternatively, open a web-based QR scanner in Safari or Chrome and hold the code up to the Mac camera.
Common failure modes and fixes
No built-in QR scanner anywhere in macOS
Why it happens: macOS does not ship a system-wide QR scanning feature like iOS does.
Fix: Use the iPhone-to-Mac workflow below, or a web-based scanner with the Mac camera. Both are free and need no installs beyond a browser.
Mac camera cannot focus on a close-up code
Why it happens: Mac webcams are fixed-focus and tuned for faces at desk distance.
Fix: Hold the code about 40 to 60 cm from the camera under good light. For small codes, photograph them with your phone and decode the photo instead.
Safari blocks the web scanner from using the camera
Why it happens: Camera permission was denied, or the scanner page is not HTTPS.
Fix: Allow camera access in the Safari prompt, and use an HTTPS scanner page. Check Safari → Settings → Websites → Camera if the prompt does not reappear.
Scanned Wi-Fi code does not connect the Mac
Why it happens: macOS has no automatic Wi-Fi QR join flow.
Fix: Copy the network name and password from the scan result and join manually via the Wi-Fi menu.
What this guide covers in testing
- URL QR codes (webcam + iPhone workflow)
- Wi-Fi QR codes (manual entry from result)
- Plain-text QR codes
- QR codes in image files decoded via web scanner upload
Performance notes
macOS has no native QR scanner, so the Mac borrows one: either the iPhone in your pocket (scan there, use the result on the Mac) or a web-based scanner driving the Mac camera. The iPhone workflow is fastest for links because the phone decodes instantly and the Mac picks up the result. The Mac camera itself is serviceable for large, well-lit codes held at desk distance, and web scanners can also decode QR codes from uploaded image files — handy for codes in screenshots and PDFs.
Frequently asked questions
- Does macOS have a built-in QR code scanner?
- No. macOS ships no system-wide QR scanner. Scan with your iPhone and use the result on the Mac, or use a web-based QR scanner with the Mac camera — both are free.
- What is the fastest way to scan a QR code on a Mac?
- Use your iPhone: point its camera at the code, tap the banner, and use the result on the Mac. The phone decodes instantly, which beats wrestling with the Mac webcam for most codes.
- Can I decode a QR code from a screenshot on Mac?
- Yes. Most web-based QR scanners accept image uploads. Screenshot the code and upload it — this avoids the camera entirely and works great for codes in PDFs and documents.
- Why will the Mac camera not focus on a QR code?
- Mac webcams are fixed-focus and tuned for faces at desk distance. Hold the code 40 to 60 cm away under good light. For small codes, photograph them with your phone and decode the photo instead.