Guía de usuario

1. Barra lateral (Panel de navegación)

La barra lateral es la barra de navegación permanente en el lado izquierdo de la aplicación, que cuenta con un diseño de modo oscuro.

1.1 Logotipo

El logotipo de Zenith se muestra en la parte superior de la barra lateral (Flecha + Montaña + letras "ZENITH"). El logotipo sirve como identificación visual de la marca.

1.2 Menú de navegación

Debajo del logotipo se encuentra la lista de navegación vertical. Las entradas se dividen en grupos lógicos, separados por espaciadores invisibles:

Áreas principales

Conexión

Automatización

Notificaciones

Sistema

Estilo de estado activo

• Seleccionado: color de texto cian con un borde cian izquierdo y un fondo oscuro
• Colocar el cursor sobre: ​​Color del texto ligeramente iluminado
• Normal: gris violeta apagado

1.3 Bloqueo de administrador (🔓 Admin)

El botón de bloqueo de administrador se encuentra en el borde inferior de la barra lateral. Esto permite a un administrador bloquear pestañas específicas con una contraseña para evitar modificaciones no autorizadas.

Las pestañas bloqueadas están marcadas con un símbolo 🔒 y solo se puede acceder a ellas después de ingresar la contraseña de administrador.

1.4 Aviso de demostración

En el modo DEMO, se muestra un cuadro de advertencia naranja en la parte inferior de la barra lateral:

⚠ DEMO VERSION
Restricted functions
Upgrade for full access

2. Dashboard (Centro de control)

El Dashboard es la página de inicio de la aplicación, que proporciona una descripción general de un vistazo de todos los sistemas críticos. Es desplazable y se actualiza automáticamente cada 3 segundos.

2.1 Tarjeta de estado VPN (ancho completo, arriba)

La tarjeta VPN muestra el estado de conexión actual y permite activar/desactivar la VPN directamente desde el dashboard.

Elementos

Estados

Comportamiento

• Al activarse, primero verifica si una interfaz VPN está configurada.
• En caso de error, el interruptor se restablece automáticamente.
• El estado se sincroniza automáticamente con la pestaña VPN Guard.

2.2 Tarjeta de cola (izquierda, área principal)

La tarjeta de cola ocupa la mayor parte del dashboard y presenta dos subpestañas: Carga y Descarga.

2.2.1 Cargar página

Muestra todas las tareas de carga en la cola como una lista desplazable.

Entradas de tareas

Cada tarea se muestra como una fila que contiene la siguiente información: - Nombre de la tarea (por ejemplo, rudirudi5 (séptima copia)) - Tamaño del archivo (por ejemplo, 656,9 MB) - Estado (Pendiente/Embalaje/Cargando/Completado/Error/Pausado) - Barra de progreso (0–100%) - Velocidad (para cargas activas)

Al hacer clic en una fila, se selecciona la tarea (resaltada en azul), lo que permite iniciarla individualmente.

Botones

Lógica de 3 estados: el botón principal alterna entre "Start All" → "Pause All" → "Resume All", de manera idéntica a la pestaña Descarga.

2.2.2 Página de descarga

Muestra todas las tareas de descarga (importaciones NZB) en la cola.

2.3 Carpetas vigiladas (arriba a la derecha)

Muestra todas las carpetas monitoreadas configuradas (Watchfolders) con interruptores individuales.

Comportamiento - Desactivar: Elimina de la cola todas las tareas pendientes de esta carpeta. - Activando: Reinicia el mecanismo de vigilancia y escanea la carpeta en busca de archivos existentes. - Las carpetas se agregan/eliminan a través de Configuración → Carpetas vigiladas. - Si no hay carpetas configuradas: "No hay carpetas de seguimiento configuradas".

2.4 Monitor de espacio en disco (abajo a la derecha)

Muestra el consumo de almacenamiento actual y contiene varias subsecciones.

2.4.1 Uso del disco

2.4.2 Caché

2.4.3 Modo RAM

Debajo de una línea divisoria violeta se encuentra el indicador de modo RAM:

Modo RAM: cuando está habilitado, las tareas de carga se procesan en la RAM (tmpfs en /dev/shm) en lugar de en el disco duro. Esto acelera significativamente las operaciones de empaquetado y PAR2, pero requiere suficiente memoria libre.

2.4.4 Prueba de velocidad

2.5 Barra de título (personalizada)

Zenith utiliza su propia barra de título de ventana sin marco en el borde superior:

2.6 Barra de estado (abajo)

En el borde inferior de la ventana se encuentra la barra de estado permanente:

2.7 Icono de la bandeja del sistema

Zenith muestra un icono en la bandeja del sistema en la barra de tareas (al lado del reloj): - Clic derecho: menú contextual con Mostrar/Ocultar, Pausar/Reanudar, Salir - Clic izquierdo: Mostrar/ocultar ventana - Cuando la opción "Minimizar a bandeja" está habilitada, cerrar la ventana solo la oculta.

2.8 Banner publicitario (solo DEMO)

En el modo DEMO, se muestra un banner publicitario giratorio encima del área de contenido (en todas las pestañas): - Gira cada 15 segundos - Muestra ofertas de actualización y anuncios de socios. - Desaparece después de la activación de la licencia

Pestaña de carga — Cola de carga

La pestaña de carga es el centro neurálgico para gestionar todas las tareas de carga. Aquí se agregan archivos y carpetas, se controla el proceso de carga y se monitorea el progreso.

1. Vista general de la página

La pestaña está dividida verticalmente en las siguientes áreas: - Encabezado: título y descripción. - Barra de control: botón para agregar archivos - Zona de arrastrar y soltar: suelta archivos con el mouse - Cola de carga: tabla interactiva con todas las tareas - Cargar registro: protocolo de actividad en tiempo real

2. Encabezado

3. Barra de control

➕ Agregar carga ▾ (botón desplegable)

Un botón primario con un menú desplegable que ofrece dos opciones:

Los archivos/carpetas agregados se ponen en cola inmediatamente.

4. Zona de arrastrar y soltar

Debajo de la barra de control hay una zona de colocación discontinua:

📥 Arrastre y suelte archivos o carpetas aquí para cargar

Comportamiento - Normal: borde gris discontinuo - Al arrastrar el cursor: el borde cambia a cian con un ligero brillo de fondo - Después de soltar: los archivos se agregan automáticamente a la cola - Admite archivos y carpetas simultáneamente - Se pueden eliminar varios archivos a la vez

