Description
ItemWatch
A World of Warcraft addon for tracking specific item counts — a movable, resizable box you drag items into, with goals, per-item sounds, and a minimap button. Also builds a shopping list straight from any crafting recipe, and can track the items a vendor wants in trade.
Built for farming, collecting, or any situation where you need to keep an eye on an exact item count without repeatedly opening your bags.
Features
- Item Box — a movable, resizable container for everything you're tracking. Drag items from your bags straight onto it, right-click an icon inside to remove it.
- Recipe Shopping List — click "Add to Shopping List" on any recipe in the Professions Recipes tab, and ItemWatch reads its full reagent list and builds a shopping list for you automatically. It holds as many recipes as you like, so leveling a profession is easy: add the wrist guards, the chest and the legs, and any materials they share (like metal bars) are added together into one row with the combined total. Each recipe has its own "how many" box and an x to remove it, and clicking "Add to Shopping List" on a recipe that's already there adds one more. Required reagents track live progress (counting bank and warband bank, not just bags) and show a "Need: X" line for anything you're still short on, so there's no mental math while you're standing at the Auction House. Optional/finishing reagents show as a plain reminder, and reagents you can't buy on the Auction House are flagged "[vendor/earned only]" instead of silently vanishing. The window is movable, resizable, lockable, scrolls with the mouse wheel, persists across logout/reload, and has a "Clear all" button (it asks first) to start over. Pulled away by a dungeon queue? Close it and your list is kept - a "Show Shopping List" button in the settings (or
/iw shopping) brings it right back. - Quick-Add popup — track items you don't have yet by pasting a Wowhead link, typing an item ID, or shift-clicking an item straight into the field. Set a goal and sound in one step.
- Per-item edit popup — left-click any tracked icon to change its goal or pick its own custom "goal reached" sound (or mute it).
- Per-item ding sounds — no more one generic sound for everything; give each tracked item its own, so you know what just hit its goal without looking. A growing collection of fun/thematic presets alongside the practical ones - see the Sound Presets section below for the full list.
- Shift-click to link, Ctrl-click to preview — tracked icons behave like real item icons for chat links and equippable-gear previews.
- Vendor purchase tracking — some vendors sell things for items (cloth, ore, gems) instead of gold. Alt-click the vendor item and ItemWatch tracks the items it costs, with each goal set to the amount needed. Alt-click again for a second purchase and the goals add up. Hover a vendor item and the tooltip tells you if Alt-click is available for it.
- Character-specific tracking — each character keeps its own list. The main Item Box counts bags and the reagent bag, real-time, so counts are exactly what you're carrying. Any item can also be set to count your bank and warband bank (a checkbox in its edit popup), and items added from a vendor start that way. The Shopping List always checks your bank and warband, since it's answering a different question - "do I still need to go buy this."
- Blizzard Edit Mode support for the box.
- Hide it when you want to — hide the box with the minimap button, a checkbox in the settings, or
/iw hide. It stays hidden through combat, reloads and logging out. There are also combat and pet battle toggles to hide it automatically, and the Shopping List can hide during combat too. Tracking keeps running in the background regardless. - Lost it? Reset it — a "Reset box position and show it" button in the settings (or
/iw reset) puts the box back in the center of your screen and unhides it. - Minimap button — left-click to show/hide the box, right-click for settings. Built on LibDataBroker + LibDBIcon, so it's automatically compatible with minimap button "tray" addons.
- Works great with Holiday Herald! Ctrl-click a holiday's shopping list in Holiday Herald to add every item to ItemWatch in one go, with the amounts added on top of your current goals.
- In-game documentation — the settings panel has expandable sub-pages covering how to use ItemWatch, the Recipe Shopping List, practical usage ideas (like Auction House shopping lists built from the main box), and contact/support info.
- What's New — after each update, a clickable "patch notes" link appears in chat. Click it to see the highlights, or bring them back any time with
/iw whatsnew. - NerdyBertie's Addon Workshop — ItemWatch's settings live under a shared Workshop page in Options > AddOns, which lists my other addons (the ones you have installed are marked).
- All the original
/iwslash commands still work, unchanged — the box and popups are additional ways in, not replacements. - Lightweight — built around game events, so it does almost nothing while you're not using it.
Installation
Recommended: install via CurseForge.
Manual install:
- Download the latest release, or clone this repo.
- Copy the
ItemWatchfolder (including theLibssubfolder) into your WoW AddOns directory:World of Warcraft/_retail_/Interface/AddOns/ - Restart WoW or
/reload.
Usage
The easy way:
- Drag an item from your bags onto the box to start tracking it.
- Left-click the icon inside the box to set a goal and pick a sound.
- Right-click the icon to stop tracking it.
For items you don't have yet:
- Click the "+" on the box (or right-click empty space inside it).
- Paste a Wowhead link, type the item ID, or shift-click an item to fill the field automatically.
- Set a goal and sound preference, click Track.
Building a shopping list from a recipe:
- Open any profession's Recipes tab and select a recipe.
- Click "Add to Shopping List."
- Open another recipe and click it again to add it too. Shared materials are combined into one total. Change a recipe's "how many" box, or click the x to take it off the list.
- Required reagents show live have/needed progress (bank + warband bank included), optional reagents show as a reminder, and anything you can't buy is flagged "[vendor/earned only]."
- The window sticks around - move it, resize it, lock it, scroll it, or just leave it open. It'll still be there if you log out mid-farm. The X only hides it (
/iw shoppingbrings it back); "Clear all" empties the list.
Tracking what a vendor item costs:
- Open a vendor that sells things for items instead of gold.
- Hover the item you want. If it costs items, the tooltip says "Alt-click: Track the items used to buy this in ItemWatch."
- Alt-click it. The items it costs appear in the box with goals set (and they count your bank and warband bank too).
- Alt-click again if you want more than one.
Commands
| Command | Description |
|---|---|
/iw add [itemID] |
Start tracking an item |
/iw remove [itemID] |
Stop tracking an item |
/iw list |
List everything currently tracked |
/iw clear |
Remove all tracked items (asks to confirm) |
/iw show |
Show the box |
/iw hide |
Hide the box (it stays hidden until you show it) |
/iw reset |
Move the box back to the center of the screen and show it |
/iw lock |
Lock the box in place |
/iw unlock |
Unlock the box so you can move/resize it |
/iw goal [itemID] [amount] |
Set a target amount for an item |
/iw goal [itemID] clear |
Remove the goal for an item |
/iw sound [itemID] on|off |
Toggle the goal-reached sound for an item |
/iw testsound |
Preview the default goal sound |
/iw addrecipe |
Add the currently-open recipe to the Shopping List |
/iw shopping |
Show the Shopping List window again |
/iw whatsnew |
Show the What's New highlights again |
/iw options |
Open the settings panel |
Ctrl+Shift+Click an item in your bags also adds it directly, no item ID needed (default Blizzard bag UI only).
Settings
Find ItemWatch's settings under Options > AddOns > ItemWatch in-game, or type /iw options, or right-click the minimap button. From there you can set per-item sounds, hide or reset the box, choose combat/pet-battle visibility, reopen the Shopping List, and show/hide the minimap button.
The settings panel also has an expandable "+" with sub-pages: Helpful Information (how everything works), Shopping List (how the recipe-based shopping list works), Practical Uses (real workflows like building an Auction House list from the main box), Contact/Support, and About.
Sound Presets
Every tracked item can play its own sound when its goal is reached - mix and match as many as you like, or leave one as your global default. Alongside the practical picks (Ready Check, Achievement Ding, Coin Sound), there's a growing collection of fun/thematic ones:
- Orc Peon - "Work Complete!" (the default) and "Me not that kind of orc!"
- Commander Ulthok - startling, you've been warned
- Illidan - "You are not prepared!"
- Brann Bronzebeard - "Here we go!" and "Time to go all out!"
- Horde Legends - Thrall ("Lok'tar!"), Sylvanas ("So it is done"), Baine Bloodhoof ("For the Horde, always"), Monte Gazlowe ("Business is Boomin'!")
- Alliance Champions - Genn Greymane ("So many… dead…" - a bit morbid, fun for skinners!), Tyrande Whisperwind ("Ishnu-ala"), Magni Bronzebeard ("Always more work to be done"), Gelbin Mekkatorque ("There's always time to tinker")
Prefer something not on the list? There's also a Custom FileDataID option, so you can use any sound file ID you can find (try wago.tools/files or search wowhead.com/sounds).
Notes
- Tracked items are saved per-character, so each character keeps their own independent list.
- The addon bundles LibStub, CallbackHandler-1.0, LibDataBroker-1.1, and LibDBIcon-1.0 in the
Libsfolder for the minimap button - these are widely-used shared libraries, not custom code. - Manual install / cloning: make sure the
Libsfolder (and its four subfolders) comes along withItemWatch.luaandItemWatch.tocinto your AddOns folder. If you use GitHub's green "Code" button and download the ZIP, this happens automatically. If you're grabbing files one at a time, don't skipLibs- without it, the minimap button won't appear (the rest of the addon still works fine, it just quietly skips that one feature). - The Ctrl+Shift+Click add-from-bags shortcut only works with Blizzard's default bag UI. If you use a bag-replacement addon, use
/iw add [itemID]or the Quick-Add popup instead.
Contributing / Issues
Found a bug or have a feature idea? Open an issue — feedback and suggestions welcome.
License
MIT — see LICENSE for details.
More from NerdyBertie
If ItemWatch is helping you keep your farming lazy and your crafting organized, feel free to check out my other addons!
- HandyNotes: Dive Bar Front Crawl — map pins for every underwater Tortollan dive bar in the Dive Bar Front Crawl housing endeavor
- HandyNotes: Seeking the Soulstones — map pins for finding the soulstones, as part of the Warlock Green Fire questchain in Outland
- Boomkin Buff Watcher — keeps Balance Druids on top of their Astral Power and Eclipse state
- Holiday Herald — friendly reminders when in-game holidays start, with links to their meta-achievements, goodies, secrets, and more!
- Pinkies Up! — Achievement gratses for every achieve! 40 plus cute sayings, plays nice with Holiday Herald
- Chum Chimes — a friendly chime when guildies and friends are in your zone or near you
Find them all by searching NerdyBertie on CurseForge, WoWInterface, WowUp, or Wago.
If you find ItemWatch useful, consider supporting me on Ko-fi — totally optional, but always appreciated! You can also find me on Twitch, TikTok, YouTube, or Discord - NerdyBertie's Tinker Workshop








