mirror of
https://github.com/PR0M3TH3AN/VoxVera.git
synced 2026-10-27 09:40:40 +00:00
thePR0M3TH3AN
69ca9f6411
- Separated internal ROOT from persistent DATA_DIR to prevent user sites from being saved to the volatile PyInstaller _MEIPASS temp directory. - Updated unit tests to correctly mock DATA_DIR and ensure complete isolation between tests. - Fixed binaries.yml and requirements.txt to correctly bundle the pinned Flask/Werkzeug versions, preventing onionshare-cli import failures in the standalone binary.
VoxVera
Anonymous Information Distribution Engine
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.
1. Standalone Binaries (Recommended)
Download the zero-dependency 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
4. Developer / Python Install
pip install .
voxvera vendorize # Optional: pull dependencies locally for offline use
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 manageprovides 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.
License
MIT (c) 2026 thePR0M3TH3AN