https://github.com/coldcard/coldcard-paper-wallet-templator
Convert PDF template files into specialized PDF files the Coldcard can use to construct paper wallets
https://github.com/coldcard/coldcard-paper-wallet-templator
Last synced: about 1 year ago
JSON representation
Convert PDF template files into specialized PDF files the Coldcard can use to construct paper wallets
- Host: GitHub
- URL: https://github.com/coldcard/coldcard-paper-wallet-templator
- Owner: Coldcard
- Created: 2019-09-12T19:04:08.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-25T15:37:52.000Z (over 6 years ago)
- Last Synced: 2025-04-20T23:32:48.388Z (about 1 year ago)
- Language: Python
- Size: 871 KB
- Stars: 5
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Templator for Coldcard Paper Wallets
Just looking for some cool paper wallet templates? Go to [outputs subdir](outputs)
and take any of the PDF files for use on Coldcard. You can view them with normal
PDF programs, but they have been specially prepared for editing by the Coldcard.
# How It Works
- an artist creates the PDF with background artwork, blank spots for QR's
- locations for pubkey, privkey QR's and any text blocks are defined mm by mm, in `build.py`
- run `build.py` to add placeholders objects for the 2 QR codes, related variable text
- a template file--which looks and acts like a PDF---is constructed, in `./outputs`
- use the resulting (pdf) file on Coldcard via a MicroSD card
- the Coldcard can find what it needs inside the PDF template and will modify it with final values
## Design Tips
- you must include whitespace around the QR code: more the better, and should be fully 'quiet'
- QR will have background white with black pixels ... so do not place over gradient
# TODO
This project isn't done yet!
- [ ] make it easier to add new templates; pull meta data out of `build.py` into other files
- [ ] build a gallery of useful examples
- [ ] make many seasonal templates, starting with Nov/Dec holidays
# References
- [PDF 1.3?](https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/pdf_reference_archives/PDFReference.pdf)
- [PDF 1.7?](https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf)
- [ReportLab manual](https://www.reportlab.com/docs/reportlab-userguide.pdf)
# QR Sample images
- Made a zero-border verion 4 image here:
- With 8 pixels per module, like we will be doing.
- Edited with Preview.app
- Command to go from PNG with alpha and some text into simple PNM file:
`pngtopam -mix -background=#FFF qrsample-pk.png | pamditherbw -threshold | pamtopnm > qrsample-pk.pnm