# BuffBar

A compact, drag-to-configure consumable tracker for **World of Warcraft Anniversary / TBC Classic 2.5.x**. Keep every buff you care about visible in one tiny bar — no more checking your buff frame mid-pull to see if your flask is still up.

## The problem

You're tanking Karazhan. Did you reapply your sharpening stone? Is Well Fed still ticking? Did your Greater Rune of Warding fall off three pulls ago? Scanning the default buff frame for a specific icon every 30 seconds is slow, and most aura addons don't track weapon enchants or chest runes at all.

BuffBar shows only the consumables **you** picked, with a bag count, a remaining-time readout, and a clear visual signal the moment a buff falls off.

## What it tracks

- **Self-buffs** — elixirs, flasks, food (auto-detects "Well Fed" or item-specific buff names after the first use)
- **Weapon enchants** — sharpening stones, weightstones, mana / wizard / shaman oils. Prompts main hand or off hand on drop.
- **Chest enchants** — Lesser & Greater Rune of Warding. Scans the chest tooltip for the remaining duration since no API exposes it.
- **Plain consumables** — healthstones, mana / healing potions, scrolls. Tracked by bag count when there's no buff.

## How to use it

1. Type `/bb` to open the settings window.
2. Open your bag, pick up a consumable, drop it on the `+` slot.
3. The icon appears with a short auto-generated label (Str / Agi / Prot / Fort / Battle / Food / etc.) underneath.
4. **Right-click** the icon to consume the item — works in any state, secure-action button under the hood, so it survives combat lockdown.
5. **Drag** an icon to reorder it; drop it far outside the bar to remove. Only available when the bar is unlocked.
6. When the buff is active, the icon stays bright with a countdown. When it expires, the icon desaturates (or turns red, if you enable the overlay).

## Highlights

- **Auto-detects the real buff name** after the first time you use an item. No item ID database, no localization issues — it just watches what aura you get and remembers.
- **Profiles** with full import / export via plain text strings. Share your raid setup with your guild in one paste. Switch profiles for PvP / Mythic-prep / leveling.
- **Three modes per item** depending on what kind it is — a single right-click handles a flask, an oil + main-hand target, or a chest rune cast, with the correct macro built automatically.
- **Configurable everything** — horizontal or vertical layout, icon size 16-64 px, transparency slider, font picker (built-in fonts + every font from any LibSharedMedia-registered addon you have installed: WeakAuras, ElvUI, Details!, etc.).
- **"Only show in dungeons and raids"** option so the bar stays out of your way in town.
- **Smart buff resolution** even for tricky items — food buffs that take 10 seconds to apply, weapon enchants that don't go through `UnitBuff`, chest runes that aren't in any API at all.
- **Combat-safe** — secure attributes are never changed during combat; adds and removes queue automatically until you drop combat.

## Click bindings (cheat-sheet)

Action	Where	Effect
Drag from bag	onto `+`	Add item to tracking
Right-click	on a slot	Consume one of the item
Left-drag	on a slot (unlocked)	Reorder; drop far outside to remove
Drag from grip	on the `:` handle (unlocked)	Move the bar
Click "Lock bar"	settings window	Hide the grip + `+` for a clean play view

## Slash commands

Command	Description
`/bb` or `/buffbar`	Open the settings window
`/bb lock` / `/bb unlock`	Lock / unlock the bar
`/bb clear`	Remove every tracked item (with confirmation)

## Compatibility

- Built for **WoW Anniversary / TBC Classic 2.5.x** (interface number `20504`).
- No library dependencies — works standalone.
- **Optional LibSharedMedia integration**: if any addon you have installed (WeakAuras, ElvUI, Details!, etc.) registers fonts with LSM, those fonts automatically appear in BuffBar's font picker. No required dependency though — works fine without.

## Source

Open source on GitHub: [github.com/SimonEkelund/BuffBar](https://github.com/SimonEkelund/BuffBar) — issues and pull requests welcome.

Buffbar