Skip to content

Repository files navigation

qrx

Selects a region of your screen, reads any QR code found in it, and copies the result to your clipboard.

2026-07-01.12-49-26.mp4

Installation

NixOS / Nix — NUR

Add the NUR channel if you haven't already:

nix-channel --add https://github.com/nix-community/NUR/archive/master.tar.gz nur
nix-channel --update

Then install:

# configuration.nix
environment.systemPackages = [
  nur.repos.x71c9.qrx
];

Or ad-hoc:

nix-env -f '<nixpkgs>' -iA nur.repos.x71c9.qrx

Linux — AUR (Arch Linux)

Build from source:

yay -S qrx

Or prebuilt binary:

yay -S qrx-bin

crates.io — Cargo

cargo install qrx

macOS — Homebrew

brew install x71c9/x71c9/qrx

Pre-built binaries

Download the latest release for your platform from the releases page.

Platform File
Linux x86_64 qrx-x86_64-unknown-linux-musl.tar.gz
macOS Apple Silicon qrx-aarch64-apple-darwin.tar.gz
macOS Intel qrx-x86_64-apple-darwin.tar.gz

Usage

qrx                        # crop screen region, copy to clipboard
qrx -p                     # crop screen region, print + copy to clipboard
qrx -pn                    # crop screen region, print only
qrx file.png               # decode image file, copy to clipboard
qrx -p file.png            # decode image file, print + copy to clipboard
qrx -pn file.png           # decode image file, print only

Flags

Flag Long Description
-p --print Print the decoded text to stdout
-n --no-clipboard Do not copy to clipboard

Flags can be combined separately (-p -n) or together (-pn / -np).

Clipboard

On Linux, the result is copied to both the system clipboard (Ctrl+V) and the primary selection (middle-click).

Dependencies

Platform Required
X11 xclip
Wayland slurp, grim, wl-copy
macOS

License

MIT

About

A small utility that selects a region of the screen, decodes any QR code found inside it, and copies the result to the clipboard. Image files can be decoded as well.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages