pawpyrus 2022.8.7.3

A minimalist paper data storage based on QR codes

 

Description

pawpyrus is a minimalist open-source paper data storage based on QR codes and ArUco. It generates a PDF from any small-sized binary file (recommended size 100kb or less). Further, the paper data storage can be scanned and decoded (recommended resolution 300dpi or more).

It may be useful for:

• Storing encryption keys, password databases, etc.
• Faxing digital data

Installation

The script is pure Python and a part of PyPI, so can be installed via pip:

python3 -m pip install pawpyrus

Usage

File encoder:

pawpyrus Encode -n "Description" -i  "InputFile" -o "OutputPDF"

File decoder:

pawpyrus Decode -i "Scan1.jpg" "Scan2.jpg" "Scan3.jpg" -o  "OutputFile"

Got a trouble?

QR code detectors may fail on one or several blocks. This situation is totally normal, although uncomfortable. I fixed it for now, with two detectors instead of one, but the bug may reappear in some circumstances (if blocks number is big enough, or scans quality is low enough). That's why I implemented Debug Mode:

pawpyrus Decode -d "DebugDir" -i "Scan1.jpg" "Scan2.jpg" "Scan3.jpg" -o  "OutputFile"

With Debug Mode, you can inspect undetected QR codes, read them manually with any device you have, and create a file with codes contents which may be processed as well:

pawpyrus Decode "Scan1.jpg" "Scan2.jpg" "Scan3.jpg" -t "UnrecognizedCodes.txt" -o "OutputFile"

If you have any idea how to fix it better, please help.

Contact

You can contact me by email: [e-mail]