5. Cola de carga (Área principal)

La cola es una tabla interactiva ubicada dentro de una tarjeta oscura con esquinas redondeadas.

5.1 Encabezado de cola

5.2 Columnas de la tabla

5.3 Valores de estado

5.4 Botones de acción (por fila)

Cada fila presenta tres pequeños botones a la derecha:

Lógica del resplandor - Tarea activa (Embalaje/Carga): el botón Reproducir se ilumina en verde - Tarea en pausa: el botón de pausa se ilumina en naranja - Tarea completada/fallida: no brilla, los botones permanecen neutrales - Pendiente: Todos los botones neutrales (gris)

5.5 Barra de progreso neón

La barra de progreso es un widget personalizado (NeonProgressBar) que incluye: - Degradado de color de azul oscuro a cian y azul brillante - Efecto resplandor a la vanguardia del progreso. - Porcentaje mostrado como texto superpuesto

6. Botones de control global (debajo de la tabla)

Pausa elegante: al hacer una pausa, el paso de procesamiento actual (por ejemplo, empaquetar o cargar) se completa antes de que se detenga la tarea. Las conexiones NNTP activas no se cortan abruptamente.

Eliminación automatizada

Si "Eliminar automáticamente las cargas completadas" está habilitado en la configuración: - El botón " ✓ Ocultar completado" está atenuado y deshabilitado. - Aparece información sobre herramientas: "La eliminación automática está habilitada". - Las tareas completadas se eliminan automáticamente de la mesa después de 5 segundos.

7. Registro de carga

En el borde inferior de la pestaña hay un registro de protocolo en tiempo real dentro de su propia tarjeta:

Apariencia - Fondo: diseño de terminal oscuro con fuente monoespaciada - Desplazamiento automático: salta automáticamente a la entrada más reciente

Codificación de colores

Prefijos de entrada de registro - 📎 Archivo agregado a la cola - 📦 La tarea es empacar (7-Zip) - 🛡 Creación de PAR2 en ejecución - ⬆ Carga en curso - ✅ Tarea completada - ❌ Tarea fallida - ⚠ Advertencia (por ejemplo, sin selección) - ▶ Cola iniciada/reanudada - ⏸ Cola en pausa - 🗑 Tarea eliminada - ✓ Entradas completadas eliminadas

8. Procesamiento en canalización

El motor de carga en segundo plano funciona en modo canalizado:

Mientras se carga la tarea A, la tarea B ya puede comenzar a empaquetar.

• DiskGuard evita que se empaqueten demasiadas tareas simultáneamente (control de almacenamiento).
• ConnectionBudget gestiona las conexiones NNTP compartidas entre las tareas de carga y descarga.

9. Modo de tarea individual

Al hacer clic en el botón ▶ en una tarea individual o mediante el botón "▶ Iniciar única" en el panel, se puede iniciar una tarea aislada:

• Sólo se procesa la tarea seleccionada.
• La cola restante permanece en pausa.
• Al finalizar la tarea única, la cola vuelve automáticamente a un estado de pausa.
• Útil para pruebas o cargas de alta prioridad.

Pestaña de descarga — Descargador Usenet

La pestaña Descargar permite descargar archivos de Usenet a través de archivos NZB. Admite descargas de múltiples conexiones, detección automática de contraseñas, reparación PAR2, extracción 7-Zip y manejo del protocolo NZBLNK.

1. Vista general de la página

La pestaña está dividida verticalmente en las siguientes secciones: - Encabezado: título y descripción. - Tarjeta de importación NZB: archivo NZB/entrada de URL, contraseña, botón de cola - Cola de descarga: tabla con todas las tareas de descarga - Descargar registro: registro de actividad en tiempo real

2. Encabezado

3. Tarjeta de importación NZB

Una tarjeta redondeada que alberga el widget de importación para agregar nuevas descargas.

3.1 Zona de arrastrar y soltar

📎 Arrastre y suelte el archivo NZB aquí

• Normal: borde gris discontinuo
• Al arrastrar el cursor: el texto cambia a "¡📥 Suelta NZB aquí!", el borde se vuelve cian
• Acepta archivos .nzb exclusivamente

3.2 Campo de entrada NZB

Entradas admitidas - Archivo local: /home/user/downloads/example.nzb - URL: https://example.com/releases/example.nzb — descargado automáticamente - Portapapeles: las URL de NZB y los enlaces de NZBLNK se detectan automáticamente desde el portapapeles

3.3 Campo de contraseña

Detección automática de contraseña

El sistema extrae automáticamente las contraseñas del nombre de archivo NZB utilizando formatos comunes: - nombre de archivo {{contraseña}}.nzb - nombre de archivo [contraseña].nzb - nombre de archivo - contraseña.nzb

Tras la detección, el campo de contraseña se completa y registra automáticamente: 🔑 Contraseña detectada: p*****d

3.4 Botón de acción

➕ Agregar a la cola: agrega el archivo NZB a la cola de descarga. Solo se activa cuando se proporciona un archivo/URL NZB válido.

Nota: Este botón sólo pone en cola la tarea; no inicia la descarga automáticamente. La ejecución se maneja a través del botón Inicio separado.

4. Cola de descarga

4.1 Encabezado de cola

4.2 Tabla

Estructura de columnas idéntica a la cola de carga:

4.3 Valores de estado

4.4 Menú contextual del clic derecho

Al hacer clic con el botón derecho en una entrada de la cola, se muestra un menú contextual: - 🔑 Establecer/Cambiar contraseña: abre un cuadro de diálogo para ingresar o modificar la contraseña para esta descarga.

5. Botones de control

6. Registro de descarga

Seguimiento de registros en tiempo real idéntico a la pestaña Cargar: - Fondo: Diseño de terminal con fuente monoespaciada. - Codificación de colores: verde (éxito), rojo (error), gris (información)

Entradas de registro típicas - 📎 NZB agregado a la cola - 📥 Descarga de NZB desde URL - 📋 Enlace NZB detectado desde el portapapeles - 🔑 Contraseña detectada o configurada - 🔍 Buscando en Binsearch/NZBIndex/Newznab - ⬇ Descarga en progreso (seguimiento de progreso) - 🛡 Reparación PAR2 - 📦 Extracción - ✅ Descarga completada - ❌ Falló la descarga - ⏸ Descarga(s) pausada(s) - ▶ Descarga(s) reanudada(s)/iniciada(s)

