wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2025 winget.ragerworks.com

Loading...
Install qrtool using Winget - wingetCollections
  1. Go back
  2. Packages
  3. qrtool
qrtool logo

qrtool Shun Sakai

cli command-line command-line-tool microqrcode qrcode qrcode-generator qrcode-reader qrcode-scanner rmqrcode rust rust-lang terminal tool
Use this command to install qrtool:
winget install --id=sorairolake.qrtool -e

Description of qrtool

qrtool is a versatile command-line utility designed for encoding and decoding QR codes. Its primary function allows users to convert text or data into QR codes and decode them back efficiently. The tool is known for its flexibility and robustness, making it suitable for various use cases.

Key Features:

  1. Multiple Image Formats Support: qrtool supports a wide range of image formats, including PNG (default), SVG, EPS, PIC, ANSI, ASCII, Unicode, and more. This versatility allows users to generate QR codes in vector graphics or terminal-friendly formats.

  2. Micro QR and rMQR Code Generation: In addition to standard QR codes, qrtool can generate Micro QR and rMQR codes, providing options for different encoding needs and use cases.

  3. Color Customization: Users can customize the foreground and background colors of generated images using CSS color strings, offering a personalized touch to their QR code outputs.

  4. Shell Completions: qrtool provides shell completions for popular shells like bash, zsh, fish, and others, enhancing user experience by offering command suggestions.

  5. Standard Input/Output Integration: The tool reads from standard input and writes to standard output, making it ideal for use in scripts or automated workflows.

  6. External Tool Integration: qrtool integrates seamlessly with external tools like oxipng for image optimization, allowing users to reduce file sizes without compromising quality.

Audience & Benefit:

Ideal for developers, system administrators, and CLI enthusiasts who need a reliable tool for integrating QR code functionality into their scripts or workflows. qrtool offers flexibility, customization, and efficiency, all without the need for graphical interfaces. Its command-line nature makes it perfect for automation and scripting environments, ensuring seamless integration into existing processes.

README

qrtool

CI Version MSRV License REUSE status

qrtool is a command-line utility for encoding or decoding QR code.

Demo animation

Installation

From source

cargo install qrtool

Via a package manager

Packaging status

OSPackage managerCommand
AnyHomebrewbrew install qrtool
AnyNixnix-env -iA nixpkgs.qrtool
Arch LinuxPacmanpacman -S qrtool
openSUSEZypperzypper install qrtool

From binaries

The release page contains pre-built binaries for Linux, macOS and Windows.

How to build

Please see BUILD.adoc.

Usage

Basic usage

Encode a string in a QR code:

qrtool encode "QR code" > output.png

Generate this image:

Versions
0.13.1
Website
github.com
License
Last updated
11/7/2025
Download latest version

Output

Decode a QR code from this image:

$ qrtool decode output.png
QR code

Output formats

Use -t option to change the format of the generated image.

The format is:

  • png (default)
  • svg
  • eps (Encapsulated PostScript)
  • pic (PIC markup language)
  • ansi (to the terminal using 4-bit ANSI escape sequences)
  • ansi256 (to the terminal using 8-bit ANSI escape sequences)
  • ansi-true-color (to the terminal using 24-bit ANSI escape sequences)
  • ascii (to the terminal as ASCII string)
  • ascii-invert
  • unicode (to the terminal as UTF-8 string)
  • unicode-invert

Encode to a SVG image:

qrtool encode -o output.svg -t svg "QR code"

Generate this image:

Output

Generate a PDF file from the PIC code:

qrtool encode -t pic "QR code" \
    | awk 'BEGIN { print ".vs 0\n.po 0\n.PS" } END { print "scale = 25.4 * 3\n.PE" } { print }' \
    | groff -Tpdf -p -P-p3i,3i \
    > output.pdf

Output to the terminal as UTF-8 string:

qrtool encode -t unicode "QR code"

Micro QR code or rMQR code generation

Use --variant option to change the variant of the generated QR code. The variant is normal (default), micro (Micro QR code), or rmqr (rMQR code).

