Wand-Enhancer README

The project's README from github.com/k1tbyte/Wand-Enhancer. As one markdown file: README.md.

logo

WandEnhancer

GitLab Mirror

An open-source interoperability tool designed to extend local client-side configurations and improve the UX of the Wand application.

🚨 IMPORTANT NOTICE: THIS PROJECT HAS NO OFFICIAL YOUTUBE TUTORIALS, GUIDES, OR PREBUILT EXECUTABLE DOWNLOADS. 🚨 There are no official videos showing how to install or use this tool. Scammers are creating fake tutorials using this project's name and placing malware/password stealers in the video descriptions. Official GitHub releases contain release notes only, not .exe files. If you downloaded an .exe or archive from a YouTube link, a random website, or a third-party mirror, you did not get it from this project. We are not responsible for third-party downloads.

👾 What does it access?

The default .NET patcher modifies files in the selected local Wand installation and contains no update-checking or telemetry network code. Wand itself remains an online application, build tools restore declared dependencies, and the optional Remote Web Panel deliberately starts a LAN HTTP/WebSocket server and uses Wand API/CDN data. An explicit build-time option can include GitHub release notifications; that variant sends a GitHub API request with your IP and a User-Agent when Wand starts, but sends no Wand or account data and never downloads updates. Review the source and build the executable from your own fork; unsigned patching tools can trigger generic antivirus heuristics.

💫 What features are improved?

✅ Local environment configuration management
✅ Automated compatibility adjustments for new client versions
✅ Advanced layout and theme customization (Client-side only)
✅ AI Features
✅ Remote web panel (Remote Connect on mobile)

🌐 Remote Web Panel

WandEnhancer includes a built-in Remote Web Panel allowing you to control app features directly from your phone.

Quick Start:

  1. Ensure both your PC and phone are on the same Wi-Fi network.
  2. Hover over the Connect button in the top bar of WandEnhancer.
  3. Scan the displayed QR code with your phone's camera.

Troubleshooting & Remote Access:

👀 How to use?

This repository does not publish official compiled binaries. Build your own executable from your own fork using GitHub Actions.

  1. Sign in to GitHub and fork this repository.
  2. Use Sync fork before each build so your fork contains the latest fixes.
  3. Open your fork, go to the Actions tab, and enable workflows if GitHub asks you to.
  4. Select the Build executable workflow.
  5. Click Run workflow and start the run. Leave Include GitHub release checks when Wand starts off for a fully offline patcher, or enable it to compile in new-version notifications.
  6. Wait for the workflow to finish, open the completed run, and download the artifact.
  7. Extract the artifact zip and run WandEnhancer.exe to apply local client modifications.

Testing a release candidate

Here how you do it:

https://github.com/user-attachments/assets/7966cabe-0aa6-424d-8c2f-981ad91e0f91

🧩 Custom scripts

You can inject your own JavaScript into Wand at patch time to tweak or fix things in the client UI. This reuses the same renderer injection the Remote Web Panel uses, so it requires the Remote Web Panel patch to be enabled.

How to add a script

Then patch as usual — your scripts are bundled into the client and run inside Wand's window.

How it runs

Minimal example (hello.js)

// Injected scripts can run multiple times — guard one-time setup.
if (!globalThis.__helloScriptInstalled) {
  globalThis.__helloScriptInstalled = true;

  WandEnhancer.log("Hello from my custom script!", WandEnhancer.remoteUrl);

  new MutationObserver(() => {
    const dialog = document.querySelector("ux-dialog:not([data-seen])");
    if (dialog) {
      dialog.setAttribute("data-seen", "1");
      WandEnhancer.log("A dialog opened.");
    }
  }).observe(document.documentElement, { childList: true, subtree: true });
}

Scripts run with the same privileges as the Wand client. Only add scripts you trust and understand.

🛠️ How to build from source

Building from source on Windows requires a local development environment.

Requirements

Build steps

  1. Clone this repository.
  2. Install the requirements above and make sure pnpm and MSBuild are available.
  3. Run build.cmd from Command Prompt or PowerShell.

The build script installs dependencies, lints and type-checks the panel, builds production assets, runs web tests, builds WPF, and checks desktop patch state and structural JavaScript patches. Tests use temporary fixtures, not your Wand installation.

Update notifications are excluded by default. To compile them in locally, run build.cmd -EnableUpdateNotifications. When compiled in, the check runs on Wand's launch (on by default, toggle in Settings), shows a native Windows notification for a newer release, and opens the release notes when clicked (the release page when only the launcher is running). It never downloads or installs an update.