7. Características especiales

7.1 Supervisión del portapapeles

Zenith monitorea automáticamente el portapapeles para detectar: - URL de NZB: los enlaces que contienen .nzb se cargan automáticamente en el campo de entrada. - Enlaces NZBLNK: nzblnk: los enlaces de protocolo se procesan automáticamente.

Esta función se puede desactivar en la configuración (dl_clipboard_monitor).

7.2 Soporte del protocolo NZBLNK

Zenith se registra como controlador del esquema nzblnk:URI. Al hacer clic en un enlace NZBLNK en un navegador: 1. Abra Zenith (o coloque la ventana existente en primer plano). 2. Procese el enlace automáticamente. 3. Busque el NZB en las siguientes fuentes (en orden): - Indexadores Newznab (si están configurados) - Binsearch.info (gratis, no se requiere clave API) - NZBIndex.com (gratuito, canal RSS) 4. Si se encuentra, el NZB se descarga y se agrega a la cola. 5. La contraseña incorporada en NZBLNK se aplica automáticamente.

7.3 Detección automática de contraseña

El sistema extrae contraseñas de: - Nombre de archivo NZB: patrones comunes como {{contraseña}}, [contraseña] - Datos NZBLNK: campo de contraseña dentro del URI de NZBLNK - Manual: Haga clic derecho → Establecer contraseña

7.4 Auto-Extracción

Una vez completada la descarga, el sistema ejecuta automáticamente: 1. Reparación PAR2: Repara los segmentos faltantes/dañados si es necesario (configurable). 2. Verificación CRC: verifica la integridad de la descarga (configurable). 3. Extracción 7-Zip: descomprime archivos (configurable). 4. Limpieza de archivos: elimina archivos RAR/7z después de la extracción (configurable). 5. Limpieza de basura: elimina archivos innecesarios como NFO, TXT, etc. (configurable).

7.5 Modo espejo

El modo espejo automatiza la recarga después de la descarga:

Descargar → Extracción → Carga automatizada mediante configuración idéntica

El estado cambia a Espejo: Cargando. Controlado a través de la pestaña Entrada remota o API.

7.6 Persistencia de la cola

La cola de descarga se guarda automáticamente y se restaura al reiniciar la aplicación. Las tareas pendientes sobreviven al cierre de aplicaciones.

7.7 Presupuesto de conexión

Las descargas y cargas dividen las conexiones NNTP dinámicamente a través del sistema ConnectionBudget: - Si se ejecuta una carga, las conexiones disponibles para descargas se reducen. - El modo de uso del proveedor (cargar/descargar/ambos) dicta la asignación. - Si el uso del proveedor está bloqueado en "Descargar", solo se implementan las conexiones de descarga.

8. Ajustes configurables

Las siguientes opciones se pueden personalizar en Configuración → Descargar:

Copia de seguridad en la nube — Backup cifrado de Usenet

La pestaña Copia de seguridad en la nube proporciona herramientas para cifrar carpetas usando AES-256, cargarlas en Usenet y recuperarlas más tarde. El archivo NZB resultante actúa como la "clave" de descifrado y restauración, viable siempre que la ventana de retención de Usenet permanezca abierta.

1. Vista general de la página

El diseño de la pestaña presenta cinco módulos de tarjeta distintos: - 📁 Fuentes de respaldo: administrar carpetas - 🔐 Cifrado y configuración: contraseñas y configuraciones - 📋 Historial de copias de seguridad: seguimiento del registro de archivos - 📥 Restauración: recuperación de datos impulsada por NZB - 📋 Registro de copia de seguridad: consola de registro en tiempo real

2. Fuentes de copia de seguridad (Tarjeta 1)

2.1 Lista de carpetas

Cada entrada de carpeta presenta una fila dedicada que contiene:

2.2 Ajustes por carpeta (desplegable)

2.3 Detección de cambios

Zenith monitorea las rutas de respaldo cada 5 minutos para detectar modificaciones: - Realiza un seguimiento de archivos nuevos, alterados o borrados. - Transiciones de estado a naranja: ⚠ 3 carpetas con datos de información sobre herramientas localizados. - Las copias de seguridad exitosas devuelven el estado a verde.

2.4 Botones

• ➕ Agregar carpeta: abre el selector de directorio para agregar una nueva fuente raíz de respaldo.
• ▶ Iniciar copia de seguridad ahora: activa instantáneamente una ejecución de archivo en todas las filas marcadas.

3. Cifrado y configuración (Tarjeta 2)

3.1 Lado izquierdo — Contraseña

⚠ Crítico: Pierde la contraseña, pierde la copia de seguridad. No existe ningún mecanismo de recuperación de contraseña ni de puerta trasera.

3.2 Lado derecho: configuración global

4. Historial de copias de seguridad (Tarjeta 3)

Un registro de seguimiento de archivos históricos:

5. Restauración (Tarjeta 4)

La recuperación de datos requiere tres entradas:

Flujo de trabajo de restauración: Descargar (archivos cifrados a través del proveedor) → Reparación PAR2 (verificaciones de redundancia del 20%) → Descifrado (descomprimido 7-Zip) → Archivos restaurados (salida de destino verificada)

Botón → 📥 Restaurar: inicia el proceso de recuperación.

6. Registro de copia de seguridad (Tarjeta 5)

Coincide con la implementación del registrador que se encuentra en los módulos principales de carga/descarga: - Estética terminal monoespacial. - Codificación de colores: Verde (Éxito), Rojo (Fracaso), Gris (Información).

Prefijos de registro - 📁 Ruta de respaldo registrada - 🔐 Cifrado activo - ✅ Tarea de criptografía/carga/descarga finalizada - 🛡 Procesamiento de generación PAR2 (20% de redundancia) - 📤 Carga de fragmentos de archivo - 📥 Extracción de fragmentos de archivo (Restauración) - ⏰ Programación operativa actualizada - ⚠ Umbral de retención alcanzado / Anomalía crítica activada - 🗑 Fuente de copia de seguridad eliminada

7. Funciones de automatización

7.1 Copias de seguridad programadas

• Los escaneos programados se repiten cada 60 segundos.
• Las tareas se activan solo si el tiempo delta transcurrido supera el intervalo especificado.

