
Wiki
Peelometer
Everything about Peelometer in one place: meter windows, hover details and breakdowns, fight history and reports, themes and bar styles, every setting and slash command, and what a meter can and can't see in 12.x.
Install
Get Peelometer from CurseForge and log in.
Peelometer is free on CurseForge. It works on World of Warcraft Retail (patch 12.1.5 and later) and needs nothing else to run.
Install it
In the CurseForge app, search for Peelometer and click Install. Or download the zip from CurseForge and unpack it into
World of Warcraft/_retail_/Interface/AddOns, so you get aPeelometerfolder there.Log in
Two windows appear at the bottom right of your screen: Damage and Healing. They stay empty until your first fight.
Read the welcome card
A few seconds after you log in, a welcome card explains what Peelometer is and what a meter can see in 12.x. It also asks whether to hide Blizzard's own meter window (see Blizzard's meter). Type to see it again.
Your settings and fights are kept
Updates keep your windows, settings and saved fights. Everything is stored in your own SavedVariables file on your PC; nothing is sent anywhere.
Your first fight
What you see while you fight, after the fight, and where to click next.
The quickest way to learn Peelometer: hit a training dummy for twenty seconds, stop, and watch what the windows do.
Fight
Bars grow while you fight and the title bar says LIVE. You see amounts and per-second numbers right away, in the order Blizzard gives them.
Stop and wait a few seconds
The badge turns FINAL. Percentages fill in, rows can be sorted, and the fight is saved to your history. Why the wait?
Point at a bar
Hover details show that player's totals and strongest spells.
Click a bar
The breakdown window lists every spell with amount, per second and percent.
Right-click the title bar
The window menu has everything else: a new window, tabs, theme, bar style, presets and reports.
Settings are one command away
Type to open settings. , and do the same. lists every command in chat.
Blizzard's meter
Why Blizzard's meter stays on, and how to hide its window.
Since patch 12.0, addons can't read the combat log. Every Retail meter, Peelometer included, now reads the numbers from Blizzard's own damage meter. So that meter has to stay switched on, but its window doesn't have to be on screen.
Hide Blizzard's window
Any of these hides Blizzard's meter window. Its data stays on, so Peelometer keeps working:
- Tick Hide Blizzard's meter window on the welcome card.
- Right-click a Peelometer title bar and tick Hide Blizzard's meter.
- Settings›General›Blizzard's meter.
- Type . brings it back, and switches between the two.
If you change this during a fight, it happens as soon as combat ends (the game doesn't let addons move its frames in combat).
If the meter gets switched off
If Blizzard's damage meter is turned off in Options›Gameplay, there is no data for any addon. Peelometer's windows then say so and show a Turn it on button. Click it and the numbers come back. If you only wanted Blizzard's window gone, Peelometer keeps it hidden.
Note
You can run Peelometer next to Blizzard's window or another meter. They read the same data and don't get in each other's way.
A meter window
The title bar, the rows, the buttons and the window menu.
Every meter window works the same way: a title bar on top, one bar per player below. Point at a window and its buttons and resize grip appear.

- 1Meter picker. Click it to show another meter (Meters).
- 2Fight picker. Current fight, Overall or a saved fight (Fights).
- 3Badge and timer. LIVE during combat, FINAL once the numbers are complete, then the fight length. More
- 4Buttons. Details window, lock, reset all fights and the window menu (gear).
- 5Your row. A mark on the left shows which bar is you.
- 6Resize grip. Drag to resize. Shows on hover while the window is unlocked.
Rows
Each bar is one player: rank, name, then the amount with per second and percent in brackets. The #1 bar can wear a crown (a banana in banana themes). Players who died in the fight get a dimmed bar.
- Scroll with the mouse wheel when there are more players than fit.
- Always show me pins your own bar to the bottom when it's scrolled out of view. It's on by default; turn it off in Settings›Bars›Rows.
- Row height and spacing are in the same place. Taller windows show more rows; resize the window to fit your group.
The window menu
Right-click the title bar, or click the gear, for the window menu. It has everything for this window: lock, a new window, tabs, what it shows and when, its theme and bar style, reports, extras and settings. Right-clicking a bar opens the same menu with that player's breakdown at the top.
Tip
Locked windows can't be moved by accident. Hold Alt to move one anyway (see Move, resize and lock).
Meters
Damage, healing, interrupts, deaths and the after-combat meters.
A window shows one meter at a time. Click the meter name in the title bar (the first word, like "Damage") to pick another.
Damage
| Meter | Tab name | What it shows |
|---|---|---|
| Damage done | Damage | All the damage each player did, pets and guardians included. |
| DPS | DPS | Damage done per second. |
| Damage taken | Taken | Damage each player took. |
| Avoidable damage taken | Avoidable | Damage from things Blizzard marks as avoidable: the swirls and puddles you could have stepped out of. |
| Enemy damage taken | Enemies | Damage the enemies took, one bar per enemy. |
Healing
| Meter | Tab name | What it shows |
|---|---|---|
| Healing done | Healing | Healing each player did. |
| HPS | HPS | Healing done per second. |
| Absorbs | Absorbs | Damage stopped by each player's shields. |
Actions
| Meter | Tab name | What it shows |
|---|---|---|
| Interrupts | Interrupts | How many spell casts each player interrupted. |
| Dispels | Dispels | How many effects each player dispelled. |
| Deaths | Deaths | Who died, and when in the fight. |
After combat
Peelometer works these out itself once a fight is saved, so they show for saved fights and after combat, not while you fight.
| Meter | Tab name | What it shows |
|---|---|---|
| Damage + healing | Output | Damage and healing added together. |
| Healing + absorbs | Heal+Abs | Healing and absorbs added together. |
| Overkill | Overkill | Damage past what was needed to kill the target. |
| Avoidable damage share | Avoid % | How much of each player's damage taken was avoidable. |
| Deadly hits taken | Deadly | Hits Blizzard marks as deadly that each player took. |
A window per meter
opens a new window on a meter. Use the meter name or its tab name, like or . To show several meters in one window, use tabs.
Not in game
Overhealing, crits, buff uptime, crowd control and threat aren't given to addons at all. The desktop app reads them from the combat log file instead.
LIVE and FINAL
Why some numbers wait until the fight is over.
During a fight, the game hands addons its numbers in a locked box: Peelometer may show them, but not add, compare or divide them. A few seconds after combat the box opens. Each window tells you which one you're looking at.
Pull
The fight starts. Windows switch to the new fight.
In combat LIVE
Blizzard's numbers in Blizzard's order. Amounts, per second and bars all update.
Combat ends
Numbers stay hidden from addons for a moment.
A few seconds later FINAL
Numbers turn normal: percent, sorting, merged pets and your own per-second math fill in.
Saved
The fight goes into your history, named by boss, key or zone.
LIVE in combat
You see Blizzard's numbers, in Blizzard's order, as they update: bars, amounts and per second all work. What needs math waits: percentages are blank, rows aren't re-sorted, and hover details say after combat where a number can't be worked out yet. Other players' spell lists also wait, because the game only shares your own while you fight.
FINAL after combat
Usually within a few seconds of the fight ending, the numbers turn normal. Peelometer saves the fight and the window switches to that saved copy, so everything kicks in at once: percentages, sorting, merged pets, your per-second choice, the after-combat meters and the history.
| In combat | After combat | |
|---|---|---|
| Bars, amounts, per second | Yes | Yes |
| Interrupts, dispels, deaths | Yes | Yes |
| Your own spells (hover, breakdown) | Yes | Yes |
| Other players' spells | After combat | Yes |
| Percent, sorting, merged pets | After combat | Yes |
| Damage + healing, overkill and the other after-combat meters | No | Yes |
Your choices apply after combat
Settings like Percent of, Per second and Pets in Settings›Data & refresh›Calculation change how saved fights are worked out. In combat you always see Blizzard's own numbers.
Fights and the fight picker
Current fight, Overall, past fights and whole runs.
Click the fight name in the title bar (next to the meter name) to choose which fight a window shows. Each window has its own choice, so one can show the current fight while another shows Overall.
| Choice | What it shows |
|---|---|
| Current fight | The fight going on now, or the last one. Fights where nobody did anything are skipped, so Current keeps your last real fight. |
| Overall | Everything Blizzard's meter holds since the last reset. |
| Past fights | Blizzard's own list of recent fights, newest first, with their length. |
| Saved fights | Peelometer's history: one entry per run, raid night or day, newest first, then Older. Favorites get their own entry at the top. |
Whole runs and nights
Inside a saved group, the first entry adds up every fight in it:
- Whole run for a Mythic+ key: every pull, trash and bosses.
- Whole night for a raid, Whole dungeon for a dungeon, Whole day out in the world, Whole match for an arena or battleground.
Each can be turned off in Settings›Fights & history›Fight picker, where you can also list boss fights only, merge the trash between two bosses into one "Trash before X" entry (on by default), and choose how many runs show before Older.
Fight names
Saved fights are named by the boss ("Shadeweaver Ix - pull 2", with kill or wipe), the trash before a boss, the key level and dungeon, or the zone. Prefer something else? Name fights by can also use the main enemy, the zone or the time of day.
Tip
Empty fights, like a mob that hit you while you rode past, don't show up in the picker and aren't saved.
More windows and tabs
Add, rename, copy and close windows, or put several meters in one.
Open as many windows as you like. Each one has its own meter, fight, size, theme, bar style and hover details.
Add a window
- Right-click a title bar and choose New window.
- Type , or to open it on a meter.
- Click Add a window in Settings›Windows›Your windows.
- Or build a whole set at once with a window preset: Choose a preset... under the list, or .
Rename, copy and close
Settings›Windows›Your windows lists every window with its meter. Type in the name box to rename one; Edit opens that window's own settings, and Duplicate and Delete do what they say. The window menu has more:
- Rename... gives the window a name of its own (shown in menus and settings).
- Copy settings from takes the look and options of another window.
- Reset window settings drops this window's own values, so it uses the shared settings again.
- Close this window (there is always at least one).
Tabs: several meters in one window
Right-click the title bar and open Tabs
Tick each meter you want as a tab. The window's own meter becomes the first tab.
Switch tabs
Click a tab, or turn the mouse wheel over the title bar or the tabs.
Remove a tab
Untick it in the same menu. With one tab left, the window goes back to a single meter.
Note
The after-combat meters (like Damage + healing) can't be tabs; open them from the meter picker instead.
Move, resize and lock
Snapping, groups, scale, lock and click-through.
Drag a window by its title bar. Drag the grip in the bottom right corner to resize it. Windows snap to each other and to the edges of the screen, so lining them up takes no effort.
1. Drag near another window
It snaps to the edge, and to the screen edges too.
2. Drag one, the group follows
Move snapped windows together is on by default.
3. Shift-drag to take one out
Or right-click the title: Detach from group.
Snapping and groups
- Drag a window close to another one (or to a screen edge) and it snaps into place.
- Windows that snap together form a group. Drag any of them and the whole group moves.
- Hold Shift while you drag to move just one window; it leaves the group. Or right-click its title and choose Detach from group.
- When you resize a window, the windows snapped below it or to its right move along, so they stay touching.
Both Snap windows and Move snapped windows together are in the window menu and in Settings›Windows›Layout.
Scale
Scale makes the whole window bigger or smaller, text included (0.5x to 2x). Set it for all windows, or pick one window at the top of settings to scale only that one. Snapped neighbours move along.
Lock and click-through
| Setting | What it does |
|---|---|
| Lock windows | Locked windows can't be moved or resized. Use the lock button in the title bar, the window menu, or and for every window. |
| Click-through | Never, In combat or Always: clicks go to the game world instead of the window. Handy for a window over the middle of your screen. |
| Hold to interact while locked | Hold this key (Alt by default; or Ctrl, Shift, None) to move and resize a locked window, or to click a click-through one. |
| Frame strata | Advanced: draws the window above or below other parts of your UI. |
Tip
Positions are saved relative to the nearest corner of the screen, so your windows stay put when you change resolution or UI scale.
When windows show
Show a window only in combat, in a group or in an instance, and fade it after combat.
Each window can decide when it's on screen. To set it for one window, right-click its title and open Show; for every window, use Settings›Windows›When it shows.
Show
| Choice | The window shows |
|---|---|
| Always | All the time (the default). |
| In combat | While you fight, and a few seconds after. |
| In a group | While you're in a party or raid. |
| In an instance | In dungeons, raids, scenarios, arenas and battlegrounds. |
| In a raid | While you're in a raid group. |
| In Mythic+ | While a keystone runs. |
| In PvP | In arenas and battlegrounds. |
| Never | Not at all (handy for a window you only open by hand). |
On top of that, each window hides by itself:
- in pet battles, in vehicles and during cutscenes (all on by default), and
- until the fight it shows has data, with Hide when empty (off by default).
/pm hide and /pm show hide or show every window by hand; the minimap button does the same with a left-click.
Fade out of combat
Fade out of combat dims a window a while after a fight: after 8 seconds to 35% by default (Fade after and Faded opacity). Point at the window and it comes right back. Windows can also fade while you move.
Want to see through a window instead?
Lower its background opacity: the bars stay solid and only the backdrop fades.
Fade while moving
Added in 1.0.0-beta4Windows dim while your character moves, so you can see the world.
Meter windows can dim while your character moves, so you can see where you're going, and come back the moment you stop. Out of combat and in combat each have their own switch and opacity.
- Damage
1. You start moving
The window is at its normal opacity.
- Damage
2. Wait before fading
0.5 s by default, so a quick step doesn't make it flicker.
- Damage
3. Faded
Fades over the Fade time to the Moving opacity (30%).
- Damage
4. Stop, fight or hover
Comes back over the Fade back time.
Open the fading settings
Go to Settings›Windows›Fading. To set it for one window only, pick that window in the Editing box at the top first.
Turn on Moving out of combat, Moving in combat, or both
Each one shows its own opacity slider when you turn it on.
Run around
After a short wait the window fades. Stop, start a fight (for the out-of-combat fade) or point at the window, and it comes back.
| Setting | Default | What it does |
|---|---|---|
| Moving out of combat | Off | Dims the window while you move out of combat. |
| Moving opacity | 30% | How see-through it gets while you move out of combat. |
| Moving in combat | Off | Dims the window while you move during a fight. |
| Opacity in combat | 60% | How see-through it gets while you move in combat. |
| Wait before fading | 0.5 s | How long you move before it fades, so a quick step doesn't make it flicker. |
| Fade time | 0.4 s | How long it takes to fade out. 0: at once. |
| Fade back time | 0.2 s | How long it takes to come back. 0: at once. |
Note
Fade time and Fade back time also apply to Fade out of combat, so every fade is smooth.
Window presets
A set of windows in one click, or a layout you saved yourself.
A window preset replaces your windows with a ready-made set, snapped together at the bottom right. Start from one of Peelometer's, or save your own setups and switch between them, like one for raid night and one for Mythic+.
Use a preset
Open Window presets
Type , right-click a title bar and choose Window presets..., or click Choose a preset... in Settings›Windows›Your windows.
Pick one and click Use this preset
It says how many windows it replaces and offers to save your current ones first, so you can always go back.
Move them where you like
The new windows are snapped together, so they move as one.
| Preset | Windows | For |
|---|---|---|
| Solo | Damage done, Damage taken | One damage window and what hit you. |
| Dungeon | Damage done, Healing done, Interrupts, Deaths | Damage, healing, kicks and deaths for a 5-player group. |
| Raid healer | Healing done, Absorbs, Dispels, Deaths | Healing first, plus absorbs, dispels and deaths. |
| Raid DPS | Damage done, Avoidable damage taken, Interrupts | Damage for 20 players, avoidable damage and kicks. |
| PvP | Damage done, Healing done, Interrupts, Enemy damage taken | Damage, healing, kicks and the enemy team's damage taken. |
Save your own
In the same dialog, Save current windows stores what each window shows, its size and place. Two choices when you save:
- Keep each window's own style and theme: the preset also brings back each window's bar style, text and theme.
- Put windows back in the same spots: on, they go exactly where they were; off, they're placed bottom right like the built-in presets.
Your presets are listed under Your presets for every character on your account. Each can be renamed, updated from your current windows, duplicated, shared or deleted.
Share a preset
Share... gives you a text string that starts with !PM-LAYOUT1!. Send it to a friend; they paste it into Import... in their Window presets dialog.
Switch with /pm layout
opens a short list of the built-in presets and yours. Click one and it asks first, the same as the Window presets dialog: Replace windows, Save them first... or Cancel. Esc or the close button changes nothing.
With a name, goes straight to that question. It works with your own presets too, like /pm layout raid night, and with the short names solo, dungeon, healer, dps and pvp.
Hover details
Point at a bar for that player's totals, top spells, pets and deaths.
Point at any bar to see that player's details next to it: totals, strongest and weakest spells as bars, pets, deaths and more. It's Peelometer's own panel, styled like your theme.
What it shows
| Section | On by default | What's in it |
|---|---|---|
| Name, spec and rank | Yes | Class, spec, place in the window, and whether it's you. |
| Totals | Yes | Amount, per second, share of total and of the top player (after combat), fight length. |
| Strongest spells | Yes | The top 5 spells as bars, colored by spell school. |
| Weakest spells | Yes | The bottom 3 (after combat, since it needs sorting). |
| Pets and guardians | Yes | What each pet added, and the player's own spells. |
| Overkill, avoidable and deadly hits | Yes | Damage past the kill, avoidable damage taken and deadly hits. |
| Main target per spell | No | Blizzard keeps one main target per spell. |
| Deaths | Yes | When they died and what killed them. |
| Compare with me | No | Their numbers next to yours. |
Tick sections on or off and drag them into your own order in Settings›Hover details›Sections. The last line says what a click does.
When and where it shows
- Show when: on every hover, only while you hold a modifier key (Shift, Ctrl, Alt or any), or only out of combat.
- Position: next to the bar, along the side of the window, or at the mouse cursor.
- Spell bars: how many strongest and weakest spells, tall bars like the window's or compact ones, spell icons, and colors by spell school.
Other players in combat
While you fight, the game only lets addons read your own spell list. Other players' spells show as after combat and fill in once the fight ends. Their totals are there all along.
Breakdown window
Every spell of one player, side by side with another.
Click a bar to open that player's breakdown: every spell with its amount, per second and share, plus overkill, pet and main target. Put a second player next to it to compare.
Open a breakdown
- Left-click a bar (the default). You can change it to Shift + left click, or the right-click menu only, in Settings›Breakdown›Opening.
- Right-click a bar: Breakdown, Breakdown in a new window or Compare with me.
- Right-click a title bar: Breakdown: me opens your own.
By default, clicking another bar shows that player in the breakdown you already have open. Turn off Reuse the breakdown window to open a new one per click and keep several side by side.
Columns and sorting
| Column | What it shows |
|---|---|
| Spell | Spell name and icon, colored by spell school. |
| Amount | The spell's total. |
| Per second | The spell's amount per second. |
| Percent | Its share of the player's total (after combat). |
| Overkill | Damage past the kill (damage done only). |
| Pet | Which pet or guardian cast it. |
| Target | Blizzard's main target for the spell. |
Click a column header to sort (after combat). Hide the columns you don't need in Settings›Breakdown›Columns.
Compare and pin
- Compare... puts another player next to the first, side by side, with the difference (after combat).
- Pin keeps the breakdown following the fight as it goes on. New breakdowns are pinned by default.
- On the Deaths meter, the breakdown shows that player's deaths with the killing blow instead of spells.
Item level and gear
The header shows the player's item level. Gear next to it lists the items they wore in that fight, with each item's level; hover one for its tooltip. Out of combat Peelometer quietly inspects group members who are close by (one every few seconds), so someone who joined mid-fight or stood far away may have none yet. Turn inspecting or gear saving off in Settings›History›Item level and gear. Bar text can show it too with {ilvl}.
Note
In combat, only your own spells can be read, and spells stay in Blizzard's order. Other players' spells and sorting turn on when combat ends.
Details window
Any fight, every pull of a boss or a whole run: tiles, charts and lists.
The details window is where you look back: any saved fight, every pull of a boss on one chart, or a whole run or raid night added up. Open it with , the details button in a title bar, or Open details in the window menu.
Pick a fight
The list on the left has the current fight on top, then your saved fights grouped by instance and day. Type in Search fights to find one by name, and click the star at the top to see favorites only. The star on each fight makes it a favorite, which is never deleted by history cleanup.
Above the tabs, choose how much to add up:
| Button | Shows |
|---|---|
| This fight | The fight you picked. |
| All pulls | Every pull of that boss together (for a boss you pulled more than once). |
| Whole run, Raid night, Whole match | Every fight of the key, raid night, match or dungeon visit it belongs to. |
| Overall | Everything Blizzard's meter holds since the last reset. |
Show in the top right picks the meter (Damage done, Healing done, Interrupts and so on).
Tabs
| Tab | What's in it |
|---|---|
| Summary | Tiles for damage, healing, deaths, interrupts and fight length, and a bar chart per player. Click a player for their spells. |
| Spells | One player's spells as bars with amount and share. Pick the player at the top, or open the full breakdown window. |
| Pulls | Your DPS on each pull of the boss as a line chart, next to the group average, with your best marked. Hover a point; click it to open that pull. |
| Deaths | Who died, when, the killing blow and overkill. See Deaths. |
| Interrupts | Who interrupted, how often and with which spells. See Interrupts and dispels. |
| Dispels | The same for dispels. |
During a fight
The current fight's details fill in when combat ends, because Blizzard's numbers are secret until then. Fights from your history work any time, in combat too.
At the bottom, Copy as text and Post to chat... share what you're looking at (see Post to chat and copy).
Deaths and death alerts
Who died, what killed them, Blizzard's recap and optional alerts.
Peelometer keeps track of who died, when and what killed them, and can tell you the moment it happens, without ever posting to chat.
The death log
- The Deaths meter lists who died in a fight and when.
- The Deaths tab of the details window adds the killing blow, who dealt it and the overkill.
- Click Open on a death for Blizzard's full death recap: the last hits before the death.
Recaps don't last forever
The game keeps death recaps for a short while only. For an older fight, the time and killing blow are still in your history, but the recap may say it's no longer available.
Death alerts
Off by default. Turn them on in Settings›Deaths›Death alerts:
| Setting | What it does |
|---|---|
| Alert when | Never, I die, or Anyone in my group dies. |
| Play a sound | Plays the raid warning sound. |
| Show text on screen | "You died" or "<name> died" near the top of the screen for a few seconds. |
| Flash the bar | Flashes the player's bar in the meter windows. In combat only your own bar can be found. |
| Death summary after combat | After a fight with deaths, lists who died and what killed them in your chat window. Only you see it. |
Interrupts and dispels
Counts, the spells used, and what the game can't count.
The Interrupts and Dispels meters count how many casts each player kicked and how many effects they removed. Both work live in combat.
The matching tabs in the details window also list the spells each player used, like Kick or Counterspell. Turn that list off with Show which spells in Settings›Interrupts & dispels.
Stops by stuns and knockbacks
A stun, knockback or other crowd control that stops a cast isn't counted. That's not something Peelometer forgot: the game hides enemy casts and crowd control from addons, so no addon can see it.
Want those too?
The 1svc Addon Utils desktop app reads the combat log file and makes a best guess at stops by crowd control. It labels them estimated and lists each one, so you can check it.
Fight history
Saved fights: names, how many are kept, favorites, resets and sharing.
A few seconds after each fight, once the numbers are final, Peelometer saves it: every player, every meter, and each player's spells. Saved fights show up in the fight picker and the details window, and they stay after you log out.
What is kept
| Setting | Default | What it does |
|---|---|---|
| Fights to keep | 30 | How many fights are saved. Older ones are deleted, except favorites and recent boss fights. |
| Keep boss fights for | 7 days | Boss fights stay this long even past the number above. 0: no exception. |
| Skip fights shorter than | 5 s | Very short fights aren't saved. Boss fights always are. |
| Skip fights with less damage than | 0 | Group damage below this (in thousands) isn't saved. 0 saves every fight. |
| Spell lists for the newest | 15 | Advanced. Older fights keep their totals only, so the saved file stays small. Favorites keep everything. |
Favorites are never deleted. Star a fight in the details window, or type for the third fight in the list.
History in chat
| Command | What it does |
|---|---|
| Opens the details window. | |
| Lists the last 20 saved fights in chat, with their numbers. | |
| Makes fight 3 a favorite, or not any more. | |
| Shows fight 3 as a share string. | |
| Asks for a share string and adds that fight. | |
| Deletes every saved fight except favorites (asks first). |
Share a fight
Right-click the title of a window showing a saved fight and choose Share this fight.... Copy the string (it starts with !PM-FIGHT1!) and send it. The other player chooses Import a fight... in their window menu, or types , and the fight appears in their fight picker under Imported fights.
Resetting the meter
The reset button in the title bar, Reset all fights... in the window menu, and clear Blizzard's meter (Current, Overall and its past fights), so the next fight starts empty. Your saved fights are kept. Resets can't happen during combat.
Peelometer can also reset by itself, in Settings›Fights & history›Reset Blizzard's meter:
- When entering an instance: Ask (the default), Always reset or Never.
- When joining a group and When leaving a group: off by default.
- Confirm before reset: asks before any reset, automatic or by hand. On by default.
Where fights are stored
Saved fights live in your SavedVariables file (WTF/Account/<account>/SavedVariables/Peelometer.lua), shared by all your characters whatever the profile. The game writes it at /reload and logout.
Personal bests
Your best DPS and HPS per boss and per key, and each pull against it.
Peelometer remembers your best DPS and HPS on each boss you kill and each key level you finish, per character. Type to see them.
- Click a row to open that fight in the details window (as long as it's still saved).
- also prints the list in chat. only prints it.
- The window menu has Personal bests too, under Extras.
Notices after a pull
| Setting | Default | What it does |
|---|---|---|
| Toast on a new personal best | On | After a boss kill or a finished key, a small notice when you beat your best there. |
| This pull vs your best | On | After each boss pull, kill or wipe, a small notice with your number against your best kill on that boss. |
| Compare | By your role | Which number the pull comparison uses: HPS for healers, DPS for everyone else, or always DPS or HPS. |
These are in Settings›Fights & history›Personal bests. The Top 3 HUD can show the same comparison under it.
Post to chat and copy
Share results in party, raid or guild chat, with a preview first.
Share a fight's results in chat without surprises: you always pick where, see the exact lines first, then confirm. Or copy them as text and paste them anywhere.
Post to chat
Open Post to chat
From the window menu (Post to chat...), the details window, or . starts with the top 10.
Choose where, how many lines and what each line shows
Party, Instance, Raid, Guild or Say; top 3, 5, 10 or everyone; amount with per second or percent, per second only or amount only; and the meter. The preview shows the lines exactly as they'll be posted.
Click Next, then Confirm
The confirm step says how many lines go where and who will see them. Tick Don't ask again to skip it for that channel next time.
When posting is off
A fight that is still going can't be posted, and the game locks addon chat during boss fights and Mythic+ runs. The dialog says so; post again when the fight or key ends.
Copy as text
Copy as text (window menu or details window) opens a box with the report selected. Press Ctrl+C and paste it wherever you like: a forum post, a note, another chat. Copy template in settings picks what the box starts with: a short top 5, the top N, or every meter. A fight still going can't be copied; try again when combat ends.
Defaults and after-fight prompts
| Setting | Default | What it does |
|---|---|---|
| Default channel | Your group | Picked first: instance, raid or party, whichever you're in. |
| Lines to post | Top 5 | How many players a report lists. |
| Line format | Amount (per second) | What each line shows after the name. |
| Confirm before posting | On | Shows the exact lines and asks first. Channels you skipped are listed under Channels that don't ask. |
| Fight summary toast | Off | A small notice when a fight ends; click it for the details window. |
| Offer to post after a kill or a finished key | Off | A small prompt; clicking it still asks where and confirms. |
| Post to chat button | Off | Adds a post button to each title bar. |
All in Settings›Reports.
Themes
Over 40 themes, one per window if you like, or your own from 8 colors.
A theme sets the colors of the windows, the hover details and the settings, and banana themes bring their own banana art. Pick one in Settings›Themes, or type .
All 45 themes
| Group | Themes |
|---|---|
| Peel & Profit | Flat, Blizzard, Parchment, Void, High contrast, High contrast light, Faction |
| Bananas | Classic Banana, Golden, Boonana, Karate, Inferno, Mad Banana, Frost, Arcane, Fel, Hazard, Pirate, Groovy, Hallow's End, Winter Veil |
| BananaMojis palettes | Classic Banana, Classic Banana Light, Banana Split, Banana Split Light, Extra Fresh, Extra Fresh Light, Blue Flame, Blue Flame Light, Strawberry Orange, Strawberry Orange Light, Midnight Plantain, Midnight Plantain Light, Matcha, Matcha Light, Banana Foster, Banana Foster Light, Cotton Candy, Cotton Candy Light |
| More themes | Dracula, Catppuccin Mocha, Catppuccin Latte, Tokyo Night, Solarized Dark, Solarized Light |
switches every window by name; part of a name works too. Without a name it opens the theme settings.
A theme per window
Right-click a window's title and open Theme to give just that window its own theme. Same as other windows puts it back. You can also pick the window in the Editing box at the top of settings and choose a theme there.
Seasonal and random themes
- Seasonal banana themes (off by default): Hallow's End from Oct 18 to Nov 1 and Winter Veil from Dec 16 to Jan 2. Windows with their own theme keep it.
- Theme on login: your own pick, a theme of the day (the same all day), or a random banana theme each login. Your own pick stays saved.
- Banana in the title bar and Watermark strength control the banana art.
Build your own theme
Open Settings › Themes › Your themes
Start from scratch, or click Start from current theme.
Pick 8 colors
Background, raised background, text, primary, primary dark, text on primary, secondary and link. Tick Light theme for a light one. Peelometer works out the rest and keeps text readable (4.5:1 or better).
Save and use
Saved themes are shared by all your characters and listed under Custom in the picker.
Share a theme
Each saved theme has a share string. Click Import a theme... and paste one to add a friend's theme.
See-through background
Added in 1.0.0-beta5Make only the window's background transparent; bars and text stay solid.
Want to see the world through a window without losing the numbers? Lower its background opacity: only the backdrop behind the bars fades. Bars, text and the title bar stay solid.
Open Settings › Windows › Layout
Leave Editing on All windows to change every window, or pick one window there to change only that one.
Drag Background opacity
From 100% (solid) down to 0% (no background at all). The default is 95%.
| Setting | Range | What fades |
|---|---|---|
| Background opacity | 0 to 100% | Only the window's background. |
| Window opacity | 20 to 100% | The whole window: background, bars, text and title bar. |
Note
The setting stays when you switch themes. Fading dims the whole window on top of it. Both settings are in Settings›Windows›Layout.
Bar styles
Eight presets, your saved styles, and a style per window or per meter.
A bar style is how each bar looks: its fill, shape, border, icon and marks. Start from a preset in Settings›Bars›Style, then change anything in the style editor.
The presets
| Style | Looks like |
|---|---|
| Theme | Follows the theme (default). |
| Glossy | Shiny class-colored bars with rounded corners. |
| Minimal | A thin line under the text, no track. |
| Classic WoW | Blizzard's status bars, a gold border and Friz Quadrata. |
| Neon | Bright pills that glow, with a spark on the edge. |
| Flat class color | Plain class colors, nothing else. |
| Banana | The theme's banana art as icons and the #1 crown. |
| Compact | Thin bars and small text: more rows fit. |
One style for all, or one per window
The style you pick applies to whatever you're editing:
- All windows (the default when you open settings).
- One window: pick it in the Editing box at the top of settings, or right-click its title and choose Bar style...
- One meter: in the style editor, set Applies to to "Every Healing window" or "This window, only for Healing". Handy for thinner bars on Interrupts or Deaths.
Styles you save (Save as style...) are listed under Saved styles for every character on your account. Share... gives you a string a friend can paste into Import...
Colors and motion
| Setting | What it does |
|---|---|
| Class colors | The game's class colors, or a colorblind-safe palette that keeps classes apart for red-green colorblindness. |
| Darken bars on light themes | Light class colors (Priest, Rogue) are darkened until they stand out on light themes. On by default. |
| Reduce motion | No sliding, flashing or smooth fills. |
| Animate in combat | Lets bars fill smoothly during combat too (off by default). |
Tip
Bar text always takes a lighter or darker shade of the bar's own color, so it stays readable on every class color and theme.
Style editor
Change fill, borders, corners, icons, text and marks with a live preview.
The style editor changes every part of a bar, with a live preview next to it. Open it with Edit style... in Settings › Bars, or Bar style... in a window's menu.
Pick a starting point
Click a preset at the top (or one of your saved styles).
Change what you like
The preview follows every change. Tick In combat (live) to see how the bars look during a fight.
Choose Applies to, then Apply
All windows, this window, every window of one meter, or this window only for one meter.
What you can change
| Part | Options |
|---|---|
| Fill | Color by class, spec, role, rank (a gradient from first to last) or one color, or from the theme; solid or gradient; texture; opacity; highlight my bar. |
| Background | Show the empty track behind each bar, its color (bar color, theme or one color), opacity and texture. |
| Border and shadow | Border size and color, square, rounded or pill corners, drop shadow or glow. |
| Icon | Class, spec, role or banana icon (banana uses the theme's art when it has some), or none; left or right, inside the bar or not, and its size. |
| Marks | Crown on #1, a spark on the bar's edge, a mark on your row, and how players who died look: dimmed, a skull, or nothing. |
| Text | Font, weight (for fonts that come in several), size, outline, row height, text color (a shade of the bar, white, or the theme's text) with a minimum contrast, name color (theme, class or a hue per player), realm names and shortened names. |
| Animation | Smooth fill, slide on rank change, flash on update. |
Some things wait for FINAL
In combat (LIVE) rows stay in Blizzard's order, {percent} is blank and the crown is hidden. They show once the fight ends (FINAL).
Reset to preset undoes your changes. Text templates, number format and row spacing aren't part of a style; they're window settings (see Text, numbers and fonts).
Text, numbers and fonts
What each bar says, how numbers are written, and which font.
Each bar has a left text and a right text, built from tokens you can rearrange. By default the left says {rank}. {name} and the right shows the meter's own numbers: per second, amount and percent (a count for interrupts and dispels, the time for deaths).
Text templates
Edit Left text and Right text in Settings›Bars›Text. Leave the right text empty for the meter's own format. For example, {amount} · {perSecond} or {name} ({spec}).
| Token | Shows |
|---|---|
{rank} | Place, 1 is the top |
{name} | Player name |
{realm} | Realm (after combat) |
{spec} | Specialization |
{amount} | Total amount |
{perSecond} | Per second |
{percent} | Share of the group or of the top player. Blank in combat. |
{count} | Count (interrupts, dispels) |
{deaths} | How often the player died in this fight |
{time} | Time of death (Deaths window) |
{ilvl} | Item level. Others' after combat, once they've been inspected. |
Tokens that have nothing to show (like {percent} in combat) are left out, along with the brackets and commas around them.
Numbers
| Setting | Choices |
|---|---|
| Number style | Short (1.2M, the default), Full (1,234,567) or Thousands (1234k). |
| Decimals | 0 to 2 decimals on short numbers: 1M, 1.2M or 1.23M. |
| Per-second decimals | Advanced: decimals on DPS and HPS. |
| Thousands separator | Comma, period, space or none, for full numbers. In combat the game's own separator is used. |
Fonts and textures
Settings›Fonts & textures sets the bar font, font weight and text size (a bar style can pick its own). Peelometer ships Inter, Roboto Condensed, Bebas Neue, JetBrains Mono and Montserrat next to the game's fonts. All but Bebas Neue come in six weights: X-Thin, Thin, Normal, Medium, Bold and X-Bold. For fonts with one weight, a (?) takes the place of the weight buttons.
- Use LibSharedMedia lists (on by default) adds the fonts and textures other addons registered, like ElvUI or WeakAuras.
- Your own files: put fonts or textures in
Interface/AddOns/Peelometer_Media/(its own folder, so addon updates never delete them) and list them there. New files need a full game restart, not just/reload.
Note
In combat, names keep their realm and full numbers use the game's own separator: the game doesn't let addons change those while they're secret.
Personal mode
One bar per spell for you instead of one bar per player.
Personal mode turns a window into a list of your own spells, one bar per spell, instead of one bar per player. It works live in combat, because the game always shares your own spells.
Right-click the title of the window you want
Under Extras, tick Only my spells. The title changes to "My Damage" (or My Healing, and so on).
Fight
Your spells fill in live (LIVE). After combat they get their percentages and sort by amount (FINAL).
Click a spell bar
It opens your full breakdown. Hovering a spell bar shows the game's spell tooltip.
Note
Personal mode is per window (Settings › Windows › Personal mode, with that window picked in Editing). It isn't available on the Deaths meter.
Top 3 HUD
A tiny frame with your rank and the top 3, live in combat.
The Top 3 HUD is a tiny frame with your rank and the top three players in the current fight. It works live in combat and takes almost no room. Turn it on with , Top 3 HUD in the window menu, or Settings›Windows›Top 3 HUD.
Drag it to move it; right-click it for its options.
| Setting | Default | What it does |
|---|---|---|
| HUD shows | Top 3 and you | The top 3 with bars, or one line with your rank and number. |
| HUD ranks by | DPS | Any meter except Deaths. |
| Lock the HUD | Off | Stops it from moving and lets clicks pass through it. |
| This pull vs your best | On | After a boss fight, a line under the HUD compares you with your best on that boss. |
| HUD size | 1 | Advanced: makes it bigger or smaller. |
Mythic+ summary
The whole key at a glance when it ends.
When a key ends, Peelometer shows the whole run at a glance: the key level and time, group totals, and a row per player with damage, healing, interrupts, deaths and avoidable damage taken.
- Open in details opens the whole run in the details window.
- Post to chat... and Copy share it (see Post to chat and copy).
- Missed it? opens the last one, and so does Last Mythic+ summary in the window menu.
| Setting | Default | What it does |
|---|---|---|
| Show a summary when a key ends | On | The popup itself. |
| Banana per rank | On | A banana next to each player instead of the rank number. |
| Gold this run (Peel & Profit) | On | With Peel & Profit installed, adds the gold you made during the run and the 10 minutes after it. |
Tip
These are in Settings›Fights & history›Mythic+ summary. The summary waits until the key's last fight is saved, so it can take a few seconds after the chest.
Shame board
Just for fun: who stood in the most bad stuff.
Just for fun: the shame board ranks who took the most avoidable damage, with a banana and a caption per rank, from "Stood in everything. Twice." down to "Spotless. Not one puddle."
- It's opt-in. Turn on Avoidable damage shame board in Settings›Deaths›Shame board, then type after a fight.
- Open it after boss fights and keys shows it by itself when anyone took avoidable damage.
- It shows your last saved fight, or the whole run after a key, and the spell that hit each player most.
Note
Only you see it, unless you click Post to chat. Posts include each player's caption (turn that off with Post captions to chat). It opens after combat, never during a pull.
Bananas and captions (packs)Added in 1.0.0-beta8
A pack holds the bananas and captions for each rank: #1 to #5, Middle (6th and below), Last place and Spotless. Pick a pack from the menu on the board, or All packs (mixed) to draw from every pack. Click Customize... on the board, or type , to make your own.
- Four built-in packs: Classic, Wholesome, Savage and Pirate. Change them like your own packs: a dot marks what you added, and Reset (where Delete is for your packs) puts one back to how it ships. Or Make a copy to start a new pack from one.
- Each rank takes up to 12 bananas and 12 captions. Click the + tile to pick from almost 200 bananamojis, some animated.
- Click a banana or use the menu next to a caption to set how rare it is. A rank's picks are weighted: Common 20, Uncommon 8, Rare 3, Epic 1.
- Empty ranks borrow from Middle (for #2 to #5), then from Classic.
- The board picks the same banana and caption for a player every time you open the same fight. Shuffle picks again.
- Share makes a string anyone with Peelometer can paste into Import a pack.... Bananas their version doesn't have show as another banana.
| Token | Becomes |
|---|---|
| The player | |
| The spell that hit them most (or "the floor") | |
| Avoidable damage they took | |
| Their place, like #2 | |
| Their share of the group's avoidable damage |
Minimap button and Data Broker
Open Peelometer from the minimap, or show your DPS on an info bar.
Peelometer has a minimap button, an entry in the addon menu under the minimap, and a Data Broker feed for info bars. All of them are in Settings›General.
Minimap button
| Click | Does |
|---|---|
| Left-click | Shows or hides the meter windows. |
| Right-click | Opens settings. |
Turn it off with Minimap button. Addon compartment lists Peelometer in the addon menu under the minimap.
Data Broker feed
Peelometer DPS shows your rank and number on display addons like Titan Panel or ElvUI data texts. In combat it shows your rank; the number follows when combat ends. Hover it for the top 3, click it for the details window, right-click it for settings.
| Setting | Default | What it does |
|---|---|---|
| Data broker feed | On | Turns the feed on or off. |
| Feed shows | DPS | Which number: any meter except Deaths. |
The settings window
Search, change every window or just one, and see changes live.
Every option lives in one settings window. Type to open or close it, or to open it on a section. The gear in a title bar and Esc›Options›AddOns›Peelometer get you there too.
Search
Type any word in the search box at the top: "dps", "fps", "height", "banana". Results show where each setting lives; click one to jump to it. Search also finds advanced settings that Simple hides.
All windows or one window
The Editing box at the top says what you're changing. All windows changes the settings every window shares. Pick one window there and the settings marked This window change only that window; the others keep the shared values. Edit all windows goes back.
Handy buttons
| Button | What it does |
|---|---|
| Changed only | Shows only settings that differ from their defaults, in every section. The sidebar shows how many changed per section. |
| Simple / Advanced | Advanced shows fine-tuning settings too. |
| Reset section, Reset | Puts a whole section, or one card, back to defaults (in the scope you're editing). |
| (i) icons | Hover for a tip on any setting. Turn the icons off in Settings › Help; hovering a name still shows the tip. |
Live preview
Sections that change the look, like Bars, show a preview window next to the settings. Click Play a fight to watch it fill in combat and turn final, or tick In combat to see the live look.
Profiles
Shared settings, or a profile per character, spec or role.
A profile holds your windows, their look and every setting. Use one for all your characters, or let Peelometer switch profiles by character, spec or role. Saved fights are shared by all characters, whatever the profile.
Settings are...
| Choice | What happens |
|---|---|
| Shared by all characters | Every character uses the Default profile (the default). |
| Per character | This character gets a profile of its own. |
| Per spec (switch automatically) | Pick a profile for each spec; changing spec switches to it. A new name starts from the defaults. |
| Per role (switch automatically) | Pick a profile for tank, healer and damage; role profiles are shared by all your characters. |
| Pick by hand | Choose the profile yourself under Current profile. |
Make, copy and reset
Under Manage: make a new profile, Copy from another (your windows are replaced too), delete one (characters using it go back to Default), or Reset profile... to put every setting and window back to defaults. Each asks first.
Share a profile
Export shows a text string starting with !PM-PROFILE1! with every setting of the current profile. Keep it as a backup or give it to a friend. Import a profile... opens a box to paste a string into (and an optional name); it makes a new profile and switches to it. Your current profile isn't changed.
Note
The settings window shows which profile you're on in Settings›Profiles›Current profile. Several characters can share one; a change then changes it for all of them.
Refresh and performance
How often windows redraw, and what Peelometer costs your frame rate.
Blizzard works out the numbers; Peelometer only redraws the windows. It asks the game once per meter each refresh and shares that answer with every window showing it, and windows you can't see pause. You choose how often windows redraw, and you can see what it costs.
Refresh
| Setting | Default | What it does |
|---|---|---|
| Refresh mode | On update, at most every N seconds | Redraw on Blizzard's updates, on a timer, or on updates but at most once per interval. |
| Refresh interval | 0.25 s | Shortest time between two redraws in combat. Below 0.2 s you get a warning: it costs frame rate in big groups. |
| Out of combat | Only when something changes | Or every 1, 2 or 5 seconds. |
| Pause hidden windows | On | Windows you can't see don't refresh. Off keeps them up to date for the moment they appear. |
These are in Settings›Data & refresh, with a live Cost right now readout.
What it costs
Settings›Performance shows the time per refresh of every window and how many refreshes happen each second, the memory Peelometer uses, and the size of your saved fights. The target is under 0.5 ms per refresh in a 20-player raid. prints the same numbers in chat.
Trim history applies the history limits right away (fights to keep, spell lists) instead of after the next fight. A smaller history file loads faster at login.
Low frame rate in raids?
Raise the refresh interval to 0.5 s, keep Pause hidden windows on, and turn off smooth fills with Reduce motion. Fewer windows also help.
Slash commands
Every command, as /pm help lists it in game.
/pm, /peelo, /damage and /dmg are the same command: /dmg details works just like /pm details. on its own opens or closes settings. Click a command below to copy it.
Peelometer: Commands (also work as /peelo, /damage and /dmg):
/pm help Show this list
/pm version Show the addon version
/pm bests Your personal bests per boss and key (window and chat; /pm bests chat: chat only)
/pm history Open the fight history (details window); /pm history clear|export|import|fav <n>
/pm log Combat logging on or off (for 1svc Addon Utils)
/pm show Show the meter windows
...
Windows
| Command | What it does |
|---|---|
| Show the meter windows | |
| Hide the meter windows | |
| Show or hide the meter windows | |
| Open a new window (/pm new healing, /pm new interrupts ...) | |
| Lock every window | |
| Unlock every window | |
| Reset all fights (asks first) | |
| Window presets: create a set of windows in one click | |
| Switch to a window preset, asks first (/pm layout dungeon). No name: pick from a list | |
| Pick a theme for every window (/pm theme frost); no name opens the theme settings | |
| Hide or show Blizzard's meter window (/pm blizz hide|show) | |
| Show or hide the Top 3 HUD |
Fights and reports
| Command | What it does |
|---|---|
| Open the details window (fights, charts, deaths, reports) | |
| Open the fight history (details window); /pm history clear|export|import|fav <n> | |
| Post a report to chat; asks where (/pm report 10 for the top 10) | |
| Your personal bests per boss and key (window and chat; /pm bests chat: chat only) | |
| Open the summary of your last Mythic+ run | |
| Open the avoidable damage shame board (/pm shame edit: its images and captions) |
Settings and help
| Command | What it does |
|---|---|
| Open settings (/pm settings bars opens a section) | |
| Open the page in Esc > Options > AddOns | |
| Show this list | |
| Show the addon version | |
| Show the welcome card again | |
| What's new and the changelog (/pm changes log) | |
| Turn tester mode on or off | |
| Open the tester checklist | |
| Report a bug | |
| Request a feature | |
| Combat logging on or off (for 1svc Addon Utils) | |
| Show how long refreshes take |
If a command opens the wrong addon
Another addon may use /dmg or /damage too; the game decides which one wins. Peelometer tells you once in chat when it spots a clash. /peelo is always Peelometer's.
switches to a window preset by name, after asking. on its own shows a short list of the presets to pick from.
All settings
Every setting with its default, searchable.
All 180 settings, grouped like the in-game settings window, with their defaults. Settings marked per window can differ for each window (see All windows or one window); account-wide ones are shared by all your characters.
GeneralTurn Peelometer on or off, Blizzard's meter, minimap and slash commands.9
Peelometer
- Enable Peelometer
- Turns every meter window and all refreshing on or off, without uninstalling. Saved fights stay.Default: On
Welcome & What's new
The welcome card from your first login and the notes for each update.
- Welcome card
- Shows the card from your first login again: what Peelometer is and Blizzard's meter choice.
- What's new
- New features of this version and the full changelog. /pm changes opens it too.
- Tell me after updatesaccount-wide
- After an update, a toast and a chat line say so. Click the toast to see what's new.Default: On
Blizzard's meter
Peelometer reads Blizzard's meter data, so the meter itself must stay switched on in Options > Gameplay. Hiding only hides its window.
- Hide Blizzard's meter window
- Hides Blizzard's own meter window. Its data stays on, because Peelometer reads it.Default: Off
Buttons
- Minimap buttonaccount-wide
- Button on the minimap: left-click shows or hides the windows, right-click opens the settings.Default: On
- Addon compartmentaccount-wide
- Lists Peelometer in the addon menu under the minimap.Default: On
Data broker
Your rank and DPS for info bars like Titan Panel or ElvUI data texts.
- Data broker feed
- "Peelometer DPS": your rank and number for display addons like Titan Panel or ElvUI data texts. In combat it shows your rank; the number follows when combat ends.Default: On
- Feed shows
- Which number the data broker feed shows.Default: DPS
WindowsYour meter windows: layout, when they show, title bar and rows.39
Layout
- Lock windows
- Locked windows can't be moved or resized (hold the interact key to move one anyway).
- Snap windows
- Dragged windows snap to the screen edges and to other meter windows. Windows snapped together form a group.Default: On
- Move snapped windows together
- Dragging a window of a group moves the whole group. Shift-drag moves just that window and takes it out of the group.Default: On
- Scaleper window
- Size of the whole window, text included. Snapped windows next to it move along.Default: 1.00x
- Window opacityper window
- How see-through the whole window is.Default: 100%
- Background opacityper window
- How see-through the window's background is. Bars, text and the title bar stay solid.Default: 95%
- Click-throughper window
- Clicks go to the game world, not the window. Hold the interact key to use the window anyway.Default: Never
- Hold to interact while lockedper window
- Holding this key lets you move and resize a locked window and click a click-through one.Default: Alt
- Frame strataper windowadvanced
- Draws the window above or below other parts of the UI.Default: Medium
When it shows
- Showper window
- When this window is visible. In combat: while you fight and a few seconds after.Default: Always
- Hide in pet battlesper window
- Hides the window while a pet battle is on.Default: On
- Hide in vehiclesper window
- Hides the window while you control a vehicle.Default: On
- Hide during cutscenesper window
- Hides the window while a cutscene or movie plays.Default: On
- Hide when emptyper window
- Hides the window until the fight it shows has data.Default: Off
Fading
- Fade out of combatper window
- Dims the window a while after combat ends. Hovering it brings it back.Default: Off
- Faded opacityper window
- How see-through the window gets when it fades out of combat.Default: 35%
- Fade afterper window
- Seconds after combat before the window fades.Default: 8 s
- Moving out of combatper window
- Dims the window while your character moves out of combat, so you can see the world. It comes back when you stop or hover it.Default: Off
- Moving opacityper window
- How see-through the window gets while you move out of combat.Default: 30%
- Moving in combatper window
- Dims the window while your character moves during a fight. It comes back when you stop or hover it.Default: Off
- Opacity in combatper window
- How see-through the window gets while you move in combat.Default: 60%
- Wait before fadingper window
- How long you move before the window fades, so a quick step doesn't make it flicker.Default: 0.5 s
- Fade timeper window
- How long the window takes to fade out. 0: at once.Default: 0.4 s
- Fade back timeper window
- How long the window takes to come back when you stop, fight or hover it. 0: at once.Default: 0.2 s
Title bar
- Show title bar on hover onlyper window
- The title bar fades out until you point at the window.Default: Off
- Details buttonper window
- Shows this button in the title bar when you point at the window.Default: On
- Report buttonper window
- Shows this button in the title bar when you point at the window.Default: On
- Lock buttonper window
- Shows this button in the title bar when you point at the window.Default: On
- Reset buttonper window
- Shows this button in the title bar when you point at the window.Default: On
- Settings buttonper window
- Shows this button in the title bar when you point at the window.Default: On
Your windows
- Windows
- Your meter windows: rename, duplicate, delete or add one.
- Window presets
- Create a set of windows in one click: Solo, Dungeon, Raid healer, Raid DPS, PvP, or a layout you saved yourself.
Personal mode
One bar per spell for you instead of one bar per player. Works in combat.
- Only my spellsper window
- The window shows your own spells as bars (live in combat) instead of the group. Also in the window menu.Default: Off
Top 3 HUD
A tiny frame with your rank and the top 3 in the current fight. Works in combat.
- Show the Top 3 HUD
- A tiny frame with your rank and the top 3 in the current fight. Drag it to move it; right-click for options.Default: Off
- HUD shows
- The top 3 with bars, or one line with your rank and number.Default: Top 3 and you
- HUD ranks by
- Which number the HUD ranks by.Default: DPS
- Lock the HUD
- Stops the HUD from moving and lets clicks pass through it.Default: Off
- This pull vs your best
- After a boss fight, a line under the HUD compares you with your best on that boss.Default: On
- HUD sizeadvanced
- Makes the HUD bigger or smaller.Default: 100%
BarsHow each bar looks: fill, shape, icons, text and numbers.17
Numbers
- Number style
- How amounts are written. In combat, full numbers use the game's own separator.Default: Short (1.2M)
- Decimals
- Decimals on abbreviated amounts (1M, 1.2M or 1.23M).Default: 1
- Per-second decimalsadvanced
- Decimals on per-second values (DPS, HPS).Default: 1
- Thousands separator
- For full numbers. In combat the game's own separator is used.Default: Comma (1,234)
Animation
- Reduce motion
- No sliding, flashing or smooth fills.Default: Off
- Animate in combat
- Let bars fill smoothly during combat (uses the game's own bar smoothing).Default: Off
Style
- Bar styleper window
- Pick a preset or a saved style. Each window can have its own.
- Style editorper window
- Change fill, background, border, icons, text and marks, with a live preview.
- Styles per meterper windowadvanced
- A style that only applies while a window shows one meter (set it in the style editor).
Saved styles
- Saved stylesaccount-wide
- Styles you saved. Shared by every character on this account.
Text
- Left textper window
- Tokens: {rank} {name} {realm} {spec} {amount} {perSecond} {percent} {count} {deaths} {time} {ilvl}.Default: {rank}. {name}
- Right textper window
- Empty: the meter's own (per second, amount and percent; a count for interrupts and dispels, the time for deaths). {percent} stays blank until the fight ends. Tokens: {rank} {name} {realm} {spec} {amount} {perSecond} {percent} {count} {deaths} {time} {ilvl}.
Colors
- Class colors
- The colorblind-safe palette keeps classes apart for red-green colorblindness.Default: The game's class colors
- Darken bars on light themes
- Light class colors (Priest, Rogue) are darkened until they stand out on light themes.Default: On
Rows
- Row heightper window
- Height of each bar.Default: 18 px
- Row spacingper window
- Gap between bars.Default: 1 px
- Always show meper window
- When your own bar is scrolled out of view, it is pinned to the bottom of the window.Default: On
Hover detailsWhat shows when you hover a bar.12
Hover details
- Show hover detailsper window
- Hovering a bar shows that player's details: totals, top spells, pets, deaths and more.Default: On
- Show whenper window
- Show the details on every hover, only while a modifier key is held, or only out of combat.Default: I hover a bar
- Modifier keyper window
- The key to hold while hovering.Default: Any (Shift, Ctrl or Alt)
- Positionper window
- Next to the hovered bar, along the side of the window, or at the mouse cursor.Default: Next to the bar
- Widthper windowadvanced
- Width of the hover details.Default: 270 px
- Show click hintsper windowadvanced
- A last line saying what clicking the bar does.Default: On
Spell bars
- Strongest spells shownper window
- How many of the strongest spells to list.Default: 5
- Weakest spells shownper window
- How many of the weakest spells to list (after combat).Default: 3
- Spell bar lookper window
- Spell bars as tall as the window's bars, or thin and compact.Default: Like the window
- Spell iconsper window
- Show each spell's icon.Default: On
- Color by spell schoolper window
- Fire orange, Frost blue, Shadow purple... Spells we don't know the school of use the class color.Default: On
Sections
- Sections and orderper window
- Tick what to show; drag the grip or use the arrows to change the order.
BreakdownThe per-player spell breakdown you get by clicking a bar.9
Opening
- Open the breakdown withper window
- Which click on a bar opens that player's breakdown. The right-click menu always has it too.Default: Left click
- Reuse the breakdown window
- On: clicking another bar shows that player in the open breakdown. Off: each click opens another breakdown, so you can keep several side by side.Default: On
- Pin new breakdowns
- A pinned breakdown keeps updating while the fight goes on.Default: On
Columns
- Sort spells by
- The starting sort. In combat spells stay in Blizzard's order; sorting turns on when combat ends.Default: Amount
- Per second column
- Show the per second column.Default: On
- Percent column
- Show each spell's share of the player's total (after combat).Default: On
- Overkill column
- Show overkill for damage done.Default: On
- Pet column
- Show which pet or guardian cast the spell.Default: On
- Target column
- Show each spell's main target.Default: On
ThemesColors and banana art for every window, or one window.7
Theme
- Themeper window
- Colors and banana art of the meter windows. Pick a window at the top of the settings to give it its own theme.
Seasonal and random
- Seasonal banana themes
- Hallow's End (Oct 18 - Nov 1) and Winter Veil (Dec 16 - Jan 2) switch the theme while the holiday runs. Windows with their own theme keep it.Default: Off
- Theme on login
- Start each session with a banana theme: the same one all day, or a new one each login. Your own pick stays saved.Default: My theme
Banana art
- Banana in the title barper window
- Banana themes show their banana instead of the meter logo, and a crown on the top bar.Default: On
- Watermark strengthper window
- A faint banana behind the bars. 0 turns it off.Default: 6%
Your themes
- Build your own themeaccount-wide
- Pick 8 colors; Peelometer works out the rest and keeps text readable. Saved for all your characters.
Credits
- Credits
- Where the theme colors come from.
Fonts & texturesGame fonts, shipped fonts, bar textures, SharedMedia and your own files.5
Fonts
- Bar fontper window
- Font of the text on the bars. A bar style can pick its own.Default: Theme font
- Font weightper window
- How thin or bold the bar text is. Inter, Roboto Condensed, JetBrains Mono and Montserrat come in six weights.Default: Normal
- Text sizeper window
- Size of the text on the bars. A bar style can pick its own.Default: 12 pt
SharedMedia
- Use LibSharedMedia listsaccount-wide
- Adds the fonts and textures other addons registered (ElvUI, Details, WeakAuras ...).Default: On
Your own files
- Your own filesaccount-wide
- Fonts and textures you put in Interface\AddOns\Peelometer_Media\. New files need a full game restart.
Data & refreshHow often windows refresh and how numbers are worked out.13
Refresh
Refreshing only redraws the windows; Blizzard computes the numbers. Faster refreshes cost frame rate in big groups.
- Refresh mode
- When windows redraw in combat: on Blizzard's updates, on a timer, or on updates but at most once per interval.Default: On update, at most every N seconds
- Refresh interval
- Shortest time between two redraws in combat.Default: 0.25 s
- Out of combat
- How often windows redraw out of combat. Numbers rarely change then, so redrawing only when something changes is cheapest.Default: Only when something changes
- Pause hidden windows
- Windows you can't see don't refresh. Turn it off to keep hidden windows up to date, so they show the latest numbers the moment they appear.Default: On
- Cost right now
- How long one refresh of every window takes and how many happen each second. Measured live.
Saving fights
- Wait for final numbers up toaccount-wideadvanced
- After combat the numbers stay hidden for a moment. The fight is saved as soon as they are final; after this long it is skipped.Default: 20 s
- Save spell listsaccount-wide
- Saves each player's spells with the fight (for breakdowns of past fights). Off: totals only, less memory.Default: On
Calculation
- Percent of
- Percent shows each player's share of the group's total, or compares them to the top player. After combat only.Default: Group total
- Per second
- Which time DPS and HPS divide by in saved fights: Blizzard's (each player's active time), the whole fight, or each player's time alive.Default: Blizzard's value
- Pets
- Count pets and guardians with their owner, or show them as their own rows (saved fights with spell lists).Default: Merge into owner
- Include helpers outside the group
- Players who helped but weren't in your group (open world) are listed in saved fights.Default: On
- Per-second roundingadvanced
- Decimals kept for per-second values in saved fights. Counts (interrupts, dispels) are whole numbers.Default: 1
- After combat, use the saved fight
- Windows showing the current fight switch to its saved copy once it's saved, so these settings apply right away.Default: On
Fights & historyWhich fights are kept, how they are grouped and when they reset.26
Saved fights
- Fights to keepaccount-wide
- How many fights are saved. Older ones are deleted, except favorites and recent boss fights.Default: 30
- Keep boss fights foraccount-wide
- Boss fights stay this many days, even past the number of fights above. 0: no exception.Default: 7 d
- Spell lists for the newestaccount-wideadvanced
- Older fights keep only their totals, so the saved file stays small (the game loads it at login). Favorites keep everything.Default: 15
Filters
- Skip fights shorter thanaccount-wide
- Fights this short are not saved. Boss fights are always saved.Default: 5 s
- Skip fights with less damage thanaccount-wide
- Group damage below this (in thousands) is not saved. 0: save every fight. Boss fights are always saved.Default: 0k
Fight picker
- Boss fights only
- The fight picker lists boss fights and the whole-run segments, no trash.Default: Off
- Merge trash between bosses
- Trash fights between two bosses show as one segment: "Trash before X".Default: On
- Whole M+ run as one segment
- Adds the whole key (every pull, trash and bosses) to the fight picker.Default: On
- Whole arena match as one segment
- Adds the whole arena match or battleground to the fight picker.Default: On
- Whole raid night or dungeon as one segment
- Adds every fight of a raid night (or dungeon, or day out in the world) as one segment.Default: On
- Runs and days in the pickeradvanced
- How many runs, raid nights and days the fight picker lists before "Older".Default: 8
Fight names
- Name fights by
- Smart: boss name, "Trash before X", key level and dungeon. Or always the enemy, the zone or the time.Default: Smart (boss, trash before boss, key)
- Pull numbers on boss fights
- "Boss - pull 7" for every pull after the first.Default: On
Item level and gear
- Inspect group membersaccount-wide
- Out of combat, quietly inspects group members who are close by (one every few seconds) to read their item level and gear. Off: only yours.Default: On
- Save gear with fightsaccount-wide
- Saves each player's equipped items with the fight, for the gear list in the breakdown. Each set of gear is saved once, so it adds little. Off: item level only.Default: On
Personal bests
- Toast on a new personal best
- After a boss kill or a finished key, a small notice when you beat your best DPS or HPS there.Default: On
- This pull vs your best
- After each boss pull (kill or wipe), a small notice with your number against your best kill on that boss.Default: On
- Compare
- Which number the pull comparison uses. By role: HPS for healers, DPS for everyone else.Default: By your role
- Your personal bests
- Your best DPS and HPS per boss (kills) and per key level (finished runs), on this character. /pm bests.
Reset Blizzard's meter
- When entering an instance
- Start each dungeon, raid or arena with an empty meter. Your saved fights are kept.Default: Ask
- When joining a group
- Reset Blizzard's meter when you join a party or raid.Default: Off
- When leaving a group
- Reset Blizzard's meter when you leave your party or raid.Default: Off
- Confirm before reset
- Ask before any reset (automatic ones and the reset button).Default: On
Mythic+ summary
A popup when a key ends: damage, healing, interrupts, deaths and avoidable damage for the whole run.
- Show a summary when a key ends
- Damage, healing, interrupts, deaths and avoidable damage for the whole run, with buttons to open the details or post it. /pm summary opens the last one.Default: On
- Banana per rank
- A banana next to each player in the summary instead of the rank number.Default: On
- Gold this run (Peel & Profit)
- With Peel & Profit installed, the summary shows the gold you made during the run (and the 10 minutes after it).Default: On
DeathsDeath counts, death log, recaps and alerts.9
Death alerts
- Alert when
- A sound, a big text and a flash on the bar when someone dies. Never posts to chat.Default: Never
- Play a sound
- Plays the raid warning sound.Default: On
- Show text on screen
- "You died" or "<name> died" near the top of the screen for a few seconds.Default: On
- Flash the bar
- Flashes the player's bar in the meter windows. In combat only your own bar can be found.Default: On
Death log
- Death summary after combat
- After each fight with deaths, lists who died and what killed them in your chat window. Only you see it.Default: Off
- Pull number in fight names
- Shows "Boss - pull 7" in the details window's fight list.Default: On
Shame board
Just for fun: who took the most avoidable damage, with a banana per rank.
- Avoidable damage shame board
- Opt-in fun view of avoidable damage taken, with a silly banana per rank. Only you see it unless you post it. /pm shame opens it.Default: Off
- Open it after boss fights and keys
- Shows the board after each boss fight (outside keys) and when a key ends, if anyone took avoidable damage.Default: Off
- Shame board
- Opens the board for your last saved fight.
Interrupts & dispelsInterrupt and dispel counts and which spells were used.2
Interrupts
- Interrupts by crowd control
- Why interrupts by stuns and knockbacks aren't counted in game.
- Show which spells
- The details window lists the spells each player interrupted or dispelled with.Default: On
ReportsPosting results to chat and copying them as text.11
Posting to chat
- Default channel
- Picked first when you post a report. You are always asked where before anything is posted.Default: Your group (instance, raid or party)
- Lines to post
- How many players a report lists.Default: Top 5
- Line format
- What each line shows after the name.Default: Amount (per second)
- Confirm before posting
- Shows the exact lines and asks before posting. You can skip it per channel.Default: On
- Channels that don't ask
- Channels where you picked "don't ask again". Reset to be asked again.
Copy as text
- Copy template
- What "Copy as text" puts in the box first: the top 5, the top N or every metric.Default: Short (top 5)
After a fight
- Fight summary toast
- A small notice when a fight ends. Click it to open the details window.Default: Off
- Only for fights longer thanadvanced
- Shorter fights don't show the toast.Default: 20 s
- Offer to post after a kill or a finished key
- A small prompt after a boss kill or a finished key. Clicking it still asks where and confirms.Default: Off
Title bar
- Details button
- A button on each window's title bar (on hover) that opens the details window.Default: On
- Post to chat button
- A button on each window's title bar (on hover) that posts the window's fight to chat. It always asks where first.Default: Off
1svc Addon UtilsSaving fights for 1svc Addon Utils, the companion app, and sharing or exporting them.10
Combat logging
- Turn on combat logging automatically
- Writes Logs/WoWCombatLog.txt in the content you pick below. 1svc Addon Utils reads it for overhealing, crits, uptime, crowd control and interrupts by CC. The file grows quickly (hundreds of MB per raid night).Default: Off
- In raids
- Log in raid instances.Default: On
- In Mythic+
- Log while a keystone runs.Default: On
- In other dungeons
- Log in normal, heroic and mythic dungeons without a keystone.Default: Off
- In PvP
- Log in arenas and battlegrounds.Default: Off
- Everywhere
- Log all the time, also in the open world. Makes the biggest files.Default: Off
- Turn it off again when I leave
- Only if Peelometer turned it on. Logging you started yourself (/combatlog) is left alone.Default: On
- Turn on advanced combat logging tooadvanced
- Adds health, owners and positions to each line. Needed for pets and the most accurate numbers in 1svc Addon Utils.Default: On
- Remind me on a boss pull if logging is off
- A short line in chat when a boss fight starts and the combat log is off.Default: Off
For 1svc Addon Utils
- Save extra info for 1svc Addon Utilsaccount-wide
- Your characters (class and spec) and when combat logging was on, so 1svc Addon Utils can match log files to saved fights. Tiny; stays on your computer.Default: On
ProfilesPer character, per spec or shared settings.4
Profile
A profile holds your windows, their look and every setting. Saved fights are shared by all characters whatever the profile.
- Settings areper character
- Shared: every character uses the Default profile. Per character: this character gets its own. Per spec and per role switch automatically when you change spec. Pick by hand: you choose below.Default: Shared by all characters
- Current profile
- The profile this character uses now. Several characters can share one: a change then changes it for all of them.
- Profile for each spec
- Changing spec switches to its profile. A new name starts from the defaults.
- Profile for each role
- Changing to a spec of another role switches to that role's profile. Role profiles are shared by all your characters.
PerformanceWhat Peelometer costs and ways to make it cheaper.3
Cost
What Peelometer costs right now. Target: under 0.5 ms per refresh in a 20-player raid.
- Right now
- Time per refresh of every window, and refreshes per second, over the last second.
- Memory
- Memory Peelometer uses and the size of your saved fights (the game loads that file at login).
- Trim history
- Applies the history limits now (fights to keep, spell lists) instead of after the next fight.
HelpWhat a meter can do in 12.x, slash commands and bug reports.4
Tester mode
For beta testers: a checklist of things to try, one per feature, with an export for bug reports. Nothing extra is recorded.
- Tester modeaccount-wide
- Adds the Checklist tab to the What's new window. Mark each item Works, Broken or Skipped, then export it into a bug report.Default: Off
- Checklist
- The tester checklist. /pm checklist opens it too.
- Test report
- Your checklist as text to paste into the bug form on the website.
Info icons
- Show info iconsaccount-wide
- The (i) icons next to settings and titles. When they're off, hovering a setting's name still shows its tip.Default: On
Mouse and keyboard
Every click, drag and wheel in one table.
Everything you can do with the mouse on a meter window, in one place.
Title bar
| Do this | On | What happens |
|---|---|---|
| Drag | Title bar | Moves the window (and its group). |
| Shift + drag | Title bar | Moves just this window and takes it out of its group. |
| Click | Meter name | Opens the meter picker. |
| Click | Fight name | Opens the fight picker. |
| Right-click | Title bar | Opens the window menu (so does the gear). |
| Mouse wheel | Title bar or tabs | Switches tabs, when the window has some. |
| Drag | Bottom right corner | Resizes the window. |
Bars
| Do this | What happens |
|---|---|
| Point at a bar | Hover details (or only while holding a modifier, if you set it so). |
| Click | Opens that player's breakdown (or Shift + click, if you set it so). |
| Right-click | The window menu with that player's breakdown, a breakdown in a new window and Compare with me. |
| Mouse wheel | Scrolls the rows. |
Locked and click-through windows
Hold Alt (or the key you set in Hold to interact while locked) to move and resize a locked window, or to click a click-through one.
Elsewhere
| Where | Click | Right-click |
|---|---|---|
| Minimap button | Shows or hides the windows | Settings |
| Data Broker feed | Details window | Settings |
| Top 3 HUD | Drag to move | Its options |
| Fight summary toast | Details window | - |
Key bindings
Peelometer doesn't add key bindings. To get a key for something, put a slash command like /pm toggle in a macro and drag it to your action bar.
What a meter can see in 12.x
What Blizzard gives addons, what it doesn't, and why numbers can differ.
Patch 12.0 changed how meters work. Addons can no longer read the combat log, so every Retail meter, Peelometer included, now shows the numbers Blizzard's own meter works out. Here is what that means for you, in plain words.
In game
Blizzard's servers
Work out damage, healing, interrupts, deaths and spells for your group.
Blizzard's meter data
The game's own meter. It must stay switched on; its window can be hidden.
Peelometer
Shows it live (LIVE), does the math after combat (FINAL) and saves each fight.
On your PC
WoWCombatLog.txt
The game still writes the combat log to a file when logging is on (/combatlog, or Peelometer can switch it on).
Peelometer's saved fights
Written to your SavedVariables file at /reload or logout.
1svc Addon Utils
Reads both on your PC: overhealing, crits, uptime, crowd control, compares and trends. Nothing is uploaded.
What you can see, and when
| In combat | After combat | Desktop app | |
|---|---|---|---|
| Damage, healing, absorbs, DPS and HPS | Yes | Yes | Yes |
| Interrupts and dispels | Yes | Yes | Yes |
| Deaths, with Blizzard's death recap | Yes | Yes | Yes |
| Your own spells | Yes | Yes | Yes |
| Other players' spells | After combat | Yes | Yes |
| Percent, sorting, your own per-second math | After combat | Yes | Yes |
| Stops by stuns and knockbacks | No | No | Estimated |
| Overhealing, crits, buff uptime, crowd control | No | No | Yes |
- In combat the numbers are secret: addons may show them but not do math with them. That's why windows say LIVE and percentages are blank.
- After combat they turn normal within a few seconds, and Peelometer does the rest.
- Never in game: overhealing, friendly fire, healing taken, threat, crits and buff uptime aren't given to addons at all. The desktop app reads them from the combat log file the game still writes on your PC.
Why numbers can differ from other meters
Blizzard's meter: in combat, Peelometer shows exactly Blizzard's numbers. After combat they still match unless you changed how they're worked out.
Other addons: they read the same data, so totals should match. Differences usually come from choices:
| What differs | In Peelometer |
|---|---|
| Per second | Blizzard's value (each player's active time) by default. Fight length or time alive can be picked in Settings › Data & refresh › Calculation. |
| Percent | Share of the group total by default, or compared to the top player. |
| Pets | Merged into their owner by default, or their own rows. |
| Which fight | Current, Overall, a saved fight, or a whole run. Trash between bosses is merged by default. |
| Who is listed | Helpers outside your group (open world) are included by default. |
Warcraft Logs and the desktop app read the full combat log file, which has more detail than the game gives addons. Small differences there are normal.
Note
Blizzard's meter has to stay switched on for any of this to work. Peelometer can hide its window for you (see Blizzard's meter).
The desktop app
1svc Addon Utils adds what no addon can see in game.
The free 1svc Addon Utils app for Windows and macOS has a Peelometer page. It reads the fights Peelometer saves and the combat log file the game writes, both on your own PC, so it can show what no addon can see in game. Peelometer works fine without it.
What the app adds
| Feature | What it does |
|---|---|
| Saved fights | Every fight Peelometer saved, with filters by instance, boss, date and character. Export as CSV or JSON. |
| Compare and trends | Pull 3 against pull 7, and your DPS on a boss over weeks. |
| From the combat log | Overhealing, crits, buff uptime and crowd control, matched to the same fights. |
| Stops by stuns and knockbacks | A best guess from the log, labeled estimated, with each stop listed so you can check it. |
| Second-screen meter | A live meter a few seconds behind the game. |
Combat logging
The extra numbers come from Logs/WoWCombatLog.txt, which the game only writes while combat logging is on. Peelometer can switch it on for you in Settings›1svc Addon Utils:
- Turn on combat logging automatically (off by default), then choose where: raids and Mythic+ are ticked, other dungeons, PvP and everywhere aren't.
- Turn it off again when I leave: only if Peelometer turned it on. Logging you started yourself with
/combatlogis left alone. - Turn on advanced combat logging too (on): needed for pets and the most accurate numbers.
- Remind me on a boss pull if logging is off: a short line in chat.
switches logging on or off by hand; says which it is.
Save extra info for 1svc Addon Utils (on) keeps your characters and when logging was on, so the app can match log files to saved fights. It's tiny and stays on your PC.
When the app sees new fights
The game writes Peelometer's saved fights to disk at /reload and logout, so the app shows a fight after one of those. Nothing is uploaded; the app reads the files on your PC. In-game bug reports show up in the app the same way, and you send them from there.
Troubleshooting
Empty windows, missing percentages, slash command clashes and more.
Something not right? Most problems have a quick fix. Click a question to open it.
My windows are gone
- Type . A left-click on the minimap button also shows and hides them.
- Right-click where the window was and check Show in the window menu, or look at Settings›Windows›When it shows: a window set to In combat or In a raid hides elsewhere, and Hide when empty hides it until there's data.
- Check Enable Peelometer in Settings›General.
The windows say there's no data, or that Blizzard's meter is switched off
"No data yet" is normal before your first fight. If a window says Blizzard's damage meter is switched off, click Turn it on: Peelometer needs that meter's data (see Blizzard's meter). In a few places the game has no meter data at all, and the window says so.
Percentages are blank and the badge says LIVE
That's how 12.x works during a fight: numbers are secret until combat ends. A few seconds after the fight, the badge turns FINAL and percentages fill in. Why?
A fight wasn't saved
Fights shorter than 5 seconds, below your damage filter, or where nobody did anything aren't saved (boss fights always are). Very rarely the numbers stay secret for longer than Wait for final numbers up to (20 seconds); that fight is skipped. Both are in Settings›Data & refresh and Settings›Fights & history›Filters.
I can't move or resize a window
It's locked. Hold Alt while you drag, click the lock in its title bar, or type .
Clicks go through a window, or it blocks clicks on the world
That's Click-through in Settings›Windows›Layout: Never, In combat or Always. Hold Alt to click a click-through window anyway.
/dmg or /damage opens another addon
Another addon uses the same command and the game picked it. Use or instead.
I can't post to chat
A fight that's still going can't be posted, and the game locks addon chat during boss fights and Mythic+ runs. Post again when the fight or key ends.
The death recap says it's no longer available
The game keeps death recaps for a short while only. The time and killing blow stay in your history.
My frame rate drops in raids
See Refresh and performance: a longer refresh interval and Reduce motion help most.
I want to start over
Settings›Profiles›Manage has Reset profile...: every setting and window goes back to its default. Saved fights stay; clear them with (favorites are kept).
Got a Lua error?
Please tell us. fills in your addon and game version for you, or use the website form (see Report a bug or idea). Copy the error text if you can; /console scriptErrors 1 makes the game show errors.
FAQ
Short answers to common questions.
Short answers. Each links to the section with the long one.
Is Peelometer free?
Yes, on CurseForge. The 1svc Addon Utils desktop app is free too, and optional.
Does it work on Classic?
No. Peelometer is for World of Warcraft Retail (patch 12.1.5 and later).
Why does Blizzard's damage meter have to stay on?
No addon can read the combat log any more, so every Retail meter reads Blizzard's meter data. Peelometer can hide its window and keep the data on. More
Why are percentages blank during a fight?
In combat the game gives addons secret numbers they can show but not do math with. Percentages and sorting fill in a few seconds after the fight. More
Will my numbers match Details! or Blizzard's meter?
They match Blizzard's, because they're the same data. Other meters read the same source; differences come from choices like per-second time or pets. More
Can I run it next to another meter?
Yes. They don't share anything and don't get in each other's way.
Can it show overhealing, crits or buff uptime?
Not in game: Blizzard doesn't give addons those numbers. The desktop app reads them from the combat log file. More
Will it slow down my game?
It's built to be light: one data call per meter each refresh, shared by every window, and hidden windows pause. Settings › Performance shows what it costs right now. More
Is my data sent anywhere?
No. Fights are saved in your own SavedVariables file. The desktop app reads that file and the combat log on your PC; nothing is uploaded.
Does it come in other languages?
English only for now. It works on every game client language; spell and player names come from the game.
It's a beta. What should I expect?
Things may be rough around the edges. Your settings and saved fights are kept across updates. If something looks wrong, please tell us; tester mode has a checklist of things to try.
Report a bug or idea
Tell us what broke or what you'd like, from the website or in game.
Found a bug, or have an idea? We read every report. You can send one from this website or from inside the game.
From the website
Use the buttons below, the bug icon in the top bar, or Something wrong here? under any section of this wiki (that one notes which section you were reading). Check the known issues first; your problem may already be on the list.
From the game
Type /pm bug (or /pm feature for an idea)
A small form opens. It's also in Settings › Help › Feedback.
Give it a title and say what happened
Steps to make it happen help a lot.
Save it, or copy a link
Save for Addon Utils saves it in game. After
/reloador logout it shows up in the 1svc Addon Utils app: check it there and click Send. Nothing is sent before that. No app? Copy link instead gives you the website form's link and your version info to paste.
What gets sent
What you type, the addon and game versions and your game language. Never character, realm or guild names. You see the report in 1svc Addon Utils before you send it.
Testing the beta? Add your checklist export from tester mode; it tells us what works for you too. starts it.
Tester mode and What's new
The beta checklist, What's new after updates, and the changelog.
Peelometer is in beta. Tester mode gives you a checklist of things to try, one per feature, with what should happen. Nothing extra is recorded; it only helps you tell us what works.
The tester checklist
Type /pm tester
Tester mode turns on and the checklist opens. opens it again later; it's also in Settings›Help›Tester mode.
Try an item and mark it
Each item says what to do and what should happen. Mark it Works, Broken or Skip.
Export
Click Export and paste the text into a bug report on the website.
Note
When an update changes an item, it goes back to "not tried" so you can check it again. Type again to turn tester mode off.
What's new and the changelog
After an update, a small notice and a chat line say so; click the notice for What's new. opens it any time, and opens the full changelog. Turn the notice off with Tell me after updates in Settings›General. The same notes are on the changelog page.