Vyrex Performance Suite - Official Documentation & User Guide

Welcome to the official documentation for the Vyrex Performance Suite. This document serves as a comprehensive guide for users to understand and utilize the software, as well as a reference for developers and administrators managing the deployment and backend infrastructure.

Introduction
Installation & Setup
User Guide
Administrator Guide
Architecture & Engine Details
Troubleshooting & Logs

1. Introduction

Vyrex is a premium, highly advanced desktop application engineered to maximize Windows operating system performance. Built natively in C# .NET 9.0 using the Avalonia UI framework, it provides a comprehensive suite of tools for system optimization, telemetry disabling, deep-debloating, and hardware tuning.

Key Capabilities

Deep Windows Debloating: Permanent removal of UWP Appx and Provisioned packages.
Hardware Tuning: CPU core unparking, GPU priority tweaking, and custom power plans.
Network Optimization: Latency reduction via disabling Nagle's Algorithm and adjusting TCP configurations.
Zero-Risk Operations: Automated System Restore checkpoints before applying optimizations.
Premium Aesthetics: Glassmorphism UI with smooth MD3 transitions and dynamic gradient palettes.

2. Installation & Setup

Prerequisites

For standard users, simply download the latest Vyrex_Setup.exe from your provider.

For developers looking to compile from source:

.NET 9.0 SDK: Required for compiling the Avalonia C# application.
Inno Setup Compiler 6+: Required to build the installer (installer.iss).

Building from Source

Compile the Standalone Binary: Open a PowerShell terminal in the project root and run:

dotnet publish .\src\Vyrex.App\Vyrex.App.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

Pack the Installer: Use Inno Setup to compile the provided script into an executable setup file:
```
& "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" .\installer.iss
```

3. User Guide

Vyrex uses a 100% native, secure Proof Key for Code Exchange (PKCE) flow for Google OAuth.

Upon launching, click Sign In.
A browser window will prompt you for your Google credentials.
Authentication is hardware-bound via a unique HWID (Hardware ID) generated from your motherboard and CPU serials to prevent license sharing.

Dashboard & Health Score

The Dashboard is your command center. It calculates a real-time System Health Score based on:

Active Background Processes
C: Drive Capacity
System Uptime (Identifying memory leaks)
Real-time CPU & RAM Saturation
Page File Exhaustion (Thrashing)

System Debloater

The Debloater safely removes unwanted pre-installed Windows applications (UWP bloatware).

Navigate to the Debloater tab.
Select the applications you wish to remove.
Vyrex dynamically uses PowerShell to remove both the active AppxPackage and the AppxProvisionedPackage. This ensures bloatware does not reinstall during major Windows feature updates.

Optimizer

The Optimizer section is dedicated to hardware and active-process tuning:

CPU Core Unparking: Forces all CPU cores to remain active, eliminating latency spikes caused by core waking.
Power Plans: Apply the hidden Windows "Ultimate Performance" power scheme.
RAM Cleaner: Force-clears standby lists to free up memory for gaming or heavy workloads.

System Tweaks

The core of Vyrex lies in its registry and network tweaks. Navigate to the Tweaks view to toggle them:

[!TIP] Recommended Gaming Tweaks: Enable "Disable Power Throttling", "Timer Resolution (0.5ms)", "GPU Priority Tweak", and "Disable Nagle Algorithm" for the lowest possible input lag and network latency.

Available Categories:

Performance: Disable Power Throttling, Disable HPET, Optimize NTFS, SysMain/Prefetch toggles.
Gaming: Disable Game DVR, Global Fullscreen Optimizations (FSO), Hardware Accelerated GPU Scheduling (HAGS), Mouse Input Optimization.
Network: Delivery Optimization, Network Throttling Index, TCP Chimney Offload, Optimize DNS Cache.
Privacy & Security: Disable Windows Telemetry, Activity History, Advertising ID, Smartscreen, and AMSI.
Deep Cleaning: WinSxS Component Store Cleanup, Clear Shadow Copies, and Deep Network Reset.

Windows Services

Disable unnecessary background Windows services to free up CPU cycles and RAM. You can toggle services like Print Spooler, Diagnostic Drivers, and Windows Search indexing directly from this menu.

Backup & System Restore

[!IMPORTANT] Always create a restore point before applying deep system tweaks.

Vyrex integrates natively with Windows Management Instrumentation (WMI) to create instant System Restore Checkpoints.

Go to the Backup tab.
Click Create Checkpoint.
If a tweak causes unexpected behavior, you can easily revert your system state through the Windows Recovery environment.

4. Administrator Guide

Vyrex includes a modern web-based administration panel (vyrex-admin-panel) built with Next.js and Prisma ORM.

Setting Up the Admin Panel

Navigate to vyrex-admin-panel/.
Install dependencies: npm install.
Configure your .env file with your PostgreSQL connection string and NextAuth secrets.
Run database migrations: npx prisma db push.
Start the development server: npm run dev.

Features

The admin panel allows you to:

Manage Users: View registered users, track their HWIDs, and monitor last-active sessions.
License Management: Revoke access for unauthorized HWID sharing or issue manual password resets.
Cloud Deployment: The panel is fully optimized for continuous deployment on platforms like Render (render.yaml provided).

5. Architecture & Engine Details

Vyrex is not just a UI; it is an optimization engine operating with strict system privileges.

TweakExecutor.cs: The brain behind the tweaks. It safely maps UI toggles to specific Registry Key modifications (HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER), WMI calls, or native command executions (bcdedit, netsh, powercfg).
HwidGenerator.cs: Securely queries WMI for Win32_BaseBoard and Win32_BIOS serial numbers to create a cryptographic hash linking a user's license to their physical machine.
Over-the-Air Updates: Utilizing NetSparkleUpdater, the app silently polls appcast.xml on launch to notify users of critical engine updates.
Obfuscation: The pipeline uses obfuscar.xml to scramble core backend engine logic while selectively skipping Avalonia ViewModels, ensuring the UI remains responsive and bindings do not break.

6. Troubleshooting & Logs

If Vyrex encounters an error applying a tweak or authenticating:

Check the Logs: Vyrex uses Serilog for detailed engine diagnostics. Logs are outputted to %APPDATA%\Vyrex\logs\.
Run as Administrator: Ensure Vyrex was launched with elevated privileges. Most registry tweaks and command-line tools (fsutil, netsh) will silently fail without Administrator rights.
Reset Network: If network tweaks cause connectivity issues, apply the "Deep Network Reset" tweak to flush DNS and reset the Winsock catalog.

[!NOTE] By default, some extreme privacy tweaks (like disabling Windows Defender) require tampering protection to be disabled manually by the user in Windows settings first.