Name | pawpyrus JSON |
Version |
2024.3.24.0
JSON |
| download |
home_page | None |
Summary | A minimalist paper data storage based on QR codes |
upload_time | 2024-03-24 14:53:15 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.11 |
license | None |
keywords |
aruco
qr
data storage
paper
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
![Logo](logo.svg)
## 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).
Further, the paper data storage can be scanned and decoded (recommended resolution 300dpi).
It can be useful if you need to backup data on paper:
* Encryption keys (e.g. [GnuPG](https://gnupg.org))
* File-based password databases (e.g. [KeePassXC](https://keepassxc.org))
* Cryptocurrency wallets
## Usage
**NOTE:** Backward compatibility is not provided yet.
Encoder:
```bash
pawpyrus Encode -n "Description" -i "input.file" -o "output.pdf"
```
Also, pawpyrus can read data from stdin.
For example, encoding GPG public keys:
```bash
gpg --export 0xDEADBEEF | pawpyrus Encode -n "My pubkey" -i - -o "my-pubkey.pdf"
```
Decoder:
```bash
pawpyrus Decode -i "scan1.jpg" "scan2.png" "scan3.jpg" "masked/too/*.png" -o "output.file"
```
## Data Format
Pawpyrus uses a custom alphanumeric encoding, which is designed to store information in QR code effectively.
For now, that makes 4.3kb per A4 page (pixel size 0.6 mm).
## Got a Trouble?
**QR and ArUco detectors may fail on one or several blocks.**
The situation is totally normal, although uncomfortable.
I fixed it for now, with two detectors ([opencv](https://github.com/opencv/opencv-python) and [pyzbar](https://github.com/NaturalHistoryMuseum/pyzbar)) instead of one, but the bug may reappear in some circumstances.
That's why I implemented Debug Mode:
```bash
pawpyrus Decode -d "debug_dir" -i "scan1.jpg" "scan2.jpg" "scan3.jpg" -o "output.file"
```
With Debug Mode, you can inspect undetected QR codes, read them manually with any device you have, and create a file with text blocks which can be processed as well:
```bash
pawpyrus Decode "scan1.jpg" "scan2.jpg" "scan3.jpg" -t "unrecognized_codes.txt" -o "output.file"
```
## Similar Projects
1. [intra2net/paperbackup](https://github.com/intra2net/paperbackup)
2. [Paperback by Olly](https://ollydbg.de/Paperbak/) and [Wikinaut/paperback-cli](https://github.com/Wikinaut/paperback-cli)
3. [colorsafe/colorsafe](https://github.com/colorsafe/colorsafe)
4. [Twibright Optar](http://ronja.twibright.com/optar)
5. [Paperkey](https://www.jabberwocky.com/software/paperkey)
6. [4bitfocus/asc-key-to-qr-code](https://github.com/4bitfocus/asc-key-to-qr-code)
Raw data
{
"_id": null,
"home_page": null,
"name": "pawpyrus",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ArUco, QR, data storage, paper",
"author": null,
"author_email": "Ellie Viesn\u00e1 <heathen_goldfish@proton.me>",
"download_url": null,
"platform": null,
"description": "![Logo](logo.svg)\n\n## Description\n\nPawpyrus is a minimalist open-source paper data storage based on QR codes and ArUco.\nIt generates a PDF from any small-sized binary file (recommended size <100kb).\nFurther, the paper data storage can be scanned and decoded (recommended resolution 300dpi).\n\nIt can be useful if you need to backup data on paper:\n\n* Encryption keys (e.g. [GnuPG](https://gnupg.org))\n* File-based password databases (e.g. [KeePassXC](https://keepassxc.org))\n* Cryptocurrency wallets\n\n## Usage\n\n**NOTE:** Backward compatibility is not provided yet.\n\nEncoder:\n\n```bash\npawpyrus Encode -n \"Description\" -i \"input.file\" -o \"output.pdf\"\n```\n\nAlso, pawpyrus can read data from stdin.\nFor example, encoding GPG public keys:\n\n```bash\ngpg --export 0xDEADBEEF | pawpyrus Encode -n \"My pubkey\" -i - -o \"my-pubkey.pdf\"\n```\n\nDecoder:\n\n```bash\npawpyrus Decode -i \"scan1.jpg\" \"scan2.png\" \"scan3.jpg\" \"masked/too/*.png\" -o \"output.file\"\n```\n\n## Data Format\n\nPawpyrus uses a custom alphanumeric encoding, which is designed to store information in QR code effectively.\nFor now, that makes 4.3kb per A4 page (pixel size 0.6 mm).\n\n## Got a Trouble?\n\n**QR and ArUco detectors may fail on one or several blocks.**\nThe situation is totally normal, although uncomfortable.\nI fixed it for now, with two detectors ([opencv](https://github.com/opencv/opencv-python) and [pyzbar](https://github.com/NaturalHistoryMuseum/pyzbar)) instead of one, but the bug may reappear in some circumstances.\nThat's why I implemented Debug Mode:\n\n```bash\npawpyrus Decode -d \"debug_dir\" -i \"scan1.jpg\" \"scan2.jpg\" \"scan3.jpg\" -o \"output.file\"\n```\n\nWith Debug Mode, you can inspect undetected QR codes, read them manually with any device you have, and create a file with text blocks which can be processed as well:\n\n```bash\npawpyrus Decode \"scan1.jpg\" \"scan2.jpg\" \"scan3.jpg\" -t \"unrecognized_codes.txt\" -o \"output.file\"\n```\n\n## Similar Projects\n\n1. [intra2net/paperbackup](https://github.com/intra2net/paperbackup)\n2. [Paperback by Olly](https://ollydbg.de/Paperbak/) and [Wikinaut/paperback-cli](https://github.com/Wikinaut/paperback-cli)\n3. [colorsafe/colorsafe](https://github.com/colorsafe/colorsafe)\n4. [Twibright Optar](http://ronja.twibright.com/optar)\n5. [Paperkey](https://www.jabberwocky.com/software/paperkey)\n6. [4bitfocus/asc-key-to-qr-code](https://github.com/4bitfocus/asc-key-to-qr-code)\n",
"bugtrack_url": null,
"license": null,
"summary": "A minimalist paper data storage based on QR codes",
"version": "2024.3.24.0",
"project_urls": {
"Bug Tracker": "https://git.disroot.org/spable/pawpyrus/issues",
"Homepage": "https://git.disroot.org/spable/pawpyrus"
},
"split_keywords": [
"aruco",
" qr",
" data storage",
" paper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "323be32e59c6e95620a71b96fc9e0aff3c8f2141eab4defc379eb531dfaa67c6",
"md5": "f65c2d2bd10993dc2eff50093652b09e",
"sha256": "4276b180fb6c1082633022920830edd790b004e662e8c08bcdc09792c46f11ef"
},
"downloads": -1,
"filename": "pawpyrus-2024.3.24.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f65c2d2bd10993dc2eff50093652b09e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 22938,
"upload_time": "2024-03-24T14:53:15",
"upload_time_iso_8601": "2024-03-24T14:53:15.556954Z",
"url": "https://files.pythonhosted.org/packages/32/3b/e32e59c6e95620a71b96fc9e0aff3c8f2141eab4defc379eb531dfaa67c6/pawpyrus-2024.3.24.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-24 14:53:15",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pawpyrus"
}