Skip to content

About

🔗 Scan QR codes on your screen or webcam as easily as on your phone. One shortcut, every code labeled, links checked offline. 🔗 讓您如同使用手機般在電腦上輕鬆快速使用QR Code。快捷鍵便利使用,條碼連結清楚標示,連結安全性在本機檢查。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

QRcode tool

QRcode tool — Scan QR codes on your computer as easily as on your phone.

CI Release Downloads License Platforms Rust Made with Slint Languages Privacy

· 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.

Screen scan: every code on the screen gets a pill with its site name


Features

⚡ 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.

Demo

A short http link is flagged before opening Suspicious links show why — and wait for you. Wi-Fi code with connect button Wi-Fi codes connect with one click; the password stays hidden.
Scanning a picture from the clipboard Scan the clipboard or an image file. Create a QR code Create a QR code.
Settings Windows 11-style settings. Dark mode Follows dark mode and your accent colour.

Architecture

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]
Loading

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)

Decoding strategy

  • 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.

DPI and multiple monitors

  • 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.

Link safety rules

  • Only http/https links 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).

Platform notes

Windows 10 21H2+ / 11 macOS 13+ Linux X11 Linux Wayland
Screen scan ✅ ✅ (Screen Recording permission) ✅ ⚠️ via portal / compositor
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)

Sensitive data

  • 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.

Installation

Windows 10 (21H2+) / 11 — x64 and ARM64

  1. Download QRcodeTool-win-x64-Setup.exe (or …-arm64-…) from the latest release.
  2. Run it. QRcode tool installs for your user only (no admin rights) and starts in the tray.
  3. 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.

macOS 13+ (Apple silicon and Intel)

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.

Linux

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.

Build from source

git clone https://github.com/naritaroad/qrcode-tool
cd qrcode-tool
cargo run --release

You need Rust 1.85+, CMake and a C++ compiler (for zxing-cpp). Details for every platform: docs/BUILDING.md.

Command line

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

Project Structure

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

Contribution

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. ❤️

License

Licensed under either of

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.

Related projects

QRcode tool was inspired by these projects. No code was copied from them; thank you for showing what desktop QR scanning can be:

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.

About

🔗 Scan QR codes on your screen or webcam as easily as on your phone. One shortcut, every code labeled, links checked offline. 🔗 讓您如同使用手機般在電腦上輕鬆快速使用QR Code。快捷鍵便利使用,條碼連結清楚標示,連結安全性在本機檢查。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages