Wiki

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.

Getting started

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.

  1. 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 a Peelometer folder there.

  2. Log in

    Two windows appear at the bottom right of your screen: Damage and Healing. They stay empty until your first fight.

  3. 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.

The welcome card (left) and What's new (right).

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.

  1. 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.

  2. 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?

  3. Point at a bar

    Hover details show that player's totals and strongest spells.

  4. Click a bar

    The breakdown window lists every spell with amount, per second and percent.

  5. Right-click the title bar

    The window menu has everything else: a new window, tabs, theme, bar style, presets and reports.

In combat: LIVE
After combat: FINAL

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.

What a window shows when Blizzard's meter is switched off.

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.

Meter windows

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.

A Damage window with the mouse over it: the meter and fight pickers on the left, a FINAL badge and four buttons on the right, five player bars below
  1. 1Meter picker. Click it to show another meter (Meters).
  2. 2Fight picker. Current fight, Overall or a saved fight (Fights).
  3. 3Badge and timer. LIVE during combat, FINAL once the numbers are complete, then the fight length. More
  4. 4Buttons. Details window, lock, reset all fights and the window menu (gear).
  5. 5Your row. A mark on the left shows which bar is you.
  6. 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.

The window menu (right-click the title bar).

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.

The meter picker.

Damage

MeterTab nameWhat it shows
Damage doneDamageAll the damage each player did, pets and guardians included.
DPSDPSDamage done per second.
Damage takenTakenDamage each player took.
Avoidable damage takenAvoidableDamage from things Blizzard marks as avoidable: the swirls and puddles you could have stepped out of.
Enemy damage takenEnemiesDamage the enemies took, one bar per enemy.

Healing

MeterTab nameWhat it shows
Healing doneHealingHealing each player did.
HPSHPSHealing done per second.
AbsorbsAbsorbsDamage stopped by each player's shields.

Actions

MeterTab nameWhat it shows
InterruptsInterruptsHow many spell casts each player interrupted.
DispelsDispelsHow many effects each player dispelled.
DeathsDeathsWho 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.

MeterTab nameWhat it shows
Damage + healingOutputDamage and healing added together.
Healing + absorbsHeal+AbsHealing and absorbs added together.
OverkillOverkillDamage past what was needed to kill the target.
Avoidable damage shareAvoid %How much of each player's damage taken was avoidable.
Deadly hits takenDeadlyHits 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.

One fight, start to finish
  1. Pull

    The fight starts. Windows switch to the new fight.

  2. In combat LIVE

    Blizzard's numbers in Blizzard's order. Amounts, per second and bars all update.

  3. Combat ends

    Numbers stay hidden from addons for a moment.

  4. A few seconds later FINAL

    Numbers turn normal: percent, sorting, merged pets and your own per-second math fill in.

  5. Saved

    The fight goes into your history, named by boss, key or zone.

What a window shows at each moment of a fight.

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
In combatAfter combat
Bars, amounts, per secondYesYes
Interrupts, dispels, deathsYesYes
Your own spells (hover, breakdown)YesYes
Other players' spellsAfter combatYes
Percent, sorting, merged petsAfter combatYes
Damage + healing, overkill and the other after-combat metersNoYes

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.

The fight picker, with a dungeon's saved fights open.
ChoiceWhat it shows
Current fightThe fight going on now, or the last one. Fights where nobody did anything are skipped, so Current keeps your last real fight.
OverallEverything Blizzard's meter holds since the last reset.
Past fightsBlizzard's own list of recent fights, newest first, with their length.
Saved fightsPeelometer'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.

Four windows from the Dungeon preset.

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

  1. 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.

  2. Switch tabs

    Click a tab, or turn the mouse wheel over the title bar or the tabs.

  3. Remove a tab

    Untick it in the same menu. With one tab left, the window goes back to a single meter.

A window with four tabs.
Settings › Windows › Your windows.

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.

Snapping and groups

1. Drag near another window

