Wuddle is a desktop WoW launcher/manager primarily focusing Vanilla clients, with support for:
- DLL mod management (install/update)
- Git-based addon management (inspired by GitAddonsManager)
- Multi-instance profiles
- One-click game launch per instance
Warning
Please scroll down and read the Important Note before downloading.
Screencast_20260414_150926.webm
Various DLL mods such as SuperWoW, UnitXP_SP3 and Nampower for the vanilla 1.12 clients are known to trigger false-positives in many antivirus products.
Wuddle displays a warning before adding known false-positive triggering mods from it's Quick Add section. If any false-positive mod is installed through Wuddle, antivirus tools may attribute the detection to Wuddle.exe because Wuddle performs the download/install action.
If this happens, you need to add the game installation folder to your Anti-virus' exclusions/whitelist or else the files will keep being deleted.
- Addon management: install, update, reinstall/repair, remove
- DLL mod management: install, update, reinstall/repair, remove
- Multi-forge support: GitHub, Codeberg, Gitea, GitLab
- Quick Add catalog: common Vanilla client mods with descriptions
- Companion addon links/info: shown directly in quick-add entries
dlls.txtmanagement: enable/disable mods in Wuddle without having to uninstall them- Multi-instance profiles: each profile has its own tracked mods/addons + launch config
- GitHub auth token (optional): helps avoid anonymous API limits (60 per hour)
- Logs panel: operational visibility and copyable logs
- Persistent Option State — Fixed an issue where "Auto check for updates," "Desktop notifications," and other preference toggles would revert to their default states after restarting the application.
v3.x Changelog
- Intelligent Addon Suggestions — Automatically badges the most compatible addon version during installation based on the detected WoW client version.
- Fast GitHub Repository Probing — Utilizes the GitHub Tree API to analyze repository structures and detect nested addons in milliseconds without requiring a full git clone.
- Primary Addon Selection UI — A new selection dialog for repositories with multiple .toc files that allows users to explicitly choose which version defines the addon folder name.
- Multi-TOC Health Support — Updated tracked addon health checks to correctly support folders containing multiple .toc files.
- Robust Manual Pruning — Enhanced maintenance logic to protect manual repositories with multiple expansion versions from incorrect database pruning.
- Refined Dialog Aesthetics — Removed redundant internal borders and increased internal padding for a cleaner, more spacious dialog interface.
- Enhanced Visual Feedback — Added a translucent suggestion badge style with high-contrast outlines and descriptive tooltips explaining the suggestion logic.
- Optimized Secondary Selection — Refined the "Install as Collection instead" button with subtle bordering and dimmed text for a more distinct secondary action.
- Engine Reliability — Improved error handling and folder detection robustness in the
wuddle-enginelibrary for complex repository structures.
- Up-To-Date Status Tooltips — The "Up to date" status badge now features an informative hover tooltip displaying the latest version (or commit ID) alongside the exact local installation timestamp.
- Streamlined Conflict Resolution UI — The file tree preview in the "Addon Conflict" dialog has been significantly cleaned up to exclusively display directories and filter out hidden system files/folders (such as
.gitand.editorconfig).
- Symlink Option Clarification — Added a tooltip clarifying that
Use symlink installs when possibleapplies to DLL and other non-addon_gitinstalls only. - Recursive Collection Selection — Top-level collection folder selections now resolve to nested
.tocaddon folders, and manage-collection checkboxes correctly reflect inherited and partial selection state even when the background probe is unavailable or still loading. - Install Toast Timing — Add/install success toasts now fire only after the installation step actually completes, so large collection installs no longer report success before the work finishes.
- GAM-Compatible Addon-Git Unpack —
addon_gitinstalls now follow GitAddonsManager-style unpack/move behavior across Linux and Windows for collections and multi-directory single addons, instead of exposing sub-addon folders from the.repoworktree as symlinks or junctions.
- Windows Close Handling — Fixed a Windows issue where closing Wuddle while it was still working could leave
Wuddle.exerunning in the background and keep files locked until the process was killed manually. - Busy State Recovery — Fixed stuck busy/spinner states caused by update flows not always clearing their in-progress state after failures or no-op results.
- Collection Selection Fallback — Fixed addon-git collection installs so explicit collection selections are preserved even when the addon probe fails before submit, instead of silently falling back to the wrong install set.
- Collection Removal on Windows — Fixed tracked collection removal with
Delete local filesso junction-backed addon folders and.repoworktrees are removed instead of being left behind on disk. - Collection Child Removal on Windows — Fixed removing a single addon from an installed collection so Windows junction-backed addon entries are deleted as links instead of recursing into the backing worktree and failing with
Access is denied. - Windows Directory Link Cleanup — Fixed collection uninstall paths to remove directory symlinks and junctions using Windows link-aware deletion instead of generic file or recursive directory removal.
- Collection Conflict Prompting — Changing a collection selection now opens a repo-aware overwrite confirmation instead of failing with an
ADDON_CONFLICTerror toast. The dialog shows which tracked addon folders would be removed and which conflicting folders would be installed, and the attempted selection is rolled back until the overwrite is confirmed. - Windows Launcher Icon — Added the Wuddle icon resource to the Windows launcher executable so
Wuddle.exeno longer shows the generic placeholder icon.
- Inline Mode Selector — The Add Repo dialog now features a compact "Single Addon / Collection" dropdown inline with the Repo URL field. Hovering the dropdown shows a tooltip explaining the difference between the two modes.
- Grouped Collections — Addons installed from a Collection now appear under a single expandable repository row with a badge showing how many addons belong to the collection (for example, "12 addons").
- Grouped Modular Single Addons — Single addons that include multiple modules now appear as an expandable group similar to Collections, with a badge showing how many modules were installed (for example, "6 modules").
- None.
- Collection Folder Checkboxes — Fixed collection folder checkboxes not appearing until the background addon probe completed (which could take 10–30+ seconds). Checkboxes now appear immediately when opening Manage Collection.
- Collection Toggle Silently Dropped — Fixed folder checkbox clicks being silently discarded in manage mode when the probe hadn't loaded yet. The selected state is now correctly updated on every click.
- Collection Matching Robustness — Improved the folder-to-addon matching fallback chain so checkboxes correctly reflect keep/remove state even before the probe finishes.
- Dialog Overlay — Fixed a gap where clicks on the dialog scrim could interact with content behind the dialog.
- Collection Addon Management — Treat addon-git repositories as real collections, choose which addon folders to keep directly in the Add Repo preview, and manage installed collections later without re-adding the repo.
- Nested Addon Discovery — Wuddle now detects addon folders with
.tocfiles up to 5 levels deep in addon-git repositories.
- Custom Executable Targeting — Profiles can now target renamed or irregularly named game executables for Auto launch and Tweaks instead of only relying on
Wow.exeorVanillaFixes.exe. - Targeted Tweaks Feedback — Tweaks now reports which executable is being inspected and clearly explains when the selected client is not compatible with legacy 1.12.1 patching.
- Collection Matching Fixes — Fixed collection management for repositories whose folder names differ from the installed addon name, including common GitHub suffixes like
-masterand-main. - Nested Install Linking — Fixed nested addon installs and repair flows so the correct repo-relative folder is linked or moved.
- Legacy Radio UI — Removed the in-app radio player and its related settings UI.
- Turtle-Specific Home Links — Removed the Turtle-only links section from the Home tab.
I like turtlesProfile Flag — Removed the old profile toggle that controlled Turtle-themed home content.
- Browse to Folder — Quickly open the local folder for any tracked addon or mod directly from the UI.
- Linux Stabilization — Addon path tracking is now case-insensitive, preventing re-import issues and "ghost" entries on Linux filesystems.
- Non-Blocking Rescan — Broken path repair runs asynchronously during Rescan, preventing UI freezes during intensive repair operations.
- Targeted Link Repair — Normal refresh and launch only verify tracked addon links and repair broken entries on demand instead of scanning broadly.
- Focused Startup Checks — Automatic update checks now stay on the network/version path instead of running addon maintenance work first.
- Rescan Phase Visibility — Rescan now logs repair, cleanup, prune, import, and dedup phases with timing details in the Logs tab.
- Cleaner Scans — Improved manual scanning logic now ignores metadata and non-addon folders by strictly validating for
.tocfiles. - Case-Insensitive Database — Implemented
COLLATE NOCASEin SQLite for repository lookups to prevent duplicate entries from varying URL casings.
- API Transparency & Log Filtering — Introduced a new
[API]log category with a dedicated filter button and Cyan highlighting for technical budget tracking. - Immediate UI Refresh — Successfully updated repositories are now instantly cleared from the Home tab's update list.
- Restored Detailed Logging — Verbose per-repository update reporting has been re-implemented for both single and bulk updates.
- Token-Aware Update Checking — Authenticated users now always perform full repository checks, while anonymous users benefit from optimized selective checks to stay within API limits.
- Visual De-cluttering — Removed "Infrequent Mod" indicators for authenticated users.
- Reliability Fixes — Corrected check timestamp logic to ensure fresh update results across both manual and auto-check modes.
- Anti-Virus safety warnings — Restored and generalized the warning dialog for mods known to trigger security heuristics (SuperWoW, VanillaFixes, UnitXP_SP3).
- Optimized Dialog Layout — Increased warning dialog width to 650px for better readability and refined installation logic to prevent uninformed mod additions.
- Turtle WoW background artwork — Restored the Turtle WoW artwork background on the Home tab for when the "I like turtles" preset is enabled.
- API Usage background sync — Integrated a 60-second background subscription to monitor GitHub API rate limits, keeping rate-limit tooltips accurate without consuming user quota.
- Live DLL Documentation — Wuddle now pulls "live" documentation for individual WeirdUtils modules directly from the project's README on Codeberg. Usage instructions and commands will now always be up-to-date.
- Improved Codebase Architecture — Complete refactor into a professional, modular structure for better maintenance and transparency.
- Fixed Scroll Stability — Resolved a persistent issue where clicking inline code blocks in descriptions would trigger unwanted list scrolling.
- Decoupled System Feedback — Radio connection states and other background tasks are now decoupled from the main UI thread for a smoother experience.
Wuddle v3 is a complete frontend rewrite from Tauri/WebView to Iced 0.14, rendering natively via wgpu (Vulkan/Metal/DX12). No WebView, no browser engine overhead.
- In-game radio player — stream the Everlook Broadcasting Co. radio with play/stop, volume controls (click-to-mute, scroll-to-adjust), auto-connect, auto-play, and configurable buffer via Radio Settings.
- DXVK Configurator — interactive
dxvk.confeditor with per-setting tooltips, syntax-highlighted preview, and Turtle WoW-specific presets. - Version pinning — per-mod dropdown to lock to a specific release tag while still tracking the latest version.
- Merge updates mode — per-repo toggle to keep existing files and only overwrite matching ones during updates.
- DLL count mismatch warning — prompts for Merge vs Clean update when the number of DLLs changes between releases.
- Multi-DLL expand/collapse — mods installing multiple DLLs appear as expandable parent rows with per-DLL enable/disable toggles.
- Remove dialog with file preview — scrollable file tree of every installed file before confirming removal.
- GitHub-flavored admonitions — README previews render
[!NOTE],[!TIP],[!WARNING], etc. with colored accents and icons. - Auto-scaling for smaller monitors — detects monitor resolution and scales the UI automatically, with manual scale buttons (75%–120%) in Options.
- GAM-compatible addon deployment — addons are now cross-compatible with GitAddonsManager and the TurtleWoW launcher out of the box.
- Mod cache in WoW directory — simplifies antivirus whitelisting on Windows.
v2.x Changelog
- Bidirectional settings sync between Tauri and Iced frontends
- Release channel selector (Stable/Beta) with seamless v3 upgrade path
- Add dialog repo preview with README, file tree, and About panel
- Clickable file preview with syntax highlighting
- Addon deduplication with case-insensitive matching
- Fixed desktop notifications on Linux (D-Bus via notify-rust)
- Scroll-aware edge fading, sticky dialog footers
- Performance improvements (shared HTTP client, targeted updates, LRU caches)
- Tweaks tab — patch WoW.exe with quality-of-life improvements (FoV, Farclip, Quickloot, Camera fixes, etc.)
- Desktop notifications for mod/addon updates
- In-app changelog viewer
- Linux AppImage self-update
- Adaptive update frequency
- Auto-clear WDB cache, ignore updates per-repo
- Assets-pending detection for self-update
- Mod file integrity checking via SHA-256
- Automatic cache cleanup
- Addon conflict detection dialog
- Auto-check for updates with configurable interval
- Turtle WoW home section with community links
- Visual theme picker
- Evolved from DLL updater into launcher + manager
- Addon management with Git clone/pull and branch selection
- Home tab with PLAY button and per-instance launch methods
- Multi-instance profile switching
- Visual themes
Wuddle is its own implementation, but parts of the functionality and UX were inspired by:
-
GitAddonsManager by WobLight
Git addon update workflows,.toc-driven addon deployment ideas, and branch-oriented addon management. -
WoWRetroLauncher by Parquelle
Sparked the idea for Wuddle's themes. -
vanilla-tweaks by brndd
WoW.exe binary patching logic for the Tweaks tab (FoV, farclip, quickloot, camera fixes, etc.).