qrtool encode --variant micro "QR code" > output.png

Generate this image:

Output

qrtool encode --variant rmqr "QR code" > output.png

Generate this image:

Output

Colored output

Use --foreground and --background options to change the foreground and background colors of the generated image. These options takes a CSS color string such as brown, #a52a2a or rgb(165 42 42). The default foreground color is black and the background color is white of CSS's named colors.

qrtool encode --foreground brown --background lightslategray "QR code" > output.png

Generate this image:

Output

Colored output is also available when the output format is any ANSI escape sequences:

qrtool encode -t ansi-true-color --foreground brown --background lightslategray "QR code"

Note that lossy conversion may be performed depending on the color space supported by the method to specify a color, the color depth supported by the output format, etc.

Supported input image formats

qrtool decode supports decoding a QR code from the following image formats:

  • BMP
  • DDS
  • Farbfeld
  • GIF
  • Radiance RGBE
  • ICO1
  • JPEG
  • OpenEXR
  • PNG
  • PNM
  • QOI
  • SVG2
  • TGA
  • TIFF
  • WebP
  • XBM

To support decoding from SVG image, the decode-from-svg feature must be enabled at compile time. Note that the SVG image is rasterized before scanning.

Image formats other than PNG can be disabled by disabling the default feature, and can be enabled individually.

Use -t option to specify the image format. If this option is not specified, the image format is determined based on the extension or the magic number.

Input this WebP image:

Input

Decode a QR code from the WebP image:

$ qrtool decode input.webp
QR code
# or
$ qrtool decode -t webp input.webp
QR code

Generate shell completion

completion subcommand generates shell completions to standard output.

The following shells are supported:

  • bash
  • elvish
  • fish
  • nushell
  • powershell
  • zsh

Example:

qrtool completion bash > qrtool.bash

Integration with other programs

Both qrtool encode and qrtool decode can read from standard input and output to standard output.

Optimize the output image

The image output by qrtool encode is not optimized. For example, a PNG image is always output as the 32-bit RGBA format. If you want to reduce the image size or optimize the image, use an optimizer such as oxipng or svgcleaner.

Optimize the output PNG image:

qrtool encode "QR code" | oxipng - > output.png

Optimize the output SVG image:

qrtool encode -t svg "QR code" | svgcleaner -c - > output.svg

If the optimize-output-png feature is enabled, you can also use --optimize-png option and --zopfli option of this command to optimize output PNG image.

Reading and writing unsupported image formats

If you want to save the encoded image in an image format other than PNG or SVG, or decode an image in an unsupported image format, convert it using a converter such as ImageMagick.

Raster formats

Read Cargo.toml from standard input and save the encoded result as a XPM image:

cat Cargo.toml | qrtool encode | magick png:- output.xpm

Decode this image and print the result using bat:

magick output.xpm png:- | qrtool decode | bat -l toml
Vector formats

Read a string from standard input and save the encoded result as an EPS image:

echo "The quick brown fox jumps over the lazy dog." \
    | qrtool encode -t svg \
    | inkscape -p -o output.eps

Decode this image and print the result to standard output:

$ inkscape -o - --export-type svg output.eps | qrtool decode
The quick brown fox jumps over the lazy dog.

Command-line options

Please see the following:

  • qrtool(1)
  • qrtool-encode(1)
  • qrtool-decode(1)
  • qrtool-completion(1)

Source code

The upstream repository is available at .

Changelog

Please see CHANGELOG.adoc.

Contributing

Please see CONTRIBUTING.adoc.

Acknowledgment

This program is inspired by qrencode and zbarimg.

Home page

License

Copyright (C) 2022 Shun Sakai and contributors (see AUTHORS.adoc)

  1. This program is distributed under the terms of either the Apache License 2.0 or the MIT License.
  2. Some files are distributed under the terms of the Creative Commons Attribution 4.0 International Public License.

This project is compliant with version 3.3 of the REUSE Specification. See copyright notices of individual files for more details on copyright and licensing information.

Footnotes

  1. CUR is also supported. ↩

  2. SVGZ is also supported. ↩