Damage
Healing

It snaps to the edge, and to the screen edges too.

2. Drag one, the group follows

Damage
Healing

Move snapped windows together is on by default.

3. Shift-drag to take one out

Damage
Healing

Or right-click the title: Detach from group.

Windows that touch form a group. Drag one to move them all; Shift-drag takes one out.

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

SettingWhat it does
Lock windowsLocked windows can't be moved or resized. Use the lock button in the title bar, the window menu, or and for every window.
Click-throughNever, 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 lockedHold this key (Alt by default; or Ctrl, Shift, None) to move and resize a locked window, or to click a click-through one.
Frame strataAdvanced: draws the window above or below other parts of your UI.
Settings › Windows › Layout, editing one window.

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

ChoiceThe window shows
AlwaysAll the time (the default).
In combatWhile you fight, and a few seconds after.
In a groupWhile you're in a party or raid.
In an instanceIn dungeons, raids, scenarios, arenas and battlegrounds.
In a raidWhile you're in a raid group.
In Mythic+While a keystone runs.
In PvPIn arenas and battlegrounds.
NeverNot 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.

Settings › Windows › Fading.

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-beta4

Windows 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.

Fade while moving
  1. Damage

    1. You start moving

    The window is at its normal opacity.

  2. Damage

    2. Wait before fading

    0.5 s by default, so a quick step doesn't make it flicker.

  3. Damage

    3. Faded

    Fades over the Fade time to the Moving opacity (30%).

  4. Damage

    4. Stop, fight or hover

    Comes back over the Fade back time.

Out of combat and in combat each have their own switch and opacity.
  1. 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.

  2. Turn on Moving out of combat, Moving in combat, or both

    Each one shows its own opacity slider when you turn it on.

  3. 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.

SettingDefaultWhat it does
Moving out of combatOffDims the window while you move out of combat.
Moving opacity30%How see-through it gets while you move out of combat.
Moving in combatOffDims the window while you move during a fight.
Opacity in combat60%How see-through it gets while you move in combat.
Wait before fading0.5 sHow long you move before it fades, so a quick step doesn't make it flicker.
Fade time0.4 sHow long it takes to fade out. 0: at once.
Fade back time0.2 sHow 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+.

Window presets (/pm presets).

Use a preset

  1. Open Window presets

    Type , right-click a title bar and choose Window presets..., or click Choose a preset... in Settings›Windows›Your windows.

  2. 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.

  3. Move them where you like

    The new windows are snapped together, so they move as one.

PresetWindowsFor
SoloDamage done, Damage takenOne damage window and what hit you.
DungeonDamage done, Healing done, Interrupts, DeathsDamage, healing, kicks and deaths for a 5-player group.
Raid healerHealing done, Absorbs, Dispels, DeathsHealing first, plus absorbs, dispels and deaths.
Raid DPSDamage done, Avoidable damage taken, InterruptsDamage for 20 players, avoidable damage and kicks.
PvPDamage done, Healing done, Interrupts, Enemy damage takenDamage, 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.

/pm layout
Details

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.

After combat: every section filled in.
In combat LIVE: math waits until the fight ends.

What it shows

SectionOn by defaultWhat's in it
Name, spec and rankYesClass, spec, place in the window, and whether it's you.
TotalsYesAmount, per second, share of total and of the top player (after combat), fight length.
Strongest spellsYesThe top 5 spells as bars, colored by spell school.
Weakest spellsYesThe bottom 3 (after combat, since it needs sorting).
Pets and guardiansYesWhat each pet added, and the player's own spells.
Overkill, avoidable and deadly hitsYesDamage past the kill, avoidable damage taken and deadly hits.
Main target per spellNoBlizzard keeps one main target per spell.
DeathsYesWhen they died and what killed them.
Compare with meNoTheir 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.
Settings › Hover details.

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.

A breakdown comparing two players.

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

