Open-source project
k1tbyte/Wand-Enhancer avatar
k1tbyte/Wand-Enhancer

Wand Enhancer: Patching Wand's ASAR Fuse, Injecting Scripts, and Running a LAN Panel

Wand Enhancer adds interface improvements, interoperability tools, and an optional local web panel to the Wand desktop application.

27,416 stars69,809 forksC#Apache-2.0

At a glance

What is it?
Wand Enhancer is a C#/.NET patcher that modifies a local Wand installation, flips Electron's ASAR-integrity fuse via a proxy DLL, and adds an optional HTTP/WebSocket remote panel. It is deliberately source-only: no official binaries exist, so you must build from your own fork.
Who is it for?
Adopt Wand Enhancer if you need to customize Wand's client-side UI, inject your own renderer scripts, or control the app from a phone on the same LAN, and you are comfortable building an unsigned executable from your own fork. Do not adopt it if you expect a ready-made installer, need to expose the panel beyond a trusted network, or cannot accept the risk of antivirus false positives from an unsigned patcher.
Can I use it commercially?
Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 6 days ago.
What is it written in?
Mainly C#, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What Wand Enhancer actually does

Wand Enhancer is a patcher for the Wand desktop application, which itself is an online client. The tool modifies files in a selected local Wand installation. It does not contact update or telemetry services. The core mechanism is a bundled version.dll proxy that Wand loads, and that proxy changes Electron's ASAR-integrity fuse byte inside Wand's own process. That fuse change is what allows the patcher to alter the client's behavior. The README is explicit that the tool does not inject into another process. The features it enables are local environment configuration management, automated compatibility adjustments for new client versions, layout and theme customization, AI features, and a remote web panel. The AI features are listed but not detailed in the material; the README gives no mechanism for them, so treat that as a marketing bullet rather than a documented capability.

The remote web panel: convenience with a security caveat

The remote web panel is the most visible feature. It starts a LAN HTTP/WebSocket server on TCP port 3223. To use it, both the PC and phone must be on the same Wi-Fi network. The user hovers over the Connect button in the top bar and scans the QR code with the phone camera. The panel lets you control app features from the phone. The README warns that the panel uses plain HTTP and has no pairing code. Anyone who can reach port 3223 can view and control the active trainer. The protocol does not include the Wand bearer token or installation-path fields, which limits what an attacker on the LAN can steal, but the control capability itself is open. The troubleshooting section mentions client isolation on guest networks and Windows Firewall inbound rules for TCP 3223. If you want to use the panel over mobile data or a different network, the README suggests Tailscale or similar VPN tools. This is a genuine security boundary: the panel is designed for trusted LANs only, and exposing it to the internet is explicitly discouraged.

Custom scripts: renderer injection with a guard flag

Custom scripts are a second major feature. You can inject your own JavaScript into Wand at patch time. The injection reuses the same renderer injection mechanism as the remote web panel, so the remote web panel patch must be enabled. You add .js files in the patch dialog, or drop them into a renderer-scripts/ folder next to the patcher executable. The scripts run inside Wand's renderer with full DOM access and Node require. Each script is wrapped so a thrown error is logged and does not crash Wand. The README warns that scripts may run more than once per launch, so one-time work must be guarded behind a global flag. A small WandEnhancer helper object is available with log(), remoteUrl, and apiVersion. The example script uses a MutationObserver to detect ux-dialog elements. This is a practical mechanism for UI tweaks that the base client does not expose. The security note is blunt: scripts run with the same privileges as the Wand client, so only add scripts you trust.

Building it yourself: no official binaries, by design

