AJAZZ HUB (Unofficial Standalone Driver)

A lightweight, standalone Windows desktop application for Ajazz peripherals (specifically tested with the Ajazz AK680 V2).

This project wraps the official Ajazz web-based driver (https://ajazz.driveall.cn/#/) into a native, distraction-free Windows executable. It allows you to configure your keyboard without needing a Chromium-based browser (like Chrome or Edge) installed on your system.

✨ Features

• True Native Feel: Operates exactly like a standalone desktop utility. No browser UI, tabs, or address bars.
• Auto-Hardware Detection: Bypasses the standard WebHID browser security prompts. The app automatically detects your plugged-in Ajazz hardware and connects to it silently and instantly.
• The "Popup Destroyer": Automatically hunts down and closes the annoying "All devices do not support Bluetooth mode..." warning banner before you even see it.
• Custom Navigation UI: Injects a custom, floating "BACK" button styled to match the dark aesthetic of the app, allowing seamless navigation through the driver menus.
• Sleek Splash Screen: Features a custom, borderless loading animation while the heavy web driver initializes in the background, completely hiding the initial white loading screen.
• Clean Exit: Completely shuts down background processes when the window is closed to save system memory.

🛠️ How it Works

Under the hood, this app utilizes Electron to bundle a standalone Chromium environment.

1. User-Agent Spoofing: The app sends a standard Google Chrome User-Agent to the Ajazz servers, bypassing the site's anti-Electron browser checks.
2. WebHID Interception: The Electron main process intercepts select-hid-device and hid permission requests. Instead of generating a popup asking the user to select their device, the app automatically reads the USB tree and hands the first valid Ajazz hardware ID directly to the website.
3. DOM Manipulation: Once the site fully loads (did-finish-load), the app executes background JavaScript to inject the custom floating Back button and runs a high-speed interval scanner (20 ticks per second) to programmatically click the 'X' on specific framework alert banners.

🚀 How to Build / Compile from Source

If you want to modify the code or compile the .exe yourself, follow these steps:

Prerequisites

• Node.js installed on your system.
• Windows OS (Required for compiling the NSIS Setup Wizard).

1. Clone the Repository

Download the files from this repository and place them in a folder (e.g., AJAZZ-HUB). Ensure your folder structure looks like this:

AJAZZ-HUB/
├── package.json
├── main.js
├── splash.html
└── icon.ico

2. Install Dependencies

Open a Command Prompt or PowerShell window in your project folder and run:

npm install

3. Test the App

To run the app in development mode and test any changes you make to the UI or script:

npm run start

4. Compile the Windows Installer

This project uses electron-builder configured for NSIS to create a standard Windows Setup Wizard.

CRITICAL: Because the compiler needs to create symbolic links during the build process, you must run your terminal as an Administrator.

1. Close your current terminal.
2. Open Command Prompt as Administrator.
3. Navigate to your folder (cd /d "C:\Path\To\Your\Folder").
4. Run the build command:

npm run build

Once the process finishes, look inside the newly generated dist folder. You will find your final Ajazz Hub Installer.exe.

📝 License

This project is licensed under the MIT License. Note: This is an unofficial, community-made wrapper. All driver software and web assets belong to Ajazz.