ColumnWhat it shows
SpellSpell name and icon, colored by spell school.
AmountThe spell's total.
Per secondThe spell's amount per second.
PercentIts share of the player's total (after combat).
OverkillDamage past the kill (damage done only).
PetWhich pet or guardian cast it.
TargetBlizzard'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.

The details window, Summary tab.

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:

ButtonShows
This fightThe fight you picked.
All pullsEvery pull of that boss together (for a boss you pulled more than once).
Whole run, Raid night, Whole matchEvery fight of the key, raid night, match or dungeon visit it belongs to.
OverallEverything 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

TabWhat's in it
SummaryTiles for damage, healing, deaths, interrupts and fight length, and a bar chart per player. Click a player for their spells.
SpellsOne player's spells as bars with amount and share. Pick the player at the top, or open the full breakdown window.
PullsYour 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.
DeathsWho died, when, the killing blow and overkill. See Deaths.
InterruptsWho interrupted, how often and with which spells. See Interrupts and dispels.
DispelsThe same for dispels.
Pulls: every pull of a boss, with your best marked.
Spells: one player's spells.

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.
Deaths with killing blows; click Open for Blizzard's recap.

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:

SettingWhat it does
Alert whenNever, I die, or Anyone in my group dies.
Play a soundPlays 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 barFlashes the player's bar in the meter windows. In combat only your own bar can be found.
Death summary after combatAfter a fight with deaths, lists who died and what killed them in your chat window. Only you see it.
Settings › Deaths.

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.

Interrupts with the spells used.

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.

History & reports

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

SettingDefaultWhat it does
Fights to keep30How many fights are saved. Older ones are deleted, except favorites and recent boss fights.
Keep boss fights for7 daysBoss fights stay this long even past the number above. 0: no exception.
Skip fights shorter than5 sVery short fights aren't saved. Boss fights always are.
Skip fights with less damage than0Group damage below this (in thousands) isn't saved. 0 saves every fight.
Spell lists for the newest15Advanced. 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.

Settings › Fights & history.

History in chat

CommandWhat 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.
Reset rules.

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.

Your personal bests (/pm bests).
Each pull against your best, in the details window.
  • 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

SettingDefaultWhat it does
Toast on a new personal bestOnAfter a boss kill or a finished key, a small notice when you beat your best there.
This pull vs your bestOnAfter each boss pull, kill or wipe, a small notice with your number against your best kill on that boss.
CompareBy your roleWhich 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

  1. Open Post to chat

    From the window menu (Post to chat...), the details window, or . starts with the top 10.

  2. 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.

  3. 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.

Post to chat, with the exact lines in the preview.
The confirm step.

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

SettingDefaultWhat it does
Default channelYour groupPicked first: instance, raid or party, whichever you're in.
Lines to postTop 5How many players a report lists.
Line formatAmount (per second)What each line shows after the name.
Confirm before postingOnShows the exact lines and asks first. Channels you skipped are listed under Channels that don't ask.
Fight summary toastOffA small notice when a fight ends; click it for the details window.
Offer to post after a kill or a finished keyOffA small prompt; clicking it still asks where and confirms.
Post to chat buttonOffAdds a post button to each title bar.

All in Settings›Reports.

Look & feel

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 .

The theme picker.

All 45 themes

GroupThemes
Peel & ProfitFlat, Blizzard, Parchment, Void, High contrast, High contrast light, Faction
BananasClassic Banana, Golden, Boonana, Karate, Inferno, Mad Banana, Frost, Arcane, Fel, Hazard, Pirate, Groovy, Hallow's End, Winter Veil
BananaMojis palettesClassic 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 themesDracula, 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.

Parchment and Frost, one per window.
Hazard and Arcane.

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

  1. Open Settings › Themes › Your themes

    Start from scratch, or click Start from current theme.

  2. 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).

  3. Save and use

    Saved themes are shared by all your characters and listed under Custom in the picker.

Build your own theme from 8 colors.

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-beta5

Make 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.

