English · Русский · Deutsch · Français · Español
Website: wow-tool.gronck.com
A small Windows tray app for World of Warcraft that keeps your settings and addons safe:
- Backups of
WTF(key bindings, macros, chat, CVars, addon settings) andInterface\AddOns— after every game session or on a schedule, for every game version you have installed. - One-click restore to any earlier point, with the current state saved first, so a restore can always be undone.
- Copying settings between characters: bindings, macros, chat windows, frame layout, enabled addons, addon settings.
- Addon updates through the addon manager you already use — CurseForge, WowUp, WowUp-CF or the Wago App — started without a window, on a schedule, never while you are playing. ElvUI, which none of them carries, straight from its official site.
- Game patches: when Battle.net updates the game, settings and addons are saved before its first start on the new version, and you see which addons are not made for it yet.
- Cleanup: settings of removed addons, WoW's
.bakcopies, old combat logs, screenshots and the cache — with sizes, in one click. - UI profiles: save a character's interface (Edit Mode layouts, chat, addons and their profiles) and put it on another character in two clicks.
- Updates itself: checks GitHub once a day and installs a new version in one click.
- English, Russian, German, French and Spanish.



- Requirements
- Installation
- The tray icon and the panel
- Settings
- Backups: how they work
- Restoring
- Addon updates
- Game patches
- Cleanup
- UI profiles
- Copying settings between characters
- Command line
- Files and folders
- Privacy and safety
- Updating WoW Tools
- Uninstalling
- FAQ and limitations
- Building from source
- Verifying downloads
- License
-
Windows 10 or 11, 64-bit. Nothing else to install: it is a single
.exewith no runtime dependencies. -
World of Warcraft installed through Battle.net. Every game version is supported: Retail, Classic (progression), Classic Era / Hardcore / Season of Discovery, Anniversary, PTR, beta, and versions that do not exist yet — anything in a
_name_folder next to_retail_. -
For addon updates only — one of these, installed and set up (signed in, game folder chosen):
- CurseForge app;
- WowUp or WowUp-CF (the CurseForge-enabled build);
- Wago App — for WeakAuras and UI packs only, see below.
Backups, restore and character copying work without any of them.
Every release has the same program in three forms — pick one:
| File | What it is |
|---|---|
WoW-Tools-Setup-x.y.z.exe |
Installer. Installs for your Windows user into %LOCALAPPDATA%\Programs\WoW Tools (no administrator rights), adds a Start menu shortcut and, if you leave the box ticked, starts with Windows. Removed in Settings → Apps → Installed apps. |
WoW-Tools-x.y.z-portable.zip |
Portable. Unpack the WoW Tools folder anywhere (a USB stick too) and run wow-tools.exe. Settings, backups and the log stay in that folder — see Files and folders. |
WoW-Tools-x.y.z.exe |
The bare exe. Put it in a permanent folder (autostart remembers its path) and run it. Settings are kept where the installer keeps them. |
Or from the command line with winget, which comes with Windows 10 and 11:
winget install Gronck2.WoWTools
This runs the same installer silently; winget upgrade Gronck2.WoWTools and winget uninstall Gronck2.WoWTools do
the rest.
On the first start a tray icon appears; the game folder is found automatically (registry, Battle.net, common paths). Starting the program again while it is running opens the settings window.
WoW Tools is not code-signed, so Windows SmartScreen may warn about an unknown publisher when you open a downloaded file: choose More info → Run anyway. Updates WoW Tools installs itself do not show this warning. To check that a file is genuine, see Verifying downloads.
The icon shows the current state:
| Icon | Meaning |
|---|---|
| grey emblem | the game is not running |
| gold emblem | the game is running (the backup will be taken after it exits) |
| blue dot | working: backup, restore, addon update, cleanup or a profile |
| red dot | the last operation failed (hover the icon or open the panel to see why) |
| green arrow (top) | a new version of WoW Tools is out: install it from the panel or the menu |
Left click opens the panel (Windows 11 style, follows the light/dark theme and the accent colour):
- Backup tab: when the last backup was taken and when backups run, Back up now, and the latest restore points of every game version with a Restore button (confirmed right in the row). While a snapshot is written, the tab and the icon's tooltip show what is being saved and how far it is ("Snapshot Retail · AddOns: 45%"), and the button fills up like a progress bar.
- Addons tab: when addons were last updated, Update addons, and the last five update runs — what was updated or what went wrong (hover a row for the full text).
- Cleanup tab: what can be tidied up in WTF and the game folder, with sizes and a button each — see Cleanup.
- Profiles tab: saved UI profiles and Save a profile — see UI profiles.
- A tab can be dragged to another place along the strip; Settings → General → Panel tabs hides the ones you do not need.
- At the top: the lock, the paperclip, the backups folder and the settings (hover one to see what it does); at the bottom: Start with Windows. The panel closes when you click elsewhere; with the paperclip pressed it stays open until Esc or a click on the tray icon (when another window covers it, that click brings it to the front instead). With the lock open the panel can be dragged by its header, and it opens where you left it; closing the lock keeps it there.
Right click opens the menu: the panel, back up now, update addons, backups folder, settings, log, autostart, exit.
Notifications appear for the results of what you started yourself and for new errors; Notifications in Settings → General turns them off.