The project deliberately does not publish compiled executables. Official GitHub releases contain release notes only, not .exe files. The README explains why: unsigned or self-built patching tools are repeatedly reuploaded, mislabeled, and flagged by third-party scanners. Scammers create fake YouTube tutorials using the project's name and put malware in the video descriptions. The only supported way to get an executable is to fork the repository, enable GitHub Actions, run the Build executable workflow, and download the artifact from your own fork. The README gives a step-by-step process: sign in, fork, use Sync fork before each build, enable workflows, select the Build executable workflow, run it on the default branch, and download the artifact. Then extract and run WandEnhancer.exe. Building from source on Windows requires CMake, Node.js and pnpm, Visual Studio 2022 or Build Tools with MSBuild, the Desktop development with C++ workload, and .NET Framework 4.8 desktop build tools. The build.cmd script installs web panel dependencies, builds the frontend, compiles the native helper with CMake, restores NuGet packages, and builds the WPF solution.

Limitations and failure modes

The most obvious limitation is that there is no official binary. If you are not comfortable with GitHub Actions and building from source, this tool is not for you. The second limitation is the security model of the remote panel. Plain HTTP with no pairing code means that on an untrusted network, anyone can control the app. The README explicitly says to use it only on a trusted LAN or VPN and never expose port 3223 to the internet. The third limitation is the antivirus issue. The README states that unsigned patching tools can trigger generic antivirus heuristics. Windows Defender or SmartScreen may warn about your own build because the artifact is unsigned. That is a practical barrier for many users. The fourth limitation is that custom scripts require the remote web panel patch to be enabled. If you disable that patch to reduce attack surface, you lose the script injection feature. The README also warns that scripts may run more than once per launch, which can cause subtle bugs if you do not guard one-time initialization. Finally, the tool patches a specific local installation. If Wand updates and changes the ASAR fuse location or the renderer internals, the patch may break. The README mentions automated compatibility adjustments for new client versions, but the exact mechanism is not documented, so you should verify compatibility with each Wand release.

Alternatives: what else does the same job?

The direct alternative is to patch Wand manually. You could locate the ASAR file in the Wand installation and flip the fuse byte yourself using a hex editor or a small script. That approach gives you full control but requires you to understand Electron's ASAR format and to redo the change after every Wand update. Wand Enhancer automates that process and adds the remote panel and script injection. Another alternative is to use a general-purpose Electron ASAR patcher or a devtools-based script injector that runs outside the app, such as a userscript manager in the renderer. Those tools do not modify the client binary and may be easier to update, but they typically cannot change the fuse byte, so they cannot enable the same level of integration. Wand Enhancer's approach is more invasive because it ships a version.dll proxy, but that proxy is what allows the fuse modification to happen inside Wand's own process. If you only need UI tweaks and not the fuse change, a userscript manager might be sufficient. If you need to modify the client's internal behavior, Wand Enhancer is more targeted than a generic hex edit.

Maintenance, upgrade cost, and license

The project is under active development. The last push was 2026-07-21 and the latest release is 1.0.9.4, with two earlier releases in the same month. The README instructs users to Sync fork before each build to get the latest fixes. That means you should rebuild from your fork every time you want to update, not just download a new release. The build process is automated via GitHub Actions, but you still need to run the workflow manually. The upgrade cost is therefore a recurring task: fork, sync, run workflow, download artifact, reapply the patch. The license is Apache-2.0, which permits commercial use, modification, and redistribution with attribution. Since the project is source-only, the license applies to the code you build. The README warns that third-party reuploads are not the project's responsibility, so you must verify the provenance of any source you use. The maintenance burden is on you: you must track Wand updates and check whether the patcher still works. The README mentions automated compatibility adjustments, but without a documented mechanism, you should treat it as a claim to verify rather than a guarantee.

Editorial conclusion

Adopt Wand Enhancer if you need to customize Wand's client-side UI, inject your own renderer scripts, or control the app from a phone on the same LAN, and you are comfortable building an unsigned executable from your own fork. Do not adopt it if you expect a ready-made installer, need to expose the panel beyond a trusted network, or cannot accept the risk of antivirus false positives from an unsigned patcher. Before using it, verify the integrity of your fork and the source, check the exact Wand version compatibility in the current release notes, and test the patch on a non-production Wand installation first. The project's own warning is explicit: only download artifacts from your own GitHub Actions run, never from third-party sites.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Community notes

Community notes