Generate printable flyers with QR codes linking to Tor (.onion) hidden services. VoxVera is built for activists, journalists, and anyone who needs to spread a message securely and anonymously.

Installation

VoxVera is designed for maximum portability and censorship resistance.

Linux with systemd is the supported persistent-host deployment target. Windows, macOS, Docker, Flatpak, AppImage, Homebrew, and Chocolatey remain experimental until their background Tor hosting and auto-recovery paths are validated end-to-end.

See docs/platform-support-matrix.md for the canonical platform status table and docs/roadmap-platform-parity.md for the parity plan. For the supported Linux hosting path, use docs/linux-hosting-validation.md as the operational validation runbook.

1. Standalone Binaries (Recommended)

Download the executable for your OS:

2. Universal Mirroring (The "Viral" Method)

If you found a physical VoxVera flyer, scan it and click "Download". You will receive a voxvera-portable.zip containing the full tool, all dependencies, and all 14 languages—ready to run offline.

3. One-Line Installer (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/PR0M3TH3AN/VoxVera/main/install.sh | bash

On Linux, this now installs the recurring systemd --user recovery timer used to retry hidden-service startup after boot or offline periods. On macOS, the installer path is still experimental.

4. Developer / Python Install

pip install .
voxvera vendorize  # Optional: pull dependencies locally for offline use

5. Local Validation

Run the full local validation sweep with:

bash scripts/check.sh

This runs linting, Python tests, Electron smoke tests, dependency checks, and the docs/site rebuild steps used during development.

Key Features

Universal Mirroring: Every flyer acts as a mirror for the tool itself. The "Download" button provides a portable version of VoxVera, creating a decentralized distribution network.
Standalone Binaries: Zero-install executables for high-security environments.
Global Multi-Script Support: Native support for 14 languages including Arabic (RTL), Hebrew (RTL), Hindi (Devanagari), Japanese/Chinese (CJK), and Russian (Cyrillic).
Tor-Safe Architecture: 100% static HTML flyers. Works perfectly in Tor "Safest" mode with JavaScript completely disabled.
Integrated Server Manager: voxvera manage provides an interactive UI to handle multiple flyers, monitor Tor bootstrapping, and manage persistent .onion URLs.
Secure Migration: Bulk export and import of flyers and their unique Tor identity keys via ~/voxvera-exports/.

Documentation

VoxVera is available in multiple languages. Select your preferred language for the detailed usage guide:

Language	Documentation	Contributing	Agent Guide
🇺🇸 English	usage.md	CONTRIBUTING.md	AGENTS.md
🇪🇸 Español	usage.md	CONTRIBUTING.md	AGENTS.md
🇩🇪 Deutsch	usage.md	CONTRIBUTING.md	AGENTS.md
🇫🇷 Français	usage.md	CONTRIBUTING.md	AGENTS.md
🇷🇺 Русский	usage.md	CONTRIBUTING.md	AGENTS.md
🇮🇱 עברית	usage.md	CONTRIBUTING.md	AGENTS.md
🇸🇦 العربية	usage.md	CONTRIBUTING.md	AGENTS.md
🇯🇵 日本語	usage.md	CONTRIBUTING.md	AGENTS.md
🇮🇳 हिन्दी	usage.md	CONTRIBUTING.md	AGENTS.md
🇰🇪 Kiswahili	usage.md	CONTRIBUTING.md	AGENTS.md

Roadmap (v0.2.0)

We are actively working on:

PGP Signing: Cryptographic proof of tool integrity.
Nostr Integration: Automated social amplification.
Template Gallery: Visual styles for protests, alerts, and art.
Self-Healing Network: Automated decentralized updates.

See ROADMAP-v0.2.0.md for details.

README.md

VoxVera