Every change is saved at once and applied without a restart.
- General: game folder (found automatically, can be set by hand), which game versions to work with (backups, cleanup, profiles), Panel tabs (order, which are shown), language, start with Windows and Notifications.
- Backup: when to back up (After the game closes, By weekday — chosen weekdays at a set time, or Every N days — every 2 … 30 days at a set time, counted from the day of the last snapshot), how many snapshots to keep, the Back up addons and Wait for the game to exit switches, the backups folder.
- Addons: a note first — WoW Tools does not download addons itself (except ElvUI): it starts the chosen manager, and which addons are updated and which version comes (release, beta, alpha) is up to the manager's own settings. Then a warning — the addon manager installs a new version over the old one, so changes you made to an addon's files by hand are lost: mark such addons as not updated in the manager (CurseForge: auto-update off, WowUp: Ignore); WoW Tools saves a copy of the AddOns folder before every update. Then Update automatically and when — By weekday (days and time), Periodically (every 30 min … 12 h) or At start (a minute after WoW Tools starts, usually when you sign in to Windows; skipped if addons were updated within the last hour); then Update with, ElvUI and Don't update while playing, which also apply to the panel's update button. Below, every addon that is not made for the current game version (see Game patches).
- Screenshots: where the cleanup moves screenshots and how it sorts them (see Cleanup).
- About: the current version with Check / Install, Check for updates, Tell me about a new version
(works even with notifications off; during a game it waits for it to close), a link to
config.tomlfor the rarely needed options, and Diagnostics → Copy, which puts the version, settings, addon update history and the end of the log on the clipboard, to send along when something does not work (your user folder is replaced with%USERPROFILE%).
A selected option is marked with a check mark.
- A snapshot is a zip archive of a folder:
WTFandInterface\AddOnsare archived separately, for each game version separately. Inside, paths are relative to the game version folder. - A snapshot is taken only if something changed: WoW Tools remembers a fingerprint of the folder (file paths, sizes, modification times) and skips unchanged ones. Addons, which rarely change, cost almost nothing.
- While a game version runs, its snapshots are skipped: WoW writes
WTFand addon settings when you log out or exit, so a copy made during play would be half old. Other versions are backed up as usual. In after the game mode the backup is taken a few seconds after the client closes. - By weekday and Every N days: if the computer was off at the scheduled time, the backup is taken when it is back on; if the game was running, right after it closes. A manual backup counts as a scheduled one.
- Retention: the latest
keepsnapshots (30 by default) of each series are kept, older ones are deleted. *.bakand*.oldfiles are left out (that is why a 155 MBWTFusually fits in ~13 MB). The list isexclude_extinconfig.toml.
Restore in the panel returns WTF and addons of that game version to that moment. The game version must be
closed (others may run). Before anything is replaced, the current state is saved as a snapshot labelled
before restore, so you can always go back.
A restore unpacks the archive into a temporary folder next to the real one and only then swaps the folders, so an
interrupted restore never leaves a half-written WTF.
The AddOns snapshots taken before update are not listed in the panel: wow-tools list --kind addons shows them,
wow-tools restore <id> --kind addons undoes an addon update and leaves settings as they are.
Before a cleanup, a UI profile or a settings copy a WTF snapshot is taken too (before cleanup, before profile,
before copy). It is a safety net: the panel lists the ones before cleanup and before profile; several such actions within 10
minutes share the one taken before the first, unless the game changed WTF in between. wow-tools list --kind wtf shows them, wow-tools restore <id> --kind wtf brings one back.
From the command line: wow-tools restore (latest), wow-tools restore 20261012 (the latest of that day or earlier),
--kind wtf or --kind addons for one part only, --flavor _classic_era_ for another game version.
WoW Tools does not download addons itself (except ElvUI). It runs the addon manager you already have, lets it do its usual update and closes it. This keeps the manager's own records correct and respects authors who allow downloads only through official clients.
Only one program is used: two managers working on the same AddOns folder overwrite each other's files. If you
have several, choose one in Settings → Addons; if there is just one, it is used automatically.
Every run, automatic or manual:
- With Don't update while playing on (the default), nothing happens while any game client runs; the update waits until the game is closed.
- An
AddOnssnapshot labelled before update is taken —wow-tools restore <id> --kind addonsundoes the update. - The program is started without a window, updates, and is closed. A program you already had open is left alone — it is not started a second time and not closed. If its own auto-update is off, nothing gets updated then: the history shows not updated, and a scheduled update tries again every half hour until the program is closed.
- The result goes to the update history: which addons were updated, which still wait (for example set to manual updates in the program), or why it failed.
If auto-update is off in the program, it is switched on just for this run and switched back afterwards (even if the run was cut short — that is undone the next time). Addons you set to manual or ignored in the program are not touched.
Started with --minimized (to its tray, as its own autostart does). WoW Tools follows its log until the update check is
done and nothing has been installed for a minute (10 minutes at most), then closes it.
Started with --hidden --quit: one silent auto-update round, then it exits by itself. WowUp only updates addons that
have auto-update enabled; WoW Tools enables it for this run for every addon that is not ignored.
Addons from Wago through WowUp. Plain WowUp gets its Wago download permission from the ad shown in its window. Started without a window, it gets none, and Wago refuses the download. Such addons are listed in the history with this reason. Update them by opening WowUp, set a Wago key in WowUp's settings, or use CurseForge / WowUp-CF if most of your addons come from there.
The Wago App has no unattended addon update — only its Update All button — so as the chosen program it updates
WeakAuras and UI packs only. Two switches appear when it is chosen: WeakAuras and UI packs. The app is
started minimized, writes its updates to AddOns\WagoAppCompanion (WeakAuras, applied in game) and
AddOns\WagoUI_Storage (UI packs), and is closed once it has been quiet for 15 seconds. A part you switched off is
kept exactly as it was. With both off there is nothing to do and the app is not started.
ElvUI is not on CurseForge or Wago, so no addon manager updates it. With the ElvUI switch on (the default), every
update run also asks the official site tukui.org for the current version. Every game version
that has ElvUI installed and is behind gets the new zip: the ElvUI, ElvUI_Libraries and ElvUI_Options folders
are replaced whole, so files an older version left behind go too (a leftover ElvUI_Mainline.toc would make the game
load the old version's file list). An install that mixes versions this way is reinstalled even when the version
matches. ElvUI plugins (ElvUI_WindTools and the like) are left alone, and game versions without ElvUI get nothing.
This also works without any addon manager installed.
Once a minute WoW Tools compares the version of every game client (as Battle.net reports it) with the last one it
saw. A new version while that game is closed means Battle.net has just patched it and the game has not run on it yet
— the moment when WTF and the addons still hold their pre-patch state. WoW Tools then:
- saves
WTFandAddOnsas snapshots labelled before patch (one click in the panel brings them back if the first login after the patch resets something); - shows a notification with the new version and the addons whose
.tocwas not made for it (the game would show them as "out of date").
Which addons are not made for the current version is always listed in full at the bottom of Settings → Addons (the
card turns yellow while there are any), and printed by wow-tools outdated. Addons are judged by major and minor
version (12.0 → 12.1 counts, a 12.1.0 → 12.1.5 hotfix does not); an addon with no version number for this game at all (a Classic-only addon on Retail, a library) is not judged.

The Cleanup tab of the panel shows what can go, with the number of files and their size, for the game versions you back up. It is read again every time you open the tab and after every cleanup; hover a row for what it is about. The list button of Removed addons and of Biggest addon settings opens the full list, with sizes, over the tab (scroll with the wheel, close with ✕ or Esc).
| Row | What | What happens |
|---|---|---|
| Removed addons | SavedVariables\*.lua of addons that are no longer in Interface\AddOns (Blizzard's own files stay) |
deleted; WTF is saved as a before cleanup snapshot first |
| .bak and .old copies | the copies WoW makes of every settings file on exit | deleted (WoW makes them again; snapshots never include them) |
| Biggest addon settings | settings files of 5 MB and more | only shown: bloated files slow loading down, clean them in the addon itself |
| Old combat logs | Logs\WoWCombatLog*.txt |
deleted; logs younger than a week stay, in case an upload to Warcraft Logs is pending |
| Screenshots | Screenshots\* |
moved, by default to Pictures\World of Warcraft\<version>\<YYYY-MM>\ (nothing is overwritten); the folder icon opens that folder |
| Cache and errors | Cache and Errors |
deleted; the game rebuilds the cache — the usual cure for oddities after a patch |
Screenshots are moved only by hand, with this button; backups and schedules leave them alone. The Screenshots tab
of the settings sets where they go and how they are sorted: folders By day, By month, By year or
No folders (the date comes from WoW's file name, WoWScrnShot_MMDDYY_HHMMSS), and A folder per game version
on or off. With it on, every selected game version has its own card: Change… picks any folder for it, Auto
goes back to <common folder>\<version>. Sorting by character is not possible: WoW does not write who took a
screenshot.
Every button asks Sure? first. While it works, a spinner stands in for the button, and the result shows in the row. Only the cache
of a running game version waits for it to close; everything else is tidied up while you play (the game does not hold
those files). From the command line: wow-tools clean
shows the same list, wow-tools clean orphans backups logs screenshots cache (any of them) tidies up.

A profile is everything that makes a character's interface, saved under its name: in the panel's Profiles tab, Save a profile → Choose… lists your characters (recently played first). Apply… on a profile asks which character to put it on, then Apply in the row. Hover a profile to see what it holds; the bin deletes it. If nothing of the character changed since its last profile, a new one is not saved (the row says so). In the character list just type to search by name or realm (Enter picks the first one, Esc clears the search). While the profile's game version runs, Apply… is off: the game would rewrite the settings when it exits.
The character lists show only characters the account has now: folders of deleted, renamed or transferred characters
stay in WTF, so WoW Tools compares them with the game's character list (character-list-order.txt, GUIDs only) and
the names addons keep for those GUIDs (BigWigs, WorldQuestTracker, AllTheThings, RCLootCouncil...). A realm with a
character not played since then is not filtered: nothing there is hidden by guess.
What goes into a profile:
- the files of the character's folder
WTF\Account\<ACCOUNT>\<Realm>\<Name>: chat, Edit Mode layouts, enabled addons, the character's own addon settings (SavedVariables); - the account's Edit Mode layouts (
edit-mode-cache-account.txt); - for addons that keep their settings account-wide as profiles (ElvUI, BigWigs, Clique, TomTom and others built on AceDB): which profile the character uses, and that profile's contents.
Key bindings, click bindings and macros are not in a profile: they belong to the character, and the target keeps its own. Profiles saved by older versions still hold them, but they are not applied.
Applying copies the files and switches those addons of the target character to the same profile. On the same account the two characters then share it: a change in ElvUI on one shows on the other, as with a shared profile in the game. On another account the profile is added there; if that account already has a different profile of that name, the copy gets the source character's name, so nothing of the other account changes. An addon that never ran on the target account is left alone and named in the result. The game version of the profile must be closed; a WTF snapshot before profile is taken first (see Restoring).
Edit Mode layouts are added, not overwritten: the layouts the source character uses join the target's own character layouts, and the target's specializations switch to them. The target's own layouts stay. A layout already on the target's account is used as it is. If a name is taken, the copy gets the source character's name in brackets, e.g. "Main (Groncky)". A character can have at most 5 layouts of its own; a layout that does not fit is named in the result, and those specializations keep their layout. A profile from another account saved by an older version cannot carry the account layouts it uses.
From the command line: wow-tools profile save "Tarren Mill/Gronckk", wow-tools profile list,
wow-tools profile apply 1 --to "Tarren Mill/Groncky", wow-tools profile delete 1.
Characters live in WTF\Account\<ACCOUNT>\<Realm>\<Name>. To copy one character's setup to others:
wow-tools chars
wow-tools copy-char --from "Tarren Mill/Groncky" --to "Kazzak/Groncky" --dry-run
wow-tools copy-char --from "Tarren Mill/Groncky" --to "Kazzak/Groncky" --to "Silvermoon/Gronckowski" --parts bindings,macros,savedvars
| Part | What | File |
|---|---|---|
bindings |
key bindings | bindings-cache.wtf |
macros |
character macros | macros-cache.txt |
chat |
chat windows and channels | chat-cache.txt |
config |
character CVars | config-cache.wtf |
layout |
frame positions | layout-local.txt |
addons |
which addons are enabled | AddOns.txt |
savedvars |
character addon settings | SavedVariables\*.lua |
Without --parts everything is copied. Names are case-insensitive (Cyrillic too); if a name exists on several
accounts, write ACCOUNT/Realm/Name. WTF is saved as a before copy snapshot first, and the game version must be
closed.
Key bindings and macros may be stored on Blizzard's servers (the synchronizeBindings / synchronizeMacros CVars),
in which case the server copy can override the copied files on login.
wow-tools with no command starts the tray. Everything else is also available from a console:
| Command | What it does |
|---|---|
init [--wow-path DIR] [--backup-dir DIR] |
create the config (the game folder is found automatically) |
status |
the install found, game versions, settings, addon programs and pending updates |
backup [--flavor F] [--kind wtf|addons] [--force] |
take a snapshot (only of what changed unless --force) |
list [--flavor F] [--kind K] |
list snapshots |
restore [ID|DATE|latest] [--kind K] [--flavor F] [-y] |
restore, saving the current state first |
chars [--flavor F] |
list characters |
copy-char --from C --to C [--to C…] [--parts …] [--dry-run] |
copy settings between characters |
profile save C [--flavor F] / profile list |
save a character's UI profile / list the profiles |
profile apply N --to C / profile delete N |
put profile N (from the list) on a character / delete it |
update-addons |
update addons now through the chosen program |
watch [--interval N] |
what the tray does, in a console window |
schedule logon [--headless] |
start the tray at sign-in (--headless: watch without an icon) |
schedule interval [--every MIN] |
a Task Scheduler task running backup every N minutes (a day by default) |
schedule status / schedule remove |
show / remove autostart and the task |
outdated |
addons not made for the installed game version |
clean [orphans|backups|logs|screenshots|cache …] |
show what can be tidied up; with items, tidy them up |
self-update [--check] |
check GitHub for a new version of WoW Tools and install it |
Common options: --config FILE (another config), --log-to-file, -v. wow-tools <command> --help explains the
rest in the chosen language.
| Path | What |
|---|---|
%APPDATA%\WoW Tools\config\config.toml |
settings |
%LOCALAPPDATA%\WoW Tools\data\backups\<version>\wtf\*.zip, ...\addons\*.zip |
snapshots (folder changeable) |
%LOCALAPPDATA%\WoW Tools\data\backups\profiles\<version>\*.zip |
UI profiles (in the backups folder) |
%LOCALAPPDATA%\WoW Tools\data\wow-tools.log |
log of the tray |
%LOCALAPPDATA%\WoW Tools\data\addon-updates.json |
update history (last 20) |
%LOCALAPPDATA%\WoW Tools\data\self-update.json |
when WoW Tools last checked for a new version |
%LOCALAPPDATA%\WoW Tools\data\game-versions.json |
the game versions last seen, to notice a patch |
The portable version uses none of these: while portable.txt lies next to wow-tools.exe, the settings are in
config\config.toml and everything else in data\ beside the exe (backups in data\backups). Delete
portable.txt to switch to the usual folders.
Snapshot names are YYYYmmdd-HHMMSS[-label].zip; they are ordinary zip files and can be opened by hand.
config.toml also holds what the window does not show: exclude_ext (left-out extensions, ["bak", "old"] by
default) and language (ru, en, de, fr, es; absent = the Windows display language).
- WoW Tools connects to two places itself. GitHub, to look for a new version of WoW Tools (see Updating WoW Tools) — once a day, and it can be switched off. And tukui.org, during an addon update run when ElvUI is installed and its switch is on, for ElvUI. Both are plain requests for the latest version, like opening the download page in a browser; nothing about you, your game or your addons is sent.
- Addons are downloaded only by the addon program you chose — except ElvUI, which WoW Tools takes from its official site.
- It never touches the game itself, does not read game memory and does not automate anything in game.
- It writes to the game folder only when you restore, copy character settings, tidy up, or an addon program updates addons — and whatever touches settings or addons takes a snapshot first.
WoW Tools checks this repository's releases once a day (and when you press Check in Settings → About). When there is a newer version:
- a green arrow appears on the tray icon, and a notification once (during a game, after it closes);
- the panel shows a button with the new version number next to the folder and settings icons;
- the menu gets Update to x.y.z, and the settings show Install.
One click downloads the new exe, checks it against the SHA-256 checksum GitHub publishes for the release file (a file
that does not match is never installed), puts it in place of the current one and restarts the tray. The old exe is
kept as <name>.exe.old until the next start, then removed. If a backup or an update is running, the restart waits
for it to finish. Your settings, snapshots and autostart stay as they are. This works the same in all three forms;
for an installed copy the version in Installed apps is updated too, and winget upgrade works as well.
From the command line: wow-tools self-update --check (only check) or wow-tools self-update (check and install;
restart the tray afterwards). To stop checking, turn off Check for updates in Settings → About
(check_updates = false in config.toml).
Installed (installer or winget): Settings → Apps → Installed apps → WoW Tools → Uninstall, or
winget uninstall Gronck2.WoWTools. It closes the tray, removes the autostart and the scheduled task, and asks
whether to delete the settings and the backups too.
Portable or the bare exe:
- Turn off Start with Windows (or run
wow-tools schedule remove, which also removes a scheduled task). - Choose Exit in the tray menu.
- Delete the portable folder, or the exe and, if you do not need the settings and snapshots,
%APPDATA%\WoW Toolsand%LOCALAPPDATA%\WoW Tools.
- Restore says the game is running. Close that game version (the Battle.net launcher may stay open).
- Copied bindings disappeared after login. They are synchronised with the server; see above.
- The update says "No updates.", but the program shows updates. Those addons are set to manual or ignored in the program, or (WowUp) come from Wago — see the history row for the reason.
- Can several addon programs be used at once? No, on purpose: they break each other's addons.
- Where is the game folder found? The registry, Battle.net's install list, then the usual paths
(
C:\Program Files (x86)\World of Warcraft,X:\Games\World of Warcraft, …). Game versions Battle.net installed in other folders are found too. Otherwise set it in Settings → General.
cargo build --release
Rust stable, Windows. CI (GitHub Actions) checks formatting, clippy, tests and the build on every push; a vX.Y.Z tag
matching the version in Cargo.toml builds the exe, the installer (Inno Setup, packaging/installer.iss) and the
portable zip and drafts a release; publishing it sends the new version to winget. Texts are in
locales/<language>.toml.
WoW Tools is not code-signed. Instead, every release file can be checked:
-
Checksum. The release notes list the SHA-256 of each file; compare it with
Get-FileHash .\WoW-Tools-Setup-x.y.z.exe. -
Build provenance. Each file has a GitHub attestation showing it was built by this repository's release workflow on GitHub Actions from the tagged source, not uploaded by hand. With the GitHub CLI:
gh attestation verify WoW-Tools-Setup-x.y.z.exe --repo Gronck2/wow-tools -
WoW Tools' own update checks the new exe against the SHA-256 GitHub publishes for it before installing (see Updating WoW Tools).
Licensed under either of Apache License, Version 2.0 or MIT license, at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in WoW Tools by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.