❓ Q&A

🖼️ Screenshots

1

2

📜 License

This project is licensed under the Apache-2.0 - see the LICENSE file for details.

❤️ Support

If you find this project useful, you can support its development using any of the options below 🙌

Patreon USDT TRC20 BTC ETH

Legal Disclaimer: This project is a third-party enhancement tool intended solely for educational, research, and local interoperability purposes. It does not distribute any proprietary code or bypass server-side validations. All modifications are performed locally to customize the user's interface.

Wand-Enhancer (k1tbyte/Wand-Enhancer)

Searching Database…

32.1K ·GitHub
Wand-Enhancer
Что это такое?Опенсорсный инструмент для расширения возможностей приложения Wand (WeMod) на Windows: он вносит изменения в вашу локальную установку, чтобы улучшить работу с программой — добавить настройку тем и оформления, функции на основе AI, а также удалённую веб-панель, которой можно пользоваться с телефона.
Это отдельное приложение или оно изменяет тот Wand, который у меня уже стоит?Это патчер, а не отдельное приложение: WandEnhancer.exe изменяет файлы в выбранной вами локальной установке Wand, а сам Wand остаётся тем же онлайн-приложением, которым вы уже пользуетесь.
Как его скачать? В релизах нет .exe-файла.Это сделано специально — релизы содержат только описание изменений. Сделайте форк репозитория на GitHub, откройте вкладку Actions, запустите workflow Build executable, скачайте zip с артефактом из завершившегося запуска и запустите из него WandEnhancer.exe.
Мой антивирус или Windows Defender будет ругаться на сборку?Возможно: артефакт не имеет цифровой подписи, поэтому SmartScreen может показать предупреждение, а общие эвристики антивирусов иногда помечают патчи-утилиты, даже если сборка сделана из вашего собственного форка. Изучите исходный код, проверьте логи workflow и считайте чужие собранные файлы недоверенными.
Будет ли это работать на macOS или Linux?Нет — это приложение Windows WPF, собранное через MSBuild под .NET Framework 4.8. С другого устройства в браузере доступна только удалённая веб-панель, но сам патчер сделан для Windows.
Он отправляет куда-то мои данные?По умолчанию с вашего компьютера ничего не уходит — патчер полностью автономен и не собирает телеметрию. Только если вы специально включите при сборке уведомления о релизах GitHub, каждый запуск Wand будет отправлять один запрос к GitHub API (IP и User-Agent), и обновления он никогда не скачивает.
Что именно он может менять в Wand?Управление локальной конфигурацией окружения, автоматическую подстройку совместимости под новые версии клиента, настройку оформления и тем на стороне клиента, функции на основе AI, а также встроенную удалённую веб-панель для управления приложением с телефона.
Как подключить удалённую панель с телефона?Подключите компьютер и телефон к одной Wi-Fi-сети, наведите курсор на Connect в верхней панели и отсканируйте QR-код. Панель работает по обычному HTTP/WebSocket на TCP-порту 3223 без кода сопряжения, поэтому используйте её только в доверенной локальной сети или через VPN и ни в коем случае не открывайте порт в интернет.
Могу ли я добавить свой JavaScript в клиент Wand?Да — добавьте .js-файлы в диалоге патча или положите их в папку renderer-scripts/ рядом с патчером. Они выполняются внутри рендерера Wand с полным доступом к DOM и к Node require, обёрнутые так, чтобы выброшенная ошибка никогда не приводила к падению Wand.
Почему нет официальных .exe для скачивания?Неподписанные сборки постоянно перезаливали, mislabel-или (выдавали за другие файлы) и помечали как подозрительные, а мошенники размещали фейковые уроки на YouTube с вредоносными программами в описаниях. Релизы содержат только описание изменений — так задумано; сборка из собственного форка — единственный доверенный способ.
What are similar projects?SteamTools, quiver-launcher, CircuitLordVRModInstaller, KillerPDF, CrypTool-2, MaterialDesignInXamlToolkit, Playnite, Captura
Which topics is it in?wpf, patcher, game-modding, remote-control, qr-code, theme, dotnet, c#, csharp, websocket, gaming, customization
Creator
k1tbyte
Size
2.4 MB
Stars
32.1K
Updated
CommitSep 09Release2.1.0.0Sep 09
Age
1y
Commits · 90 Days