VoxVera/docs/es/usage.md

Uso detallado

Esta guía cubre los flujos de trabajo de CLI comunes. Consulte docs/docker.md para obtener instrucciones de Docker y docs/templates.md para conocer las plantillas de volantes disponibles.

Prerrequisitos

VoxVera está diseñado para ser altamente portátil y requiere un mínimo de dependencias del sistema.

1. Binarios independientes (Recomendado)

Puede descargar binarios independientes sin dependencias para su sistema operativo:

• Linux: voxvera-linux
• Windows: voxvera-windows.exe
• macOS: voxvera-macos

Estos binarios incluyen todo lo necesario para ejecutar VoxVera (excepto onionshare-cli).

2. Instalador de una sola línea

Alternativamente, instale a través de nuestro script automatizado:

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

3. Instalación manual de Python

Si prefiere ejecutar desde la fuente:

pipx install 'voxvera@git+https://github.com/PR0M3TH3AN/VoxVera.git@main'
sudo apt install tor onionshare-cli   # Debian/Ubuntu

Paso a paso

1. Inicializar: Ejecute voxvera init y siga las instrucciones. Se le pedirá que seleccione su idioma primero.
2. Construir: Genere los activos del volante. Cada construcción crea automáticamente un voxvera-portable.zip en la carpeta del volante, lo que permite que otros descarguen la herramienta completa directamente desde su volante.

   voxvera build
   

3. Servir: Publique el volante sobre Tor:

   voxvera serve
   

   Esto detecta automáticamente su instancia de Tor, inicia OnionShare y escribe la dirección .onion generada en los enlaces desprendibles del volante.

Soporte de idiomas

VoxVera está totalmente localizado. Puede cambiar su preferencia de idioma de forma permanente utilizando el selector interactivo o un acceso directo:

• Selector interactivo: voxvera lang
• Acceso directo: voxvera --lang es (establece la preferencia en español)

Idiomas soportados:

• Inglés: en
• Español: es (alias: --idioma)
• Alemán: de (alias: --sprache)
• Ruso: ru
• Hebreo: he
• Árabe: ar
• Francés: fr
• Japonés: ja
• Hindi: hi
• Swahili: sw

También puede forzar un idioma específico para un solo comando sin cambiar su preferencia permanente:

• Inglés: voxvera --lang en check
• Español: voxvera --idioma es check

Los volantes generados detectan automáticamente el idioma del navegador del visitante y cambian el texto de la interfaz en consecuencia.

Gestión de servidores

Gestione múltiples volantes y sus identidades de Tor desde un único menú interactivo:

voxvera manage

Características:

• --- Crear Nuevo Sitio/Volante ---: Inicie la secuencia de configuración completa.
• --- Iniciar Todos los Sitios ---: Inicie o apague todos los volantes de su flota a la vez.
• Estado en tiempo real: Vea las URL .onion activas e indicadores de progreso de arranque de Tor.
• Control individual: Exportar a Zip sitios específicos a ZIP o elimínelos.

Espejo universal (Distribución viral)

Para garantizar que VoxVera siga siendo accesible incluso si los repositorios centrales son censurados, cada volante actúa como un espejo para la herramienta.

Cuando hospeda un volante, el botón "Descargar Herramienta y Código" en la página de inicio proporciona un voxvera-portable.zip que contiene:

• El código fuente completo y todos los idiomas soportados.
• Todas las dependencias de Python (pre-vendeurizadas).
• Binarios de Tor multiplataforma.

Esto permite que cualquier persona que escanee su volante se convierta en un nuevo distribuidor de la herramienta VoxVera.

Exportación y respaldo

Haga una copia de seguridad de sus identidades únicas de Tor (para que su URL .onion nunca cambie) o mueva sus volantes a otra máquina.

• Exportar un solo sitio: voxvera export <nombre_carpeta>
• Exportar todos los servicios: voxvera export-all

Lugar de almacenamiento: Todas las exportaciones se guardan como archivos ZIP en una carpeta llamada voxvera-exports en el directorio de inicio del usuario (~/voxvera-exports/) en todas las plataformas.

Importación y recuperación

Restaure toda su configuración en una nueva máquina moviendo sus archivos ZIP a ~/voxvera-exports/ y ejecutando:

voxvera import-multiple

Portabilidad y uso sin conexión

Si necesita ejecutar VoxVera en una máquina sin acceso a Internet, primero puede "vendeurizar" las dependencias:

voxvera vendorize

Esto descarga todas las librerías de Python requeridas en voxvera/vendor/. La herramienta dará prioridad a estos archivos locales, lo que le permitirá ejecutarse sin pip install.

Importación por lotes (JSON)

Para generar volantes de forma masiva a partir de múltiples archivos de configuración JSON, colóquelos en el directorio imports/ y ejecute:

voxvera batch-import

Cómo funcionan las URL

Cada volante tiene dos URL separadas:

• Enlace desprendible (generado automáticamente): La dirección .onion donde se hospeda el volante.
• Enlace de contenido (configurado por el usuario): Una URL externa que apunta a un sitio web, video o descarga.

No es necesario ingresar manualmente la dirección .onion; VoxVera lo maneja automáticamente durante la fase de serve.