7.2 Advertencia de retención

• Los análisis se ejecutan cada 2 horas + inicialmente 5 segundos después del arranque.
• Las alertas aparecen 30 días antes de las fechas máximas de retención.
• Las acciones de alerta se reciclan cada 2 días hasta que se solucionan o silencian.

7.3 Detección de cambios

• Los análisis se repiten cada 5 minutos + inicialmente 10 segundos después del arranque.
• Compara los atributos de modificación del archivo con la matriz de ejecución anterior.
• Resalta los directorios modificados dentro de la información sobre herramientas de estado mediante indicadores naranjas.

8. Proceso de copia de seguridad (Especificación técnica)

8.1 Parámetros de cifrado

• Algoritmo: AES-256 (a través de la sintaxis del indicador 7-Zip -p).
• Ofuscación de encabezado: habilitada (-mhe=on): deja en blanco los nombres de los directorios internos.
• Umbrales divididos: volúmenes escalables (opciones de 10 a 2000 MB).
• Redundancia PAR2: la distribución absoluta del 20% del piso garantiza la resiliencia de la carga útil.

8.2 Modos de copia de seguridad

Pestaña Estadísticas: cargar y descargar estadísticas

La pestaña Estadísticas muestra una descripción general de todos los historiales de carga y descarga, representando datos a través de gráficos interactivos, tarjetas de métricas y listas históricas. Los datos se sondean directamente desde un motor SQLite local cada 5 segundos.

1. Vista general de la página

• Encabezado con filtros de marco temporal
• Cargar métricas: 6 bloques de seguimiento analítico
• Cargar gráficos de volumen: métricas de barra personalizadas
• Descargar Métricas: 6 bloques de seguimiento analítico
• Descargar gráficos de volumen: métricas de barra personalizadas
• Lista del historial de cargas recientes
• Lista del historial de descargas recientes
• Botón de purga global: borrar tablas de estadísticas

2. Filtros de encabezado y marco temporal

El cambio de opciones filtra valores en tarjetas de métricas, gráficos e historiales.

3. Métricas de carga (⬆ CARGAS)

Seis tarjetas se extienden horizontalmente y muestran iconos, títulos y valores de datos:

4. Gráfico de volumen de carga

Un widget personalizado (BarChartWidget) dibujado directamente mediante QPainter: - Barras: esquinas redondeadas con un relleno degradado de azul oscuro a cian. - Eje Y: algoritmo de escalado dinámico delimitado por líneas de malla discontinuas. - Eje X: las marcas de tiempo escalan según los filtros activos (DD.MM, MM o AAAA). - Métricas: los valores flotantes se muestran centrados sobre las barras individuales. - Estados vacíos: representa opciones alternativas de "No hay datos disponibles" si las filas de consulta devuelven un valor nulo.

5. Métricas de descarga (⬇ DESCARGAS)

Coincide con la estructura de la tarjeta de métricas de carga, diseñada con un tema morado:

6. Gráfico de volumen de descarga

Idéntico al diseño del gráfico de carga, pero representado con un degradado de color púrpura.

7. Cargas recientes (Lista de historial)

Muestra las 10 filas de carga más recientes dentro de una lista de menú desplazable:

Colores de estado: ✅ Éxito: Verde, ❌ Fallido: Rojo, ⏳ Pendiente: Amarillo

Texto de estado vacío: "No hay historial de carga disponible".

8. Descargas recientes (Lista de historial)

Diseño idéntico que coincide con la estructura de la lista de carga, detallando las descargas recientes.

Texto de estado vacío: "No hay historial de descargas disponible".

9. Restablecer estadísticas

En el borde inferior hay un botón rojo de advertencia:

Botón → 🗑 Restablecer estadísticas: borra las filas de la base de datos que rastrean métricas estructurales.

Antes de borrar registros, el sistema muestra al usuario un cuadro de diálogo de alerta:

¿Está seguro de que desea restablecer todas las estadísticas? Esta acción borra permanentemente todas las estadísticas de carga y descarga, así como los registros del historial de trabajos. Esta acción no se puede deshacer.

10. Especificaciones de la fuente de datos

Mapas de datos de tablas internas almacenadas en ~/.zenith-uploader/zenith.db:

Tabla: estadísticas (Registros agregados diarios)

VPN Guard — Protección VPN para cargas

La pestaña VPN Guard administra los perfiles de conexión OpenVPN y WireGuard, ofreciendo ranuras de configuración del servidor y mapeo de ubicación personalizado. Un Kill-Switch incorporado detiene automáticamente las colas activas si los túneles de red caen.

1. Vista general de la página

• Encabezado: Metadatos descriptivos
• Advertencia de acceso raíz: seguimiento del motor de permisos (hosts Linux)
• Tarjeta de estado: controles y métricas de enrutamiento de red
• Perfiles guardados — Lista de perfiles de configuración
• Configuración — Parámetros de gestión del Kill-Switch
• Registro de VPN: consola de seguimiento de eventos en tiempo real

2. Encabezado

3. Advertencia de acceso root (Entornos Linux)

Los tiempos de ejecución del host Linux sondean los espacios del entorno para garantizar que existan permisos de root o backends pkexec activos. Los ganchos que faltan activan un banner de advertencia:

⚠ Privilegios de root no disponibles. Los subsistemas VPN requieren permisos de root (pkexec o sudo). Instale las dependencias de Policykit-1: sudo apt install Policykit-1

Esta advertencia se oculta automáticamente en las plataformas Windows.

4. Tarjeta de estado (Área principal)

4.1 Visualización de estado

4.2 Botones de conexión/desconexión

5. Perfiles guardados

5.1 Tarjetas de perfil

• Bandera de país: indicador de bandera emoji basado en metadatos geográficos.
• Nombre de identidad del perfil: título de la etiqueta en negrita (por ejemplo, "Mullvad Amsterdam").
• Fila de detalles: Nombre del proveedor · País de destino · Metadatos del protocolo.
• Insignias de protocolo: etiquetas pequeñas codificadas por colores según el tipo de motor (OP = OpenVPN verde, WI = WireGuard cian).
• ● Nodo de selección: un punto cian marca el perfil de destino activo.
• ✕ Control de purga: botón de icono circular para borrar perfiles (se ilumina en rojo al pasar el mouse).

