Wuddle brings addon management, DLL mods, MPQ patches, profiles, game launching, updates, and client-specific tools into one application for Vanilla 1.12.1, TBC 2.4.3, and WotLK 3.3.5 clients.
| Linux | Windows |
|---|---|
 |  |
 |
Warning
TL;DR: To avoid issues, every game installation directory where you intend to use the Mods tab should be whitelisted in your antivirus software.
If any mod fails to install, or if Windows Defender displays a notification as you install a mod, you need to whitelist your game install folder.
Various legacy DLL mods, including projects such as SuperWoW, UnitXP_SP3, and Nampower, are known to trigger false positives in antivirus software.
Wuddle warns you before installing known false-positive-triggering mods from the Quick Add list.
But since Wuddle performs the download and installation of these mods, your antivirus software may attribute the detection of a threat directly to Wuddle.exe itself.
The most reliable solution is to whitelist your game installation folder in your antivirus software.
If this sounds sketchy, Wuddle is open source and the code is available here on GitHub for you to inspect.
So to simplify the user-experience, Wuddle creates a hidden .wuddle cache/staging folder inside the game installation's root directory. This is where all Mods, Addons, MPQs and so on land when they first downloaded, Wuddle then moves the files to their target directories.
This makes things easier since you'd have to whitelist the game directory (or individual files) anyway, when installing DLL mods that trigger false-positives.
Screencast_20260414_150926.webm
- Install, update, reinstall/repair, and remove addons.
- Install from Git repositories, GitHub releases, direct
.zip/.7zURLs, or local archives. - Supports GitHub, GitLab, Codeberg, Gitea, and compatible Git repositories.
- Handles addon collections, nested addons, multiple
.toclayouts, and version-specific addon choices. - Compatible with existing GitAddonsManager-style addon layouts (but no guarantees).
- Detects locally modified tracked addons before replacing them.
- Install, update, repair, and remove DLL-based client mods.
- Enable or disable DLLs without uninstalling them through managed
dlls.txtentries and by appending.disabledto file names. - Supports direct DLL assets plus
.zipand.7zrelease packages. - Quick Add provides curated client-specific mods and companion addons.
- Install and manage custom MPQ patches from local files or archives.
- Detect existing custom, disabled, locale-specific, and core client MPQs.
- Rename, classify, protect, enable, disable, move, replace, and remove supported patches.
- Uses conflict checks, backups, and rollback when replacing existing files.
- Includes curated patches such as WDM and Project Epoch Water through Quick Add.
- Keep separate profiles for different WoW installations or servers.
- Each profile tracks its own addons, mods, patches, launch settings, and update state.
- Launch directly, through a custom command, or through supported external launch methods.
- Optional per-profile tab visibility keeps unsupported or unused management areas hidden.
- Starting Wuddle a second time focuses the existing window instead of opening another copy.
- When Awesome WotLK is installed, Wuddle offers easy patching of
Wow.exeto enable Awesome WotLK while retaining a backup. - When wow-optimize is installed, Wuddle provides an in-app shortcut to launch the wow-optimize launcher which acts as a configurator, directly from Wuddle.
- Optional Auto-Login (requires Awesome WotLK) stores account credentials in Windows Credential Manager or Linux Secret Service.
- Concurrent update checks for Git repositories, release-based mods, and curated patches.
- Stable and Beta self-update channels.
- Optional GitHub authentication and API-conservation controls.
- Install/update staging, ownership tracking, conflict checks, backups, and rollback.
- Backup and restore Wuddle profiles, settings, and tracked-project metadata.
- Reset Wuddle with an automatic recovery backup while leaving WoW installations and deployed game files alone.
- Privacy-sanitized verbose diagnostics for troubleshooting.
Wuddle is aimed at legacy WoW clients rather than modern Retail/Classic clients.
| Expansion | Client version | Features |
|---|---|---|
| Vanilla | 1.12.1 | Addons, DLL mods, MPQ Patches, Vanilla-Tweaks |
| The Burning Crusade | 2.4.3 | Addons, DLL mods, MPQ Patches |
| Wrath of the Lich King | 3.3.5 | Addons, DLL mods, MPQ Patches, optional Auto-Login |
Note
Wuddle may still work with these clients since much of its profile and launch functionality is not tied to a specific client version.
Even DLL mods and MPQ patches might work on newer clients up to around Legion (7.x).
However, there has been NO testing at all for these clients, and no support is offered to them. So please do not open issue tickets related to unsupported clients.
- Quick Add and Direct Archive Installs — Fixed a v3.7.0 regression where legitimate GitHub and GitLab redirect hosts were rejected as untrusted, blocking Quick Add mod installs and direct
.zip/.7zURL installs with a "Blocked asset host" error.
v3.x Changelog
- Backup and Restore — Export profiles, preferences, launch settings, and tracked addon/mod/patch metadata into one backup ZIP, or import a backup or older Wuddle installation. Restores are validated and staged before restart, with the previous data retained as a rollback copy.
- Reset Wuddle — Start over through an explicit confirmation, with an automatic safety backup and a choice to retain or remove system-vault credentials. WoW installations and deployed addon, mod, and MPQ files remain untouched.
- Fixed Windows Self-Updates — Portable updates no longer fail with
os error 32while validating the staged executable. - Responsive Backup Dialogs — Backup and Restore workflows grow as previews and controls appear, while keeping headers and action buttons visible and making smaller layouts scrollable.
- Reliable Restore Staging — Backups and older installations using SQLite WAL mode are converted into portable database snapshots before restoration.
- Single-Instance Activation — Starting Wuddle again on Windows now restores or requests attention from the existing window instead of displaying a file-lock error.
- One-Time Manual Update May Be Required — Windows users on an affected beta may need to download this release manually. Extract it over the existing folder, or import the old folder through Backup and Restore in the fresh copy.
See the full changelog for the technical details.
- Right-Click Copy and Paste — Editable text fields throughout Wuddle now provide a consistent, themed context menu.
- Selection-Aware Editing — Copy uses the current selection, while Paste replaces it or inserts text at the existing caret position without moving the caret when the menu opens.
- Safe Password Pasting — Secure password fields allow Paste without exposing their contents through Copy or diagnostics.
- Reliable Modified Addon Detection — Rescanning now identifies edited, deleted, and newly added files in Wuddle- and GAM-managed Git addons.
- No Extra API Usage — Modification detection compares against the local checked-out Git revision without contacting GitHub.
- Manual Addons Left Alone — Addons without a local Git baseline are excluded from modification scanning.
- Clearer Warnings and Diagnostics — Modified status is retained reliably, while prompts and privacy-safe logs better explain why an addon was flagged.
- Safer Updates for Modified Addons — Wuddle now asks whether to cancel, ignore future updates, or explicitly overwrite when an addon contains local changes.
- Better Batch Behavior — Update All completes unaffected projects before grouping modified addons into one confirmation dialog.
- Real Update Ignoring — Ignored projects are excluded from automatic and manual checks before any network or GitHub API request.
- Windows Line-Ending Fix — Normal CRLF/LF differences are no longer mistaken for local addon edits, further addressing Issue #18.
- Faster Update Checks
- Git repositories, release-based projects, and curated MPQ patches now check concurrently through separate bounded workloads.
- New checks begin as soon as a worker becomes available without weakening cancellation or timeout safeguards.
- More Reliable Repository Updates
- Stale and duplicate cached update entries are discarded when repositories are removed, replaced, or reloaded.
- Update All now skips vanished repositories instead of aborting the remaining batch.
- This is intended to address Issue #18, which remains open pending reporter confirmation.
- Reliable Lutris Launching
- Lutris launches are isolated from saved Custom command fields, preventing hidden Custom values from replacing the Lutris executable or arguments.
This beta completes a full security, reliability, and data-integrity review of Wuddle, addressing 75 documented findings.
- Safer Installs and Removals — Addons, mods, DLLs, and MPQs now use stronger staging, ownership checks, backups, and rollback handling.
- Stronger Security and Privacy — Hardened downloads, archives, README previews, redirects, credentials, diagnostic exports, and release assets.
- Reliable Profile Isolation — Delayed background work can no longer affect the wrong profile, database, dialog, or WoW installation.
- More Dependable Updates — Added bounded Git operations, cancellation, stronger cache validation, accurate multi-file checks, and safer API budgeting.
- Verified Self-Updates — Linux and Windows updates now validate exact packages and digests while retaining rollback copies.
- Launcher and Platform Hardening — Improved Windows version selection, restart handoff, single-instance ownership, Linux portable paths, and window restoration.
- Better MPQ Behavior — MPQ changes are more transactional, local patches are no longer incorrectly treated as remote repositories, and multi-file packages now have clean names plus a unified package editor.
- Expanded Diagnostics — Meaningful actions, file changes, metadata commits, failures, and rollbacks are now easier to trace without exposing private data.
- Window Position Memory
- Added an optional setting to remember Wuddle’s window size and position across restarts.
- Improved Platform Integration
- Added proper Windows executable icons, metadata, and application identity.
- Improved Wuddle’s icon identification on Linux desktops and Wayland.
- Update Check Deadlock — Fixed an expired GitHub rate-limit record potentially leaving Wuddle permanently stuck checking for updates.
- Linux Update Restart — Fixed Wuddle closing without restarting after installing an AppImage update.
- More Reliable Update Checks
- Prevented local file and antivirus scanning from indefinitely blocking update checks.
- Added a 30-second timeout and disabled further checks until restart after a timeout.
- Kept missing-file detection within the explicit Rescan/Repair workflow.
- Clearer Busy Indicator — Hovering the spinner now explains what Wuddle is working on, including repository progress and elapsed time.
- Conserve GitHub API — Added an optional setting for reducing anonymous GitHub API usage.
- Infrequently updated projects follow a longer update schedule.
- Their status now persists across profile switches.
- The setting automatically becomes inactive when unnecessary.
- Improved Diagnostics — Verbose logs now record privacy-safe update-check stages, timings, outcomes, and file-verification progress.
- Parallel repository checks are tracked independently.
- Exported summaries include the active operation when diagnostics are created.
- Improved Notifications — Added a smooth lifetime indicator to notifications.
- Hovering pauses and resets the timer.
- Lengthy tooltips and API-limit warnings are formatted for easier reading.
- Reliable Shutdown — Closing Wuddle now reliably terminates blocked background work on Windows and Linux, preventing invisible processes from blocking future launches.
- Update Check Stability — Duplicate update checks are ignored, preventing overlapping operations after waking from sleep or repeatedly pressing the update button.
- Clearer GitHub API Limit Feedback
- Wuddle now explains when GitHub's anonymous hourly limit has been reached and approximately when it resets.
- Notifications link directly to GitHub Token settings and consistently cover previews, updates, Quick Add, curated patches, and other GitHub operations.
- Invalid or expired token errors now provide clearer guidance.
- Consistent Settings Icons
- Replaced platform-rendered cogwheel emoji with a bundled SVG across profile editing, Auto-Login, configuration actions, and file details.
- Added theme-aware idle and hover colors with consistent sizing across UI scales while keeping the main Options icon visually distinct.
- Profile Database Recovery — Fixed migration errors that could prevent affected profiles from loading or installing mods and patches. Partially migrated beta databases now repair themselves automatically without losing tracked projects or installed-file records.
- Curated Epoch Water Patch — Added Project Epoch's water replacement to MPQ Quick Add, with README previews and update support.
- Project Details — Mods, addons, and patches now share a Details dialog for reviewing installed files and browsing their locations.
- Expanded MPQ Management
- Manage custom MPQs directly from the Patches tab, including names, locations, classifications, protection, and enabled states.
- Curated patch updates preserve filenames and locations chosen through Wuddle.
- Improved Quick Add statuses, README access, menus, browsing, and management controls.
- Friendlier Profile Management
- Profile cards now switch profiles when clicked, with a separate cogwheel for editing.
- Replaced user-facing "Instance" wording with the clearer "Profile."
- Redesigned Profile Settings for improved readability, keyboard navigation, and smaller screens.
- Cached client detection prevents incompatible tabs from briefly appearing while switching profiles.
- Clearer, More Consistent Dialogs — Standardized labels, descriptions, buttons, close controls, tooltips, and read-only README previews across Wuddle.
- Channel-Aware Changelogs — The About page now shows stable notes on Stable and individual prerelease notes on Beta, with clearer Beta guidance and duplicate headings removed.
- Safe Profile Removal — Removing a profile now closes its editor immediately, preventing an accidental Save from recreating it.
- Curated Patch Updates — Renaming WDM or Epoch Water files no longer creates false update notifications or loses the custom filename during updates.
- Browse and README Actions — Browse now opens the relevant installed location, and Awesome WotLK's README button no longer triggers an addon-folder installation prompt.
- MPQ Patch Management — Added a dedicated Patches tab for installing and managing MPQ-based client patches.
- Install local
.MPQ,.zip, and.7zpackages through a staged and validated installation workflow. - Detect existing custom, disabled, locale-specific, and core-client MPQs.
- Classify, protect, label, rename, enable, disable, and remove supported MPQs.
- Protect existing files by default, with conflict review, backups, rollback, and restoration when replacements are approved.
- Place locale-named patches in matching
Data/<locale>/directories while defaulting generic patches toData/. - Install and update WDM for WoW 3.3.5a, including optional Caverns & Mines content and the companion addon.
- Install local
- Per-Profile Tab Visibility — Instance Settings can hide Mods, Addons, Patches, or Tweaks for profiles where those management areas are unnecessary or unsupported.
- Instance Settings Layout — Launch Method now uses a compact dropdown, making the dialog easier to scan and leaving the segmented controls for selecting which management tabs are visible.
- Verbose Diagnostics — Record detailed internal operations and export a rolling, privacy-sanitized diagnostic ZIP for issue reports.
- GitAddonsManager Compatibility Layer — Recognizes GAM root addons, modular repositories,
.repocollision worktrees, linked or moved modules, backup folders, mixed-case names, and arbitrary Git remotes. - GAM-Compatible Deployment — Uses Wuddle's safer staging and conflict approval while finalizing new addon-git installs with GAM-compatible worktree names and module exposure.
- Git Remote Preservation — Follows the checked-out branch's configured upstream and preserves existing remotes instead of rewriting
origin. - Complete Addon Reinstalls — Reinstall / Repair prepares a fresh clone in staging, removes stale files, and preserves tracked repository settings.
- Notification Controls and Animation — Right-click in-app notifications to dismiss them, with subtle fade-and-slide transitions when they appear or close.
- Quick Add Catalog Polish — Adds LuaBoost as a companion addon for wow-optimize and clarifies the DXVK and antivirus warning text.
- Cancelled Conflict Installs — Cancelling an addon conflict no longer leaves a tracked repository or staged addon files behind.
- Conflict-Safe Finalization — Addon files and GAM metadata reach
Interface/AddOnsonly after conflict checks are accepted. - Addon Repository Switching — Replacing an addon with a same-named fork now keeps the newly selected repository through refresh and rescan. Should fix #17.
- Multi-TOC Addon Selection — Installing or reinstalling repositories such as Questie now requires an explicit main TOC choice and offers a client-aware suggestion.
- WotLK Auto-Login — Save multiple accounts per game profile using Linux Secret Service or Windows Credential Manager, then launch WoW 3.3.5 through Awesome WotLK without storing credentials in Wuddle's settings.
- Client-Aware Quick Add — See compatible Vanilla 1.12.1, TBC 2.4.3, or WotLK 3.3.5 presets, including Awesome WotLK and wow-optimize.
- WotLK Mod Tools — Patch Awesome WotLK safely with an automatic executable backup and launch wow-optimize's configuration interface from Wuddle.
- Single-Window Launching — Opening Wuddle again now focuses the existing window instead of starting another copy.
- Instance Management Refresh — Compact wrapping instance cards, clearer active-profile highlighting, and focused Auto-login controls make larger profile collections easier to manage.
- Collection Selection Tools — Add New and Manage Collection dialogs now include Select all and Clear all controls.
- Auto-Login Footer Polish — The account selector and borderless management cog include explanatory tooltips and cleaner launch feedback.
- Beta In-App Updates — Pre-release versions now compare correctly. The v3.6.1 version number was used to deliver this updater hotfix to existing v3.6.0 beta installations.
- Collection Conflict Replacement — Overwriting a conflict removes only the conflicting addon folders from an existing collection instead of deleting the entire collection.
- Case-Insensitive Auto Launch Targets — Explicit game executables resolve even when filename capitalization differs from the path saved in Wuddle.
- Local Archive Installs — Add addons from local
.zipor.7zfiles through the Add New Addon dialog. - Archive Drag-and-Drop — Supported desktops can install addon archives by dropping them directly onto Wuddle. (does not work on Wayland)
- GAM Compatibility — Rescan now better recognizes regular GitAddonsManager installs.
- Rescan Visibility — Rescan now logs what it is working on when a scan takes longer than expected.
- Direct Archive Links — Add addons from direct HTTPS
.zipor.7zdownload links, even when there is no repo to track for updates. - Release Asset Picker — GitHub release pages with multiple compatible archives now ask which one you want to install.
- Release Tag Installs — Links to a specific GitHub release tag now stay on that release instead of drifting to the latest one later.
- Main TOC Selection — Addon repos with multiple root
.tocfiles now let you choose which TOC defines the installed addon folder.
- Bundled Addon Libraries — Fixed single-addon repos with bundled library TOCs, such as Questie, being treated like collections or falling back to the wrong root TOC.
- 7z Release Support — Mods can now install from
.7zrelease archives in addition to.ziparchives and direct.dllassets.
- Add Dialog URL Flow — Add New Mod/Add New Addon URLs now resolve automatically after typing stops briefly, while Enter still resolves immediately.
- Addon-Git Branch Display — Branch selectors now show the branch that was actually installed when using a repository's default branch.
- Add Dialog Focus — Fixed Repo URL fields losing focus while previews load or resolve.
- Forked Addon Installs — Fixed addon-git forks with non-master default branches installing from the wrong branch.
- Mods Safety Warning — Added a per-profile warning when opening the Mods tab, with a "do not show again" option for each profile.
- Profile-Local Databases — New profile databases now initialize from that profile's own
Interface/AddOnsfolder instead of borrowing state from another profile. - Add Dialog URL Flow — Repo previews now resolve after pressing Enter, so incomplete URLs no longer interrupt typing or steal focus.
- Project Row Layout — Cleaned up tracked addon/mod row sizing, column widths, and expandable-row alignment.
- Collection Row Controls — Collection badges now open collection management, while the chevron or empty row space still expands and collapses the row.
- Per-Profile Update State — Ignored updates are now stored separately per profile.
- Profile Isolation — Fixed cross-profile addon leakage caused by old shared database fallback behavior.
- Overlapping Addon Folder Names — Fixed cases where different repos installing to the same folder name could make the wrong tracked project appear.
- 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.
- 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
For the complete release history, see CHANGELOG.md.
Wuddle is its own implementation, but parts of its functionality and UX were inspired by:
GitAddonsManager by WobLight
Git addon update workflows,.toc-driven deployment ideas, and branch-oriented addon management.WoWRetroLauncher by Parquelle
Sparked the idea for Wuddle's themes.vanilla-tweaks by brndd
WoW executable patching logic used by the Tweaks functionality.