Background opacity 95% (the default), 40% and 0%.
  1. Open Settings › Windows › Layout

    Leave Editing on All windows to change every window, or pick one window there to change only that one.

  2. Drag Background opacity

    From 100% (solid) down to 0% (no background at all). The default is 95%.

SettingRangeWhat fades
Background opacity0 to 100%Only the window's background.
Window opacity20 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.

Banana
Neon
Glossy

The presets

StyleLooks like
ThemeFollows the theme (default).
GlossyShiny class-colored bars with rounded corners.
MinimalA thin line under the text, no track.
Classic WoWBlizzard's status bars, a gold border and Friz Quadrata.
NeonBright pills that glow, with a spark on the edge.
Flat class colorPlain class colors, nothing else.
BananaThe theme's banana art as icons and the #1 crown.
CompactThin 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

SettingWhat it does
Class colorsThe game's class colors, or a colorblind-safe palette that keeps classes apart for red-green colorblindness.
Darken bars on light themesLight class colors (Priest, Rogue) are darkened until they stand out on light themes. On by default.
Reduce motionNo sliding, flashing or smooth fills.
Animate in combatLets 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.

The style editor with its preview.
  1. Pick a starting point

    Click a preset at the top (or one of your saved styles).

  2. Change what you like

    The preview follows every change. Tick In combat (live) to see how the bars look during a fight.

  3. 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

PartOptions
FillColor 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.
BackgroundShow the empty track behind each bar, its color (bar color, theme or one color), opacity and texture.
Border and shadowBorder size and color, square, rounded or pill corners, drop shadow or glow.
IconClass, 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.
MarksCrown 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.
TextFont, 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.
AnimationSmooth 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}).

TokenShows
{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

SettingChoices
Number styleShort (1.2M, the default), Full (1,234,567) or Thousands (1234k).
Decimals0 to 2 decimals on short numbers: 1M, 1.2M or 1.23M.
Per-second decimalsAdvanced: decimals on DPS and HPS.
Thousands separatorComma, 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.
Settings › Bars › Text.
Settings › Fonts & textures.

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.

Extras

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.

The group (left) and the same fight in personal mode (right).
  1. 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).

  2. Fight

    Your spells fill in live (LIVE). After combat they get their percentages and sort by amount (FINAL).

  3. 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.

Top 3 and you.
One line: your rank.

Drag it to move it; right-click it for its options.

SettingDefaultWhat it does
HUD showsTop 3 and youThe top 3 with bars, or one line with your rank and number.
HUD ranks byDPSAny meter except Deaths.
Lock the HUDOffStops it from moving and lets clicks pass through it.
This pull vs your bestOnAfter a boss fight, a line under the HUD compares you with your best on that boss.
HUD size1Advanced: 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.

The Mythic+ summary after a timed +12.
  • 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.
SettingDefaultWhat it does
Show a summary when a key endsOnThe popup itself.
Banana per rankOnA banana next to each player instead of the rank number.
Gold this run (Peel & Profit)OnWith 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."

Bananas don't judge. Much.
  • 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.

A copy of Classic, ready to edit.
  • 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.
TokenBecomes
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.

Settings › General.

Minimap button

ClickDoes
Left-clickShows or hides the meter windows.
Right-clickOpens 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.

SettingDefaultWhat it does
Data broker feedOnTurns the feed on or off.
Feed showsDPSWhich number: any meter except Deaths.
Settings

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 finds settings by any word.

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.

Editing one window.

Handy buttons