Vista de estado vacío: "No se guardaron perfiles. Agregue una nueva configuración de perfil VPN para comenzar".

5.2 Cuadro de diálogo Agregar perfil (+ botón)

Países admitidos: 🇳🇱 Países Bajos, 🇩🇪 Alemania, 🇺🇸 EE. UU., 🇬🇧 Reino Unido, 🇨🇭 Suiza, 🇸🇪 Suecia, 🇫🇷 Francia, 🇨🇦 Canadá, 🇯🇵 Japón, 🇦🇺 Australia, 🇷🇴 Rumania, 🇸🇬 Singapur, 🇪🇸 España, 🇮🇹 Italia, 🇳🇴 Noruega, 🇫🇮 Finlandia, 🇦🇹 Austria, 🇧🇪 Bélgica, 🇵🇱 Polonia, 🇨🇿 República Checa, 🌍 Otros.

6. Configuración

Parámetros del Kill-Switch

Si el túnel se rompe inesperadamente, el AppController maestro detecta la excepción a través del bucle de escucha vpn_status_changed. Inmediatamente pausa todas las cargas activas, cambia la pantalla a ERROR y registra el evento. Las colas deben reiniciarse manualmente después de establecer una ruta de conexión segura.

7. Consola de registro VPN

Interfaz de consola monoespacial con actualizaciones de registros en tiempo real.

8. Arquitectura del motor VPN

• Los datos del perfil activo se cargan en grupos de ejecución de memoria transitoria.
• Supervisa los códigos de salida y los canales de error estándar para rastrear los estados activos.
• Valida las rutas de conectividad mediante búsquedas de verificación de IP externas después del protocolo de enlace.
• Emite señalización vpn_status_changed entre módulos para ajustar los widgets del panel.

Parte 7a: Entradas remotas — RSS Feeds

Fuentes remotas — RSS Feeds

La subpestaña RSS Feed automatiza el sondeo de puntos finales del indexador remoto, la búsqueda de versiones de NZB de destino que coincidan con los parámetros definidos y el enrutamiento de cargas útiles directamente a flujos de tareas de descarga.

1. Vista general de la estructura

El módulo utiliza un diseño vertical ajustable: - Mitad superior: cuadrícula interactiva que muestra todas las configuraciones RSS guardadas. - Mitad inferior: campos de formulario del editor granular + nodos de vista previa del feed + registro en segundo plano.

2. Matriz de feeds (Sección superior)

2.1 Columnas de la tabla

Botón → + Agregar nueva fuente: inyecta una entrada de fila de configuración en blanco en la matriz de datos.

3. Formulario de configuración detallada (Sección inferior)

Al seleccionar cualquier entrada de fila, se asignan sus parámetros directamente a los campos del formulario de entrada granular.

3.1 Campos del formulario

3.2 Ejemplos de filtros de expresiones regulares

El punto. actúa como un carácter comodín de coincidencia. Escapar a través de \\. para apuntar a puntos literales. Utilice .* para rellenos de caracteres flexibles. Los controles no distinguen entre mayúsculas y minúsculas.

3.3 Acciones funcionales

4. Vista previa de resultados

Las acciones de sondeo manual devuelven matrices de nodos de destino para su validación:

Controles de vista previa - ☑ Seleccionar todo: comprueba todas las filas visibles. - ⬇ Descarga marcada: empuja las filas seleccionadas a las colas de descarga. - 🗑 Descartar registros: elimina los registros seleccionados de las tablas de vista previa.

Los elementos descartados o descargados registran sus hashes GUID únicos en el almacenamiento local para evitar duplicados en iteraciones de sondeo posteriores.

5. Automatización del motor en segundo plano

Cuando se ejecutan bucles de análisis automatizados: 1. Activaciones del temporizador → Raspar fuente de API → Filtrar GUID conocidos → Ejecutar verificaciones de tamaño y expresiones regulares 2. Si la cola automática está deshabilitada: agregar a la matriz de visualización 3. Si la cola automática está habilitada: inyectar tareas directamente

Parte 7b: Entradas remotas — Indexadores Newznab

Fuentes remotas — Indexador Newznab

La capa de integración de Newznab se conecta directamente a puntos finales de indexación compatibles a través del enrutamiento de consultas API nativo, ejecutando protocolos de filtrado de parámetros personalizados.

1. Vista general

Coincide con la estructura de diseño dividido utilizada por el componente RSS: - Mitad superior: cuadrícula que muestra los motores de indexación activos. - Mitad inferior: campos del editor de perfiles + registro de comunicación.

2. Cuadrícula de configuración (Sección superior)

Botón → + Agregar indexador: agrega una fila de entrada del indexador en blanco.

3. Configuración detallada (Sección inferior)

Referencia de categorías Newznab

Consejo: Separe varios ID con comas. Dejar el campo en blanco sondea todas las categorías.

4. Controles funcionales

5. Arquitectura API en segundo plano

Mapeo de puntos finales de Newznab: - Diagnóstico de capacidad: OBTENER /api?t=caps&apikey=TOKEN - Consultas de palabras clave: GET /api?t=search&q=QUERY&apikey=TOKEN&cat=CATS&limit=LIMIT - Obtención de NZB: GET /api?t=get&id=GUID&apikey=TOKEN

Flujo de procesamiento: 1. El temporizador en segundo plano activa las tareas de ejecución. 2. Emite solicitudes HTTP GET con categorías y límites analizados. 3. Itera respuestas contra matrices de expresiones regulares de títulos activos. 4. Elimina las entradas que no superan las comprobaciones del umbral de tamaño. 5. Omite elementos analizados previamente a través de registros GUID almacenados. 6. Si las "Extracciones automatizadas" están habilitadas, recupera NZB y lo agrega a las listas activas. 7. Si está habilitado "Motores de inicio automático", la ejecución comienza inmediatamente.

6. Redes de indexadores validadas

Los sistemas compatibles incluyen todos los proveedores estándar que cumplen con Newznab: NZBGeek, DrunkenSlug, NZBFinder, NZBPlanet, DOGnzb y Tabula Rasa.

Parte 7c: Entradas remotas — FTP / SFTP

Fuentes remotas — FTP / SFTP

El módulo FTP/SFTP proporciona un explorador de archivos de terminal remoto integrado, que incluye navegación en árbol de rutas y descargas en segundo plano para extraer recursos directamente a directorios del espacio de trabajo localizado.

