· English · 繁體中文 · 简体中文 · Español · Português (Brasil) · 日本語 · 한국어 · Français · Deutsch · Русский ·
Press a shortcut → every QR code on your screen gets a label → press Enter.
Works with your webcam too. Free, open source and private.
📘 User manual: PDF · .docx — also attached to every release. Other languages are in docs/manual.
| ⚡ Easy to use | Press Ctrl+Alt+Q, or click the tray icon, to freeze the screen. A quick scan sweep finds every code automatically. |
| 🏷️ Link labels | Each code shows the real site name. Enter opens it, Tab moves to the next one, C copies. |
| ✂️ Select an area | When a code is tiny, blurry or tilted, drag a box around it like a snipping tool. |
| 📷 Webcam | Hold a printed code or a phone screen up to the camera; results appear live. |
| 🛡️ Link safety | Never opens a link by surprise. Warns about look-alike letters, disguised addresses (bank.com@evil.io), raw IP addresses, unencrypted http, short links and more — all offline. |
| 📶 Understands the content | Wi-Fi (connect with one click), contacts (save as vCard), email, phone, SMS, map locations, 2-step verification keys, Taiwan e-invoices (both codes merged) and plain text. |
| 🧾 Barcodes | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… |
| 🖼️ Images & clipboard | Scan a screenshot you copied or any image file. |
| 🔳 Simple QR generator | Turn a link or text into a QR code; copy it or save PNG/SVG. |
| 🧰 Toolbar & bubble | A clean floating toolbar — a row at the top or a column at the right or left edge — that collapses into a bubble and hides automatically during full-screen apps. |
| 🎨 Native look | Windows style, follows light/dark mode and your accent colour. |
| 🌍 10 languages | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. |
| 🔒 Private | Everything runs on your computer. No account, no telemetry, no online link checks. History is off by default. |
| ☁️ Light and fast | A native Rust core, with faster performance and lower memory use. |
flowchart LR
subgraph Triggers
HK[Global shortcut] --> D
TR[Tray icon / menu] --> D
TB[Toolbar / bubble] --> D
CLI["qrcode-tool scan-screen<br/>(IPC, e.g. Wayland)"] --> D
end
D{{Dispatcher}} --> CAP[Capture all monitors<br/>xcap]
D --> CAM[Webcam<br/>nokhwa]
D --> IMG[Image / clipboard]
CAP --> OV[Frozen full-screen overlay<br/>per monitor]
CAP --> DEC
CAM --> DEC
IMG --> DEC
DEC[Decode<br/>zxing-cpp + upscale + tiles] --> CLS[Classify payload<br/>URL · Wi-Fi · vCard · e-invoice…]
CLS --> SAFE[Link safety analysis<br/>offline]
SAFE --> UI[Pills & detail card<br/>Slint]
UI -->|Enter / click| ACT[Open in browser · Connect Wi-Fi · Save contact · Copy]
The app is a Cargo workspace: a thin UI crate on top of small, testable libraries. See docs/ARCHITECTURE.md for threads, data flow and design decisions.
Technical details (click to expand)
- zxing-cpp reads the frozen screenshot of each monitor in parallel.
- Small screens are also read at 2× scale; large screens are additionally split into overlapping 900 px tiles, so a small code on a 4K monitor is still found.
- Region selection adds a quiet zone and upscales the crop 2–3×.
- The webcam decodes the newest frame on its own thread and a code has to be seen in three consecutive frames before it counts.
- The screen is captured first and every overlay shows that frozen picture. All coordinates stay in screenshot pixels and are scaled inside the UI, so mixed-DPI setups work without conversion bugs.
- Only
http/httpslinks can be opened; any other scheme is shown and can only be copied. - Nothing is passed to a shell. Links open with the system browser API.
- Warnings: unencrypted
http, user-info disguise (a.com@b.com), international domains (shows the punycode), mixed alphabets in one label, IP addresses, unusual ports, short links, very long or heavily encoded URLs, deep subdomain chains. - Links are never opened automatically unless they are the only code found, have no warnings, and the site is on your trusted list.
- Short links are not expanded online (that would tell the shortener what you scanned).
| Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | |
|---|---|---|---|---|
| Screen scan | ✅ | ✅ (Screen Recording permission) | ✅ | |
| Global shortcut | ✅ | ✅ | ✅ | ➖ bind qrcode-tool scan-screen in system settings |
| Hide in full-screen apps | ✅ | ➖ | ➖ | ➖ |
| Updates | in-app (Velopack) | in-app | in-app (AppImage) | in-app (AppImage) |
- 2-step verification secrets and Wi-Fi passwords are never written to history and never copied automatically.
- Logs contain events and errors only, never scanned content.
- Download
QRcodeTool-win-x64-Setup.exe(or…-arm64-…) from the latest release. - Run it. QRcode tool installs for your user only (no admin rights) and starts in the tray.
- Press Ctrl+Alt+Q to scan (change it in Settings › Shortcuts if another app already uses it). Right-click the desktop or a picture for the same tools (Settings › General › Right-click menu). On Windows 11, open Show more options.
"Windows protected your PC"? Early releases are not code-signed yet, so SmartScreen may warn about an unknown publisher. Click More info → Run anyway. You can verify the download with the SHA-256 checksums published with every release. See the FAQ.
A portable .zip is available too (no installer, no automatic updates). The release also contains the user manual as PDF and Word, in English and Traditional Chinese.
Download the .pkg from the latest release. On first scan, allow Screen Recording (and Camera for webcam scanning) in System Settings › Privacy & Security. Releases are not notarized yet — right-click the app and choose Open the first time.
Download the .AppImage, make it executable and run it. On Wayland, add a keyboard shortcut in your desktop settings that runs qrcode-tool scan-screen.
git clone https://github.com/naritaroad/qrcode-tool
cd qrcode-tool
cargo run --releaseYou need Rust 1.85+, CMake and a C++ compiler (for zxing-cpp). Details for every platform: docs/BUILDING.md.
qrcode-tool start (or show the toolbar if already running)
qrcode-tool scan-screen scan the screen
qrcode-tool scan-region freeze the screen and drag a box
qrcode-tool scan-camera scan with the webcam
qrcode-tool scan-clipboard scan the image on the clipboard
qrcode-tool scan-file FILE scan one image file
qrcode-tool show-toolbar show the floating toolbar
qrcode-tool generate "TEXT" create a QR code
qrcode-tool decode FILE… [--json] decode images without the UI
qrcode-tool/
├─ app/ # The desktop app (Slint UI + glue)
│ ├─ src/ # tray, hotkeys, overlay, preview, settings, updater…
│ ├─ ui/ # .slint windows, widgets, icons
│ └─ translations/ # .po files for 9 languages
├─ crates/
│ ├─ qrtool-core/ # Payload parsing, link safety, settings, history (pure Rust)
│ ├─ qrtool-decode/ # zxing-cpp decoding strategy + QR generation
│ ├─ qrtool-capture/ # Multi-monitor screenshots (xcap)
│ ├─ qrtool-camera/ # Webcam capture + live decoding (nokhwa)
│ └─ qrtool-platform/ # OS integration: open, autostart, theme, Wi-Fi, IPC, clipboard, shell menu
├─ assets/icons/ # App and tray icons
├─ packaging/ # MSIX, Linux desktop entry, macOS bundle info
├─ docs/ # Architecture, building, FAQ, privacy, translations
│ └─ manual/ # User manual (PDF + Word, 10 languages) and its build scripts
└─ .github/workflows/ # CI and release pipeline
Contributions are welcome — bug reports, translations, code and ideas.
- Read CONTRIBUTING.md to get started.
- Improve a translation: docs/TRANSLATING.md (the current translations are machine translations that were reviewed; native speakers are very welcome).
- Found a security problem? Please follow SECURITY.md instead of opening a public issue.
- Everyone taking part is expected to follow the Code of Conduct.
If QRcode tool saves you time, you can sponsor the project. ❤️
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT license (LICENSE-MIT)
at your option. Unless you explicitly state otherwise, any contribution you submit for inclusion in this project shall be dual licensed as above, without any additional terms or conditions.
Third-party components and their licenses are listed in THIRD_PARTY_NOTICES.md. The user interface is built with Slint under the Slint Royalty-free Desktop License.
QRcode tool was inspired by these projects. No code was copied from them; thank you for showing what desktop QR scanning can be:
- qrpeek — screen QR code recognition tool
- ScreenQRScanner — on-screen QR code scanner
- QR-Code-Reader — Snipping Tool + ZXing.Net based reader
- NormCap — OCR-powered screen capture
- ShareX — screen capture suite with a QR code tool
- CodeTwo QR Code Desktop Reader — freeware desktop reader
Built on the shoulders of zxing-cpp, Slint, xcap, nokhwa, global-hotkey, Velopack and qrcode.
QR Code is a registered trademark of DENSO WAVE INCORPORATED. QRcode tool is not affiliated with DENSO WAVE, Google or Microsoft.







