Wethereal
Windows Tweaker

Descripción del proyecto

Wethereal nació de la necesidad de tener una herramienta centralizada para optimizar sistemas Windows de forma profesional, segura y reproducible. Lo que empezó como una colección de scripts de PowerShell personales creció hasta convertirse en una suite completa con más de 1.500 líneas de código funcional y 5.500 líneas en total.

El enfoque desde el principio fue la seguridad: antes de cualquier cambio mayor, Wethereal crea un punto de restauración de Windows y hace backup de las claves de registro afectadas. Todas las operaciones son reversibles mediante un undo stack. Cero warnings de PowerShell en toda la base de código.

La herramienta se estructura en un menú interactivo con 24 opciones agrupadas en 8 categorías, más 7 acciones rápidas para los perfiles de uso más comunes (Gaming, Work, Max Performance, Privacy).

8 Categorías

• System Performance: optimizaciones de CPU, GPU, RAM y disco — prioridades de proceso, gestión de energía y scheduler
• Gaming & Graphics: tweaks específicos para GPU (NVIDIA/AMD), reducción de latencia de input y optimización de DirectX
• Network & Internet: reducción de latencia TCP/IP, optimización de buffers, configuración de DNS y QoS
• Privacy & Security: hardening de telemetría Windows, desactivación de servicios de seguimiento y gestión de permisos de apps
• Cleanup & Maintenance: limpieza de archivos temporales, gestión de bloatware y optimización del registro
• Advanced Tweaks: tweaks de kernel, configuración de IRQ y ajustes de memoria de baja latencia
• Monitoring & Info: análisis del sistema con puntuación de salud de 10 puntos, informe de hardware y diagnóstico de servicios
• Tools & Utilities: gestión de actualizaciones de Windows, control de servicios y optimizador de registro (8 tweaks seguros)

Ejemplo de uso

# Wethereal v3.5.0 — Ejecución como administrador
# Requiere PowerShell 5.1+ y permisos de administrador

# Clonar y ejecutar
git clone https://github.com/vvv-bash-v2/Wethereal
cd Wethereal
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\Win-Tweaker.ps1

# Perfil Gaming rápido (sin menú interactivo)
.\Win-Tweaker.ps1 -Profile Gaming

# Generar informe del sistema
.\Win-Tweaker.ps1 -Report -OutputPath "C:\Reports\system-report.html"

Retos y soluciones

• Compatibilidad multi-versión Windows: los tweaks de registro difieren entre Windows 10 1809 y Windows 11 24H2; implementado un sistema de detección de versión que aplica el tweak correcto según el OS detectado.
• Operaciones reversibles: mantener un undo stack en PowerShell sin perder estado entre ejecuciones; resuelto serializando el stack a JSON en el directorio temporal del usuario.
• Zero warnings policy: PowerShell es estricto con tipos y null-safety; refactorizados todos los módulos para usar tipos explícitos y operadores de null-coalescing (??).
• Backups de registro seguros: exportar y restaurar claves de registro de forma atómica; implementado con reg export y validación de integridad por hash antes de aplicar cambios.

Aprendizajes

Wethereal me enseñó PowerShell a fondo: el sistema de tipos, el pipeline de objetos, los módulos y la gestión de errores con try/catch y traps. Entender cómo funciona Windows a nivel de registro, servicios y scheduler fue la base que luego apliqué directamente en el trabajo de SysAdmin.

La parte de UX del menú interactivo también fue valiosa: diseñar un flujo de usuario claro en una interfaz de terminal — con colores, confirmaciones y feedback claro — es más difícil de lo que parece.