1. Vista general de la estructura

• Barra superior: formularios de parámetros de autenticación y entradas de acceso al servidor.
• Cuerpo central principal: tabla del navegador del árbol de directorios remotos que muestra las estructuras del sistema de archivos remoto.
• Sección inferior: Gestión de carpetas de destino y comentarios de la consola de registro.

2. Ajustes de conexión

2.1 Campos del formulario

2.2 Acciones del sistema

3. Navegador de directorios remotos

3.1 Barra de navegación

• ⬆ Directorio superior: navega un nivel hacia arriba hasta los niveles de la carpeta principal.
• 🔄 Actualizar contenido: vuelve a escanear las estructuras del directorio activo.
• Cuadro de ruta activa: representación monoespaciada de la ruta del servidor remoto sin formato (cian).

3.2 Tabla de contenido del directorio

3.3 Interacciones

• Directorio de doble clic: ingresa al directorio secundario seleccionado.
• Archivo de un solo clic: marca filas para su selección (admite selección múltiple).
• Haga clic en la flecha principal (⬆): retrocede a árboles lógicos superiores.

3.4 Implementaciones de biblioteca

• SFTP: Impulsado a través de paramiko. Señales de Keepalive cada 30 segundos.
• FTP: controlado a través de ftplib. Modo pasivo aplicado; Análisis UTF-8 para conjuntos de caracteres extendidos.

4. Motor de descarga

• Procesa los elementos verificados de forma secuencial a través de una cola asincrónica.
• Al seleccionar una entidad de carpeta, se extrae toda su estructura de árbol de archivos de forma recursiva.

Parte 8a: Auto-Post — Publicador de foros

Auto-Post — Publicador de foros

La subpestaña Póster del foro administra notificaciones automáticas de indexación de lanzamientos, presenta datos a través de motores de formato de plantillas y envía temas directamente a los foros específicos.

1. Vista general

La interfaz de usuario se divide en cuatro segmentos de diseño funcional: - Cinta de encabezado: Título + activador "+ Agregar nuevo perfil" - Cuadrícula de selección de perfil: configuraciones de placa de destino activa - Cola de espera de publicación: espacio de trabajo de aprobación manual - Tarjeta de ayuda de referencia: documentación contextual y consejos de sintaxis

2. Tarjetas de perfil de destino

2.1 Componentes de la interfaz

2.2 Colores de motores de software de foro

3. Diálogo de gestión de perfiles

3.1 Campos del formulario

3.2 Tokens del título del hilo

3.3 Acciones del diálogo

• 🔌 Inicio de sesión de prueba: las sondas apuntan a la autorización del foro sin realizar cambios.
• ❌ Abortar: cierra el modal y descarta las ediciones no confirmadas.
• ✅ Perfil de confirmación: valida, guarda y actualiza listas.

4. Modos de operación

5. Cola de espera de publicación manual

Los trabajos en modo Manual esperan dentro de este espacio de trabajo: - 📄 Título del contenido: nombre del archivo de publicación de la fuente. - → Destino: Perfil de destino y versión del motor. - ▶ Publicación posterior: procesa instantáneamente el envío de temas. - 🗑 Eliminar tarea: purga la notificación por etapas.

Estado vacío: "No hay notificaciones preparadas dentro de la cola de espera de validación manual".

6. Compatibilidad de motores

Parte 8b: Auto-Post — Plantillas

Auto-Post — Gestor de plantillas

El espacio de trabajo Plantillas maneja el formato de cadenas BBCode y HTML, lo que permite a los usuarios asignar tokens dinámicos a las cargas útiles de las publicaciones del foro de destino.

1. Vista general

La interfaz utiliza un diseño dividido horizontalmente: - Cinta superior: listado basado en chips de todas las etiquetas de token disponibles. - Panel izquierdo: listado de todas las definiciones de diseño guardadas. - Lienzo derecho: editor de texto monoespaciado con barra de herramientas de control de formato.

2. Chips de referencia de tokens

Los tokens se muestran dentro de fichas verdes con información sobre herramientas que detalla la mecánica de evaluación.

3. Panel de navegación izquierdo

• Árbol de selección: muestra plantillas junto a un ícono 📄. Al hacer clic se completa el editor.
• ＋ Nueva plantilla: genera una nueva entrada con código repetitivo.
• 🗑 Eliminar plantilla: solicita verificación para borrar diseños.

Límites: Mínimo 1 plantilla activa. Máximo 10 plantillas (MAX_POSTING_TEMPLATES). Genera automáticamente una plantilla estándar si se borran todos los registros.

4. Lienzo y barra de herramientas de edición derecha

4.1 Componentes

4.2 Botones de la barra de herramientas

11 botones de la barra de herramientas para la inserción rápida de etiquetas de formato:

Resaltar el texto envuelve la selección dentro de las etiquetas elegidas. Al hacer clic sin selección se inserta el cursor.

4.3 Acciones de guardado

Botón → 💾 Guardar perfil de diseño: escribe nombres, formatos y bloques de texto en la configuración global.

5. Plantilla predeterminada (vBulletin 3.x)

[center][size=5][color=red][b]{title}[/b][/color][/size][/center]

[center][size=3][color=][b]»Content Description«[/b][/color][/size]
[size=2][color=white]{description}[/color][/size][/center]

[nfo]{nfo_content}[/nfo]

[hide]
[center][size=3][color=][b]»Usenet Release Header«[/b][/color][/size]
[size=2][color=white]{header}[/color][/size][/center]

[center][size=3][color=][b]»Archive Security Password«[/b][/color][/size]
[size=2][color=white]{password}[/color][/size][/center]

[center][nzblnk]nzblnk:?t={title}&h={header}&p={password}[/nzblnk]
[/center][/hide]

6. Proceso del motor de renderizado

1. Extrae el formato asignado de las definiciones de perfiles activos.
2. El bucle de reemplazo de expresiones regulares intercambia todas las etiquetas {placeholder} con parámetros de tiempo de ejecución.
3. Representa el título del hilo por separado utilizando sus propias reglas de formato.
4. Reenvía el texto finalizado a los hilos de carteles del foro.

Webhooks y notificaciones

La subpestaña Webhooks se conecta a las interfaces API para enviar alertas de estado en tiempo real a través de aplicaciones de comunicación cuando se activan hitos o advertencias.

1. Vista general

