VoxVera Flyers

Generate printable flyers with QR codes that link to Tor (.onion) or HTTPS sites, plus an optional Nostr address.

🎉 Quick Install (no Git, no pip hassles)

Download the prebuilt Linux binary

mkdir -p ~/.local/bin
wget -qO ~/.local/bin/voxvera \
  https://github.com/PR0M3TH3AN/VoxVera/releases/latest/download/voxvera
chmod +x ~/.local/bin/voxvera

Ensure $HOME/.local/bin is in your PATH Add this to your ~/.bashrc or ~/.zshrc if needed:
```
export PATH="$HOME/.local/bin:$PATH"
```
Run the CLI
```
voxvera quickstart
```

🛠️ From Source (for contributors)

If you want to hack on VoxVera, clone the repo and use a virtual env:

# 1. Clone the repo
git clone https://github.com/PR0M3TH3AN/VoxVera.git
cd VoxVera

# 2. Create & activate a Python venv
python3 -m venv .venv
source .venv/bin/activate

# 3. Install the package
pip install --upgrade pip
pip install .

# 4. Run
voxvera quickstart

📦 Docker (optional)

VoxVera is also on GitHub Container Registry:

docker pull ghcr.io/PR0M3TH3AN/voxvera:latest
mkdir flyers
docker run --rm -it -v "$(pwd)/flyers:/flyers" ghcr.io/PR0M3TH3AN/voxvera

Generated flyers land in ./flyers.

🚀 Usage

# Initialize a new flyer (interactive prompts)
voxvera init

# Build the HTML, QR codes & static files
voxvera build

# Host via OnionShare on Tor
voxvera serve

See voxvera check to verify you have tor, onionshare-cli, jq, qrencode, imagemagick, node, javascript-obfuscator, and html-minifier-terser.

📄 Docs

Full docs in the docs/ folder:

docs/usage.md — detailed CLI guide
docs/docker.md — Docker tips
docs/troubleshooting.md — common fixes

1.8 KiB Raw Blame History