VoxVera Flyers
VoxVera provides scripts and templates for producing printable flyers with QR codes. These flyers link to content hosted through Tor and can also include a Nostr page. The project automates building the HTML, generating the QR codes, and copying all assets into a directory under host/ so they can be served statically.
Prerequisites
- Node.js and npm
- jq
- qrencode
- ImageMagick (
convert) - javascript-obfuscator and html-minifier-terser (installed via npm)
- pdftotext (optional, used when extracting fields from a PDF form)
Installing Dependencies
On Debian or Ubuntu systems you can install the required packages with:
sudo apt update
sudo apt install -y jq qrencode imagemagick poppler-utils nodejs npm
The obfuscation scripts also rely on a pair of Node modules. Install them globally:
npm install -g javascript-obfuscator html-minifier-terser
A helper script setup.sh is provided to check for these dependencies and
install anything that is missing.
Generating a Flyer
Run the helper script from the repository root:
# interactive prompts
./src/create_flyer.sh
# use answers from an existing PDF form
./src/create_flyer.sh --from-pdf path/to/form.pdf
The script updates src/config.json, regenerates QR codes, obfuscates index-master.html and nostr-master.html, and copies the resulting files plus PDFs and QR images into host/<subdomain>. The contents in that directory can then be hosted.
Additional documentation is available in the src/ directory; see src/README.md for more details on the obfuscation scripts and additional usage notes.
Step-by-Step
- Edit
src/index-master.htmlorsrc/nostr-master.htmlif you need custom content. - Run
./src/create_flyer.shand follow the prompts, or use./src/create_flyer.sh --from-pdf path/to/form.pdf. - Host the generated
host/<subdomain>directory. This project is licensed under the MIT License.