ButtonWhat it does
Changed onlyShows only settings that differ from their defaults, in every section. The sidebar shows how many changed per section.
Simple / AdvancedAdvanced shows fine-tuning settings too.
Reset section, ResetPuts a whole section, or one card, back to defaults (in the scope you're editing).
(i) iconsHover 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.

Settings › Bars with the preview playing a fight.

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 › Profiles.

Settings are...

ChoiceWhat happens
Shared by all charactersEvery character uses the Default profile (the default).
Per characterThis 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 handChoose 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

SettingDefaultWhat it does
Refresh modeOn update, at most every N secondsRedraw on Blizzard's updates, on a timer, or on updates but at most once per interval.
Refresh interval0.25 sShortest time between two redraws in combat. Below 0.2 s you get a warning: it costs frame rate in big groups.
Out of combatOnly when something changesOr every 1, 2 or 5 seconds.
Pause hidden windowsOnWindows 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.

Settings › Data & refresh.
Settings › Performance.

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.

Reference

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.

/pm help

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

CommandWhat 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

CommandWhat 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

CommandWhat 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 thisOnWhat happens
DragTitle barMoves the window (and its group).
Shift + dragTitle barMoves just this window and takes it out of its group.
ClickMeter nameOpens the meter picker.
ClickFight nameOpens the fight picker.
Right-clickTitle barOpens the window menu (so does the gear).
Mouse wheelTitle bar or tabsSwitches tabs, when the window has some.
DragBottom right cornerResizes the window.

Bars

Do thisWhat happens
Point at a barHover details (or only while holding a modifier, if you set it so).
ClickOpens that player's breakdown (or Shift + click, if you set it so).
Right-clickThe window menu with that player's breakdown, a breakdown in a new window and Compare with me.
Mouse wheelScrolls 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

WhereClickRight-click
Minimap buttonShows or hides the windowsSettings
Data Broker feedDetails windowSettings
Top 3 HUDDrag to moveIts options
Fight summary toastDetails 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.

Help

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.

Where the numbers come from

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.

In game, every Retail meter reads Blizzard's meter data. The combat log file is only readable outside the game.

What you can see, and when

In combatAfter combatDesktop app
Damage, healing, absorbs, DPS and HPSYesYesYes
Interrupts and dispelsYesYesYes
Deaths, with Blizzard's death recapYesYesYes
Your own spellsYesYesYes
Other players' spellsAfter combatYesYes
Percent, sorting, your own per-second mathAfter combatYesYes
Stops by stuns and knockbacksNoNoEstimated
Overhealing, crits, buff uptime, crowd controlNoNoYes
  • 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 differsIn Peelometer
Per secondBlizzard's value (each player's active time) by default. Fight length or time alive can be picked in Settings › Data & refresh › Calculation.
PercentShare of the group total by default, or compared to the top player.
PetsMerged into their owner by default, or their own rows.
Which fightCurrent, Overall, a saved fight, or a whole run. Trash between bosses is merged by default.
Who is listedHelpers 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.

The same explanation in game: Settings›Help.

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.

A Peelometer fight in 1svc Addon Utils.

What the app adds

FeatureWhat it does
Saved fightsEvery fight Peelometer saved, with filters by instance, boss, date and character. Export as CSV or JSON.
Compare and trendsPull 3 against pull 7, and your DPS on a boss over weeks.
From the combat logOverhealing, crits, buff uptime and crowd control, matched to the same fights.
Stops by stuns and knockbacksA best guess from the log, labeled estimated, with each stop listed so you can check it.
Second-screen meterA 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 /combatlog is 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.

Settings › 1svc Addon Utils.

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

  1. Type /pm bug (or /pm feature for an idea)

    A small form opens. It's also in Settings › Help › Feedback.

  2. Give it a title and say what happened

    Steps to make it happen help a lot.

  3. Save it, or copy a link

    Save for Addon Utils saves it in game. After /reload or 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.

/pm bug

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

  1. Type /pm tester

    Tester mode turns on and the checklist opens. opens it again later; it's also in Settings›Help›Tester mode.

  2. Try an item and mark it

    Each item says what to do and what should happen. Mark it Works, Broken or Skip.

  3. Export

    Click Export and paste the text into a bug report on the website.

The tester checklist.

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.

Fan-made and not affiliated with or endorsed by Blizzard Entertainment. World of Warcraft and Warcraft are trademarks or registered trademarks of Blizzard Entertainment, Inc.