• Encabezado: Título + activador "+ Agregar nuevo webhook".
• Active Target Grid: puntos finales de automatización guardados como elementos seleccionables.
• Tarjeta de ayuda de referencia: documentación de sintaxis de carga útil.

2. Proveedores API compatibles

3. Elementos de perfil de webhook

Estado vacío: "No se han asignado rutas de alerta de webhook. Configure un perfil de seguimiento para recibir registros de estado".

4. Diálogo de configuración

4.1 Configuración base

4.2 Campos específicos por plataforma

Discord: URL del webhook de destino: obligatorio

Telegram: Bot Token (a través de @BotFather): obligatorio; ID de chat: obligatorio

Correo electrónico SMTP: Servidor host, Puerto (587), ☑ TLS, Nombre de usuario, Contraseña, Destinatario — Obligatorio

ntfy: URL del servidor (https://ntfy.sh), canal de tema: obligatorio, token de acceso: opcional

HTTP personalizado: URL de destino: obligatorio, método HTTP (POST/PUT/GET), encabezados (JSON)

5. Eventos de activación

Todos los eventos se marcan de forma predeterminada en nuevos perfiles.

6. Campos de datos del payload

7. Prueba de envío

🔔 Alerta de prueba de envío: genera un perfil de prueba transitorio, formatea cargas útiles simuladas personalizadas según las reglas de la plataforma, transmite al destino y devuelve una ventana emergente de confirmación.

Parte 10a: Configuración — Proveedor

Configuración — Proveedor

El panel de proveedores alberga perfiles de conexión de red Usenet, administra las configuraciones del servidor de noticias y equilibra los canales de carga salientes junto con las recuperaciones de archivos entrantes.

1. Vista general

• Área superior: Cuadrícula central que clasifica las cuentas de servidores activos.
• Formulario de configuración inferior: controles de creación de campos de perfil.
• Barra de acción: mantenimiento de red + activadores de prueba de conexión.

2. Matriz de cuentas de proveedor

3. Formulario de configuración de cuenta

4. Prueba de conexión

🔌 Verificar la conexión del servidor: Diagnóstico de conectividad automatizado:

1. Formular asignación de cuentas → Consultar nntplib → Inyectar protocolo de enlace SSL
2. Abrir canal TCP → Medir latencia (ms) → Devolver encabezados de bienvenida

Las excepciones detienen la ejecución y redirigen los comentarios sin procesar a cuadros de diagnóstico.

Parte 10b: Configuración — Carga

Configuración — Ajustes de carga

El administrador de configuración de carga maneja los perfiles de configuración para la compresión saliente, la recuperación de metadatos y la optimización de la capa de ejecución.

1. Vista general

• Cinta superior: alternar modo experto + restablecimiento de fábrica.
• Cuadrícula estándar: parámetros de tres columnas para la configuración del día a día.
• Cuadrícula experta: configuraciones avanzadas en cuadros de acento morados (solo modo experto).

2. Ajustes estándar

2.1 Comportamiento general de la aplicación

2.2 Motor de procesamiento

Modos de canalización: secuencial completa cada tarea antes de comenzar la siguiente. Pipelined ejecuta compresión en los próximos trabajos mientras carga cargas útiles activas. DiskGuard monitorea el consumo de almacenamiento.

2.3 Protección del disco

2.4 Operaciones de limpieza

2.5 Prioridad de proceso

3. Ajustes expertos (Caja de acento púrpura)

3.1 Compresión 7-Zip

3.2 Recuperación de metadatos ParPar

3.3 Ajuste de red NNTP

Parte 10c: Configuración — Descarga

Configuración — Ajustes de descarga

El espacio de trabajo Configuración de descarga optimiza el ancho de banda descendente, los parámetros de caché del sistema de archivos y el procesamiento de ensamblajes de archivos de varias partes.

1. Vista general

Cinco grupos de componentes en un marco de dos columnas: - Carpetas y espacio de trabajo del sistema - Desembalaje de la tubería del motor - Parámetros de conexión de red - Seguridad de la guardia del disco - Tuberías en modo espejo

2. Carpetas y espacio de trabajo del sistema

3. Motor de descompresión

Selector de extensiones no deseadas: ✅ .txt, ✅ .html, ✅ .url, ✅ .nfo, ✅ .info (filtros individuales atenuados hasta que se habilita la opción principal).

4. Parámetros de conexión de red

5. Disk Guard (Descarga)

Consejo: Asigne límites de descarga un 10 % más bajos que las protecciones de carga (por ejemplo, Cargas 90 % → Descargas 80 %) para garantizar que las tareas de descarga nunca consuman el espacio de caché temporal necesario para las cargas activas.

6. Modo espejo

Habilitar esta bandera borra los archivos corruptos del disco, evitando que los raspadores de carpetas de vigilancia reprocesen los paquetes fallidos. La desactivación deja intactos los datos defectuosos para la resolución manual de problemas.

Parte 10d: Configuración — Carpetas vigiladas

Configuración — Carpetas vigiladas

La interfaz de Carpetas vigiladas configura bucles de sondeo de directorio automatizados. El motor captura archivos nuevos ubicados dentro de ubicaciones monitoreadas y los pone en cola para su procesamiento.

1. Vista general

• Cinta de encabezado: Títulos + contadores dinámicos (por ejemplo, "3/10 carpetas monitoreadas").
• Explicaciones de contexto: guías breves sobre reglas de automatización.
• Lista de directorios: carpetas configuradas como tarjetas procesables.
• ➕ Botón Agregar ruta monitoreada: inicia el navegador de directorios.

2. Tarjetas de monitorización de directorios

2.1 Componentes de la interfaz

• Etiqueta de directorio: nombre de la carpeta de destino en negrita.
• Ruta completa: referencia de ruta del sistema atenuada.
• Chips de grupos de noticias: destinos de índice activos como chips horizontales.
• Menú desplegable de enrutamiento: cuadro combinado que administra los archivos binarios de destino.
• ● Estado: Verde = activo, Amarillo = en pausa, Rojo = falta directorio.
• ✕ Eliminar: elimina la configuración de monitoreo.

2.2 Verificación de estado

3. Asignación de categorías de newsgroups

• Admite reglas de publicación de grupos múltiples por carpeta.
• Al hacer clic en los nodos del chip X, se elimina el grupo de noticias del perfil.
• "No Target Newsgroup" desactiva la publicación pública de la ruta.
• Agregar objetivos estándar elimina las restricciones __ninguna__ activas.
• Las carpetas no configuradas tienen de forma predeterminada la configuración global.

Esquema de configuración:

{
 "/home/user/Videos/Upload": ["alt.binaries.boneless", "alt.binaries.misc"],
 "/home/user/Private/Backup": ["__none__"]
}

4. Añadir carpetas vigiladas

1. Haga clic en "+ Agregar ruta monitoreada".
2. El selector de carpetas del sistema asigna las rutas del sistema de archivos de destino.
3. Los filtros comparan los registros existentes para bloquear duplicados.
4. Máximo 10 entradas. Cap desactiva los botones adicionales.
5. Los cambios activan recargas automáticas del motor de vigilancia.

5. Eliminar carpetas vigiladas

• Al hacer clic en X se eliminan las filas de entrada.
• Borra la configuración de los archivos watch_folders.
• Limpia los historiales de estado en watch_folders_disabled.
• Elimina registros de watch_folder_newsgroups.
• Activa recargas del motor en vivo para detener el monitoreo al instante.

6. Sincronización con el dashboard

Los interruptores de palanca en el panel principal escriben en la configuración watch_folders_disabled. Los componentes se recargan y sincronizan cuando los usuarios regresan a la configuración.

Licencia

La pestaña Licencia controla las activaciones de autorización, muestra métricas de validez de licencia activa y administra la asignación de HWID del dispositivo durante los ciclos de reemplazo de equipos.

1. Vista general

• Encabezado — Título y alcance
• Insignia de licencia: banner de visualización de estado
• Tarjeta de activación: entradas del formulario que validan los tokens de productos
• Utilidades de licencia: 3 tarjetas de operaciones del sistema
• Límites de demostración: visibles solo para instancias no autenticadas
• Privilegios de funciones: lista detallada de activos premium desbloqueados

2. Niveles de licencia

3. Tarjeta de insignia de licencia

• Icono de placa grande que informa el estado actual.
• Demostración: "Operaciones restringidas del sistema: actualice para desbloquear un rendimiento infinito".
• Completo: "Todas las funciones premium desbloqueadas: nivel infinito activo de por vida".
• Caducidad: los informes finalizan las marcas de tiempo, ∞ Ilimitado o — (demostración).

4. Registro y activación de claves

Flujo de trabajo: Clave de entrada → Ejecutar licencia.activar (clave) → Punto final de validación de consulta → No válido: cuadro de diálogo de error / Válido: escribir en la configuración → Solicitar reinicio.

5. Utilidades de licencia

5.1 🔄 Restablecer identidad del hardware (restablecimiento de HWID)

Restablece las claves de hardware de seguimiento de registros para permitir la migración a estaciones de trabajo alternativas. Genera alerta de verificación de seguridad. Distribuye licencia.reset_hwid.

5.2 ⛔ Desactivar licencia del dispositivo

Quita las autorizaciones de licencia a los equipos locales. Vuelve al modo de demostración después del reinicio. Estilo de botón rojo carmesí.

5.3 📋 Sistema de captura HWID

Copia el hash de identificación de hardware calculado sin procesar al portapapeles del sistema a través de QApplication.clipboard.setText(license.hwid).

6. Limitaciones de la demo (solo DEMO)

Un cartel de advertencia de color ámbar enumera las restricciones: - 📦 Límite de archivos: Máximo 1 GB por lote de ejecución. - 📊 Contador de colas: máximo 10 tareas de carga por día. - 🏷 Inyección de marca: inyecta marcadores de marca en encabezados NNTP salientes. - URL externa: → portal de actualizaciones de zenith-uploader.com.

7. Funciones desbloqueadas (solo versión completa)

Una lista de verificación verde resume los conjuntos de funciones activas: - ✓ Capacidades de procesamiento ilimitadas. - ✓ Metadatos salientes anónimos (cero inyecciones de marca). - ✓ Perfiles de rendimiento dinámicos sin límites de velocidad. - ✓ Controles completos de VPN Guard y Kill-Switch. - ✓ Enrutamiento de atención al cliente de alta prioridad.

Soporte y diagnóstico

La pestaña Soporte proporciona información sobre el rendimiento del sistema en tiempo real, registros de seguimiento de análisis del entorno y kits de herramientas de envío de informes de asistencia automatizados.

1. Vista general

• Encabezado: metadatos + etiquetas de índice de versión (por ejemplo, v1.0.0)
• Lista de estado del sistema: 4 módulos analíticos horizontales
• Visor de registros de aplicaciones: consola en vivo con filtrado de consultas
• Acciones de asistencia rápida: 4 tarjetas de ayuda de inicio rápido
• Enlaces de pie de página: correo de soporte + rutas del sitio web

2. Panel de estado del sistema

3. Visor de registros de la aplicación

3.1 Barra de herramientas

3.2 Parámetros de la consola

• Fuente: ~/.zenith-uploader/logs/zenith.log
• Límite de búfer: 1000 entradas más recientes
• Actualización automática: cada 10 segundos mediante QTimer
• Fuente: JetBrains Mono 10pt (reserva: Consolas)
• Desplazamiento: Ajustar hacia abajo al actualizar

3.3 Mapa de colores por severidad

3.4 Barra de navegación de la consola

4. Acciones rápidas de asistencia

4.1 🐛 Compilación de informes de errores

• Escribe las rutas del directorio de registros en el portapapeles.
• Inicia el administrador de archivos en los directorios de soporte.
• Abre el cliente de correo predeterminado con una plantilla previamente completada.

4.2 📂 Abrir directorio de registros

Abre ~/.zenith-uploader/logs/ en el explorador de archivos nativo. Crea automáticamente los directorios que faltan.

4.3 📋 Ruta de registro de captura

Copia la ruta absoluta del sistema de archivos al portapapeles del sistema.

4.4 📊 Diagnóstico del entorno de captura

Copia el texto de información del sistema formateado:

Zenith Uploader — System Environment Diagnostic Data Map
======================================================
Host OS Platform: [OS]
Python Runtime Version: [Version]
Available Processor Threads: [Threads]
Memory Utilization: [Used] / [Total] GB
Log Path: [Path]

5. Enlaces del pie de página

📧 [SUPPORT_EMAIL] · Documentación y guías: zenith-uploader.com