StatTracker reads the game statistics of your World of Warcraft characters through a small addon, keeps every scan in a local database (with history) and lets you compare your characters on a page inside the program window (or opened in your browser) or in an Excel file. Everything stays on your computer.
- Windows program with its own window: the stats page is shown inside it, there is no browser to set up; English and German interface, six colour schemes
- Top 5: five tiles at the top of the page, each one value you chose (a statistic, summed up for all characters, a class, a race, a faction, a realm or one character)
- Rates per hour played (kills, deaths, gold) for each character and as a total; if a number cannot be worked out, the page says why
- Groups your characters by class, race, faction or realm
- Characters tab: leave characters out of the page, the history pages and the Excel file (by class, race, faction, realm, level or one by one) without losing anything, or delete a character from the database for good (with a copy first)
- A history page for every character with at least two scans: pick statistics and see them as lines over your scans
- Works per game version; by default only Retail is enabled
- Download
StatTracker.zipfrom the latest release and unpack it into your own folder, for exampleDocuments\StatTracker. Do not useC:\Program Files: the program keeps its data next to itself and needs write access. The download is about 160 MB because the program carries its own browser engine to show the page. - Start
StatTracker.exe. Windows SmartScreen may warn because the file is not code-signed: More info -> Run anyway. - Choose your WoW folder (the folder that contains
_retail_) and the account. - In the Addon group choose the game version and click Install / update addon.
- In game, once per character:
/statscan. The scan takes about 10 seconds (spread out so the game does not freeze): chat shows "Stat sync started", then "Stat sync done" and "Played time ... recorded". Wait for that, then/reload(or log out). The addon also scans automatically 10 seconds after login. - Read + open: it reads the data of every enabled game version one after the other and shows the pages in the Page tab of the window (choose the game version above) - or Export to Excel.
Repeat step 5/6 whenever you want fresh numbers. Scans that were read stay in the database. The addon itself keeps the last five scans per character, so a scan is only lost when more than five were made between two reads (the log says when scans may be missing): read the data after every play session if the history matters to you. Every WoW account has its own file; choose the account in the program (the log names the other accounts that have data).
The addon also records each character's class (as a language-independent name) and race with every scan. Scans taken with an older addon lack this data and it is never filled in afterwards: those characters are listed under "unknown" for class and race in the Groups block - nothing is guessed. Run Install / update addon and scan the character again to get it.
Each scan also records the specialization, the average item level, the equipped items (with enchantment, upgrade level and sockets) and the reputation list; they are stored in the database. The equipment is shown on the history page of the character (below); the reputation in the collapsible Reputation block of the stats page, which lists every faction of the ticked characters in the order of the game, with its level and a bar to the next one (friendships, renown and paragon included; account-wide reputation appears once). Scans taken with an older addon have none of this and it is never filled in afterwards: those characters are named under the block as without reputation data - scan them again with the updated addon.
The stats page shows race, class and level under each name. Its collapsible Groups block sums up the ticked characters by class, race, faction or realm: number of characters, average level, played time and the rates per hour. Any other statistic with a number can be added as a column (sum, average or maximum). A preset saves the grouping, the figures and the added statistics under a name; it is kept in the settings of the program (data/config.json), not in the page. The Excel export has no groups.
Every character with at least two scans also gets a history page, linked from the History block of the stats page: pick up to ten statistics and see them as lines over your scans, as absolute values or as an index (first value = 100). A scan without a number leaves a gap, nothing is filled in. Read + open makes the pages (for characters with a new scan or new item pictures) and needs no internet; the links work as long as the history folder lies next to the stats page.
Two more lines are on offer there: the equipped and the overall item level of every scan (the overall one takes the best piece of each slot among everything the character carries, so it is higher when a better piece waits in the bags). Above the chart a collapsible Character block shows the equipment of one scan, arranged like the character screen of the game: for every slot the item with its item level, upgrade track, enchantment, stats and a note on an empty gem socket, plus the sum of the secondary stats (the values of inserted gems are not in the stored data and are not part of it). You can pick any scan and compare it with the previous one; slots that changed are marked. The shirt and the tabard are left out.
The slots show the item pictures of the game when StatTracker has them. While reading the data it looks up the pictures of the items your characters wore in the game files of your WoW installation (read-only, the game may be running), keeps each as a small PNG file in data/icons and embeds them in the history pages; where a picture is missing the page keeps the symbol of the slot. Only the pictures that are still missing are read, so the first read takes a few seconds longer and later ones hardly any; the program makes no network request for them. The option Read item icons from the game files when importing in the Settings tab is on by default; with it off, the pictures read earlier stay visible. The pictures belong to Blizzard Entertainment: they are made on your computer from your own installation, they are not part of StatTracker, the picture above shows a few of them (© Blizzard Entertainment), and a history page that you pass on contains the pictures it shows.
The window has four tabs. Settings holds the game folder, game version and account, the options (game versions, update check, item pictures, the Design), the buttons and the log. Page shows the stats page inside the window; Reload reads the file again, and Open in browser opens a snapshot of what the window shows now - the ticked characters, filters, sorting, grouping and added statistics - as the file stats_snapshot.html next to the stats page (it is written again at every click). In the browser the controls of the snapshot are locked, because a page there has no connection to the program: it is a state, not a live copy. Top 5 sets the tiles (below). Characters leaves characters out or deletes them (below).
The Design dropdown offers six colour schemes; the window and the stats page follow it, and the change applies after a restart. A page opened in a browser shows the original colours.
Up to five tiles stand at the very top of the stats page. Each shows one value from the newest scan of your characters: a statistic of your choice, combined as a sum, an average or a maximum over all characters, over one class, race, faction or realm, or for one character. A tile names the statistic, the function and whom it is about, and says how many characters it is made of when some had no number ("10 of 23 characters"); where no number exists it says so, nothing is made up. Gold is shown in gold and played time in hours. The tiles do not follow the ticked characters.
Set them in the Top 5 tab: type a part of the name of a statistic and pick it from the list that opens under the box, choose the function and whom it is for (a click into the last box opens its list), then Save and write the page again. Every game version has its own tiles: choose the version above the rows; the page of that version is written again at once. A row without a statistic stays empty.
The Characters tab has a block for every enabled game version (choose the version at the top); a version without data shows a note instead.
Ignore keeps characters off the outputs and loses nothing: the database and the addon keep every scan, and the rules are applied again each time the page, the history pages or the Excel file are made. In the form pick a type (class, race, faction, realm, one character, or level under a number), the value from the list and for which outputs it counts (Page, which includes the history pages, and/or Excel), then Add to the list. The list shows each rule with its targets and how many characters it hits; "unknown" is a value too (characters scanned before class and race were recorded). Several rules work together: a character is left out as soon as one of them hits it. For a level the newest scan counts, so a character that reaches the level appears with its whole history. Changes are a draft ("Changed, not applied yet") until you press Apply, which saves the list in the settings and writes the page and the history pages of that game version again (the history page of a character that is left out is deleted and made again when the rule goes). The pages of the other game versions follow at the next read and the Excel file at the next export. Every game version has its own list.
Delete removes a character from the database of a game version for good, for example one you deleted in game. Pick the character, add it to the delete list and press Apply: a question names the characters, and with No nothing happens. With Yes StatTracker first copies the database into data/backups/delete/, then deletes all scans, equipment and reputation of those characters in one step (all or nothing) and writes the pages again. The deleted characters go on a blacklist, shown below the list: the addon keeps a character in its file even after you delete it in game, so without the blacklist the next read would bring it back. If you take an entry off the blacklist (tick it, Remove ticked from the blacklist), the next read takes that character in again as far as the file still holds it; an entry for a character you deleted in game can simply stay. To undo a deleting afterwards, restore the copy as described under "Where is my data?".
Only game versions you enabled show up in the dropdown. The default is Retail only. Open the Settings tab to enable WoW Forever; game versions that are not tested yet are greyed out there and cannot be enabled. Every game version gets its own database and page (wow_stats.db / stats.html for Retail, wow_stats_<version>.db / stats_<version>.html for the others).
| Game version | Status |
|---|---|
Retail (_retail_) |
tested, works |
WoW Forever (_forever_) |
tested, works; not all statistics are unlocked yet, that depends on the character level |
BC Anniversary (_anniversary_) |
tested, does not work: this game version provides no statistics, so there is nothing to read |
| all others | untested |
If WoW reports the addon as outdated: in game run /dump (select(4, GetBuildInfo())) and put the number into StatTracker.toc (## Interface:). The program sets it for you from .build.info when it installs the addon.
- Addon: Uninstall addon removes
Interface\AddOns\StatTrackerof the selected game version. It asks before it also deletes the data the addon stored inside WoW (StatTracker.luainSavedVariables) - default is to keep it. Your local database and pages are never deleted by this button. - Program: close it and delete its folder.
The window language is the dropdown at the top right of the Settings tab (German / English), remembered between starts; the first start follows your Windows language. The generated stats page and Excel file use the same language.
The names of the statistics come from the WoW client and are shown in the client's language - they are not translated by StatTracker.
At start (switch off in the Settings tab) StatTracker asks GitHub whether a newer release exists. If so, Update now downloads StatTracker.zip, verifies it against StatTracker.zip.sha256 (no checksum, no update), replaces only the program files and restarts. Your data folder is never touched. The previous version is kept in _update_backup and restored automatically if the new one does not start. The only network request is this check; it sends no personal data.
Next to the program, in the data folder: config.json (the settings, also the lists of the Characters tab), wow_stats*.db, stats*.html, the history folder (history_<version> for the other game versions; it can be made again from the database), the icons folder (the item pictures read from the game, icons_<version> for the other game versions; missing ones are read again), the webview folder (what the browser engine of the window keeps; nothing you need), stattracker.xlsx and the backups folder. Back that folder up if you care about the history.
Before an import writes to an existing database, StatTracker copies it into data/backups/:
daily/holds one copy per day for the last 7 days; older ones are deleted automatically.migration/holds one copy before every database upgrade (the file name says which version it leads to). These are never deleted automatically; delete them by hand once you no longer need them.delete/holds one copy before characters are deleted from the database in the Characters tab. These are never deleted automatically either.
To restore a copy: close StatTracker, copy a .bak file out of the folder, rename it to wow_stats.db (wow_stats_<version>.db for the other game versions) and put it into data. The copies lie on the same disk as the database: they protect against a faulty import or upgrade, not against a failing disk, so keep a backup of data somewhere else as well. If a copy cannot be written, the import stops and changes nothing. Before a copy is made, the database gets a quick integrity check; if it fails, the import stops as well, so a damaged database is not copied over your good copies - restore one as described above.
Python 3.10+ (the window is made with PyQt6, which the line below installs):
pip install -r requirements.txt
python src/start.pyWithout src/CascLib.dll the program runs but reads no item pictures; how to build it is in docs/DEVELOPMENT.md, which has more.
This software is provided "as is", without warranty of any kind, express or implied. You use it at your own risk. The author is not liable for any damage or loss arising from its use, including lost or damaged data, problems with your game installation or account, or consequences under the game's terms of service, which you are responsible for complying with.
StatTracker installs and removes files in your WoW folder, replaces its own program files when it updates itself, and writes a database next to itself - back up what matters to you (for example the data folder). See sections 15 to 17 of the LICENSE (disclaimer of warranty, limitation of liability).
Copyright (C) 2026 Wewoc. GNU General Public License v3.0 or later - see LICENSE. This is a fan tool; World of Warcraft is a trademark of Blizzard Entertainment, which is not affiliated with this project.
Third-party software: the history pages embed plotly.js 2.27.0, Copyright 2012-2023 Plotly, Inc., MIT license. It is not part of this repository: the build downloads it once and checks it against a fixed SHA-256, and its license notice stays in the header of the embedded file. The pages make no network requests.
CascLib by Ladislav Zezula (MIT license, https://github.com/ladislav-zezula/CascLib) reads the game files for the item pictures: the build fetches its source from GitHub at a fixed commit and builds CascLib.dll, which is part of the program. The license text is in THIRD_PARTY_LICENSES.md (in the info folder of the release).
The window is made with PyQt6 (GPL v3) and shows the pages with the Qt WebEngine browser engine (Qt 6 under the LGPL v3, based on Chromium); both come with the release, which is why the program is larger than before. Notices, license texts (LICENSE-LGPL-3.0.txt) and where the source code of Qt can be found are in THIRD_PARTY_LICENSES.md, which also names Python, PyInstaller and openpyxl.