pawpyrus 2022.8.7

A minimalist paper data storage based on QR codes

pawpyrus

pawpyrus is a minimalist opensource paper data storage based on QR codes. It generates a PDF from any small-sized binary file. Further, scans of paper data storage can be decoded.

It may be useful for storing encryption keys, password databases, etc.

Installation

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

python3 -m pip install pawpyrus

Or manually:

git clone https://github.com/regnveig/pawpyrus
cd pawpyrus/dist
python3 -m pip install pawpyrus-2022.8.7-py3-none-any.whl

Usage

Encode file:

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

Decode scans:

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

Fair warning:

• Recommended size of file to encode: 100kb or less
• Recommended resolution of scans: 300dpi or more

Got a trouble?

QR code detector may fail on one or several blocks. This situation is totally normal, although uncomfortable. 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 which QR codes were not detected, read them manually with any device you have, and create a file with codes which may be processed as well:

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

Contact

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