qrtool-decode(1)
NAME
qrtool-decode - detect and decode a QR code
DESCRIPTION
This command detects and decodes a QR code from a raster or vector image. By default, the result will be output to standard output.
BMP (if enabled at compile time)
DDS (if enabled at compile time)
Farbfeld (if enabled at compile time)
GIF (if enabled at compile time)
Radiance RGBE (if enabled at compile time)
ICO (if enabled at compile time)
JPEG (if enabled at compile time)
OpenEXR (if enabled at compile time)
PNM (if enabled at compile time)
QOI (if enabled at compile time)
SVG (if enabled at compile time)
TGA (if enabled at compile time)
TIFF (if enabled at compile time)
WebP (if enabled at compile time)
XBM (if enabled at compile time)
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.
qrtool dec and qrtool d are aliases for this command.
POSITIONAL ARGUMENTS
- IMAGE
Input image file. If IMAGE is not specified, or if "-" is specified, the image will be read from standard input. Supported raster image formats are based on the formats supported by the
imagecrate. The format of IMAGE is determined based on the extension or the magic number if possible. If the format cannot be determined, use --type. Note that the SVG image is rasterized before scanning.
OPTIONS
- -t, --type FORMAT
The format of the input. If FORMAT is not specified, the format is determined based on the extension or the magic number.
- The possible values are:
- bmp
Windows Bitmap. This value is available if the
decode-from-bmpfeature is enabled at compile time.- dds
DirectDraw Surface. This value is available if the
decode-from-ddsfeature is enabled at compile time.- farbfeld
Farbfeld. This value is available if the
decode-from-fffeature is enabled at compile time.- gif
Graphics Interchange Format. This value is available if the
decode-from-giffeature is enabled at compile time.- hdr
Radiance RGBE. This value is available if the
decode-from-hdrfeature is enabled at compile time.- ico
ICO file format. This value also includes the CUR file format. This value is available if the
decode-from-icofeature is enabled at compile time.- jpeg
JPEG. This value is available if the
decode-from-jpegfeature is enabled at compile time.- openexr
OpenEXR. This value is available if the
decode-from-exrfeature is enabled at compile time.- png
Portable Network Graphics.
- pnm
Portable Anymap Format. This value is available if the
decode-from-pnmfeature is enabled at compile time.- qoi
Quite OK Image Format. This value is available if the
decode-from-qoifeature is enabled at compile time.- svg
Scalable Vector Graphics. This value also includes the gzip-compressed SVG image. This value is available if the
decode-from-svgfeature is enabled at compile time.- tga
Truevision TGA. This value is available if the
decode-from-tgafeature is enabled at compile time.- tiff
Tag Image File Format. This value is available if the
decode-from-tifffeature is enabled at compile time.- webp
WebP. This value is available if the
decode-from-webpfeature is enabled at compile time.- xbm
X BitMap. This value is available if the
decode-from-xbmfeature is enabled at compile time.
- --verbose
Also print the metadata. It is output to stderr. This option conflicts with --metadata.
- --metadata
Print only the metadata. It is output to stderr. This option conflicts with --verbose.
- -h, --help
Print help message. The short flag (-h) will print a condensed help message while the long flag (--help) will print a detailed help message.
- -V, --version
Print version number. The long flag (--version) will also print the copyright notice, the license notice and where to report bugs.
EXIT STATUS
- 0
Successful program execution.
- 1
An error occurred.
- 2
An error occurred while parsing command-line arguments.
- 65
The input data was incorrect in some way.
- 66
An input file did not exist or was not readable.
- 69
A service is unavailable.
- 71
An operating system error has been detected.
- 74
An error occurred while doing I/O on some file.
- 77
You did not have sufficient permission to perform the operation.
EXAMPLES
- Detect and decode a QR code from the given image:
$ qrtool decode input.png
- Decode a QR code from the given WebP image:
$ qrtool decode -t webp input.webp
- Also print the metadata when decoding a QR code:
$ qrtool decode --verbose input.qoi
COPYRIGHT
Copyright © 2022 Shun Sakai and other contributors
This program is distributed under the terms of either the Apache License 2.0 or the MIT License.
This manual page is distributed under the terms of the Creative Commons Attribution 4.0 International Public License.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.