1svc Addon Utils

1svc Addon Utils is a free companion app for Mac and Windows that works next to the wow.1svc.io addons. Addons can't go online or show anything outside the game, so the app does those jobs for them.

It works with Peel & Profit and Peelometer. What it does:

Download the app from the 1svc Addon Utils page. There's a .dmg for Mac (Apple silicon and Intel) and an installer for Windows.

Mac

1. Open the downloaded .dmg file

2. Drag 1svc Addon Utils into Applications

3. Open it from Applications

   The Mac app is signed and checked by Apple. The first time, macOS asks if you're sure because it came from the internet: click Open.

Windows

1. Run the installer

2. If Windows protected your PC shows, click More info

   The Windows app isn't signed yet, so Microsoft Defender SmartScreen warns you once for each new version.

3. Click Run anyway and finish the install as usual

Installing a newer version

Download the new version and install it over the old one (on Mac, replace the app in Applications). Your settings, backups, sign-in and the fights read from your combat log are kept: they live in the app's own folder, not in the app. See Updates.

The first time you open the app, a short setup walks you through four steps. You can change all of it later in Settings.

1. Find World of Warcraft

The app reads your addons' saved files from the game folder, and installs addon updates there. It usually finds the game on its own and says Found it automatically. If it can't, click Choose folder and pick your World of Warcraft folder (the one with _retail_ in it).

2. Sign in to wow.1svc.io

Optional. You only need it to send the bug reports and ideas you write in game. Click Sign in with your browser, or Skip for now and do it later. How it works: Sign in and connected devices.

3. How the app runs

Choose whether the app starts with your computer, what the window's close button does, and (Mac) whether it keeps its Dock icon or (Windows) whether minimizing hides it to the tray. The defaults suit most people. Details: Running in the background.

4. Keep your addons up to date

Update my addons automatically is on by default: while the app runs, it installs new versions of your wow.1svc.io addons (waiting for the game to close). The app updates itself either way. Details: Updates.

Click Done and the app opens on Home.

Signing in connects the app to your wow.1svc.io account, so it can send the reports you write in game. Everything else in the app works without it.

Sign in

1. Click Sign in with your browser

   It's on Home, in Settings, on Reports and in the setup dialog. The app shows Waiting for your browser... with a Cancel button.

2. Sign in on wow.1svc.io

   Your browser opens wow.1svc.io. Sign in with Google or Battle.net: the same account you use for the report form on the website.

3. Click Connect

   The page asks Connect 1svc Addon Utils on your computer's name. After you click Connect, the browser hands the sign-in back to the app and you can close the tab.

4. Done

   The app shows Signed in as your name, the provider and this computer's name. You only do this once per computer.

What the app can do with it

• It can send bug reports and ideas as you, from your addons. Nothing else: it can't see or change anything on your account.
• Reports from the app follow the same rules and limits as the website form.
• The sign-in is kept by your system (Keychain on Mac, Credential Manager on Windows), not in a file. It lasts a year; if the app asks, sign in again.

Connected devices

The Connected devices list on the 1svc Addon Utils page shows every computer where the app is signed in to your account, with when it was connected and last used. Click Remove to sign the app out on that computer. Reports it already sent stay sent.

Sign out

In the app: Settings > wow.1svc.io sign-in > Sign out. This also removes the computer from your Connected devices.

The app can keep working with its window closed. While it runs, its icon is always in the menu bar (Mac) or the tray by the clock (Windows).

Click the icon on Mac for Open 1svc Addon Utils and Quit. On Windows, click it to open the window, or right-click it for the same menu.

What the close button doesAdded in 0.2.0

Settings > App > When I close the window:

The prompt offers Quit, Minimize and Run in Background. Tick Remember my choice to save it as your setting. Escape closes the prompt and keeps the window open.

Start with my computer

Off by default. Turn it on in Settings > App and the app starts hidden in the menu bar or tray when you log in to your computer, ready for your next play session. On Mac it shows as 1svc Addon Utils in System Settings > General > Login Items.

Dock and tray options

• Keep in Dock (Mac, on by default): keeps the Dock icon while the window is closed. Off: only the menu bar icon.
• Minimize to system tray (Windows, off by default): the minimize button hides the window to the tray instead of the taskbar.

Quit the app

Click the menu bar or tray icon and choose Quit. Opening the app again while it already runs just brings its window back.

Home is the first screen. It shows at a glance whether everything is connected, and what's waiting for you.

The sidebar on the left gets you everywhere. App-wide pages are at the top, then one section per addon, and Settings at the bottom.

App pages

• Home: the overview.
• Reports: the number next to it counts reports waiting to send.
• Backups: copies of every addon's saved file.

Addon sections

Each addon has its own section with its logo and name, its pages, and its own Settings last:

• Peel & Profit: Your data, Tester, Settings.
• Peelometer: Overview, Fights, Compare pulls, Trends, Live, Settings.

Don't use an addon? Hide its section: turn off In sidebar in Settings > Addons, or Show in the sidebar on the addon's Settings page. Its backups keep working.

Bottom of the sidebar

• The update notice, while a new version downloads and when it is ready to install. A dot next to an addon's name means an addon update is waiting.
• Settings: the app's settings.
• WoW account: a picker that shows when you have more than one WoW account. Your data, fights and backups follow the account picked here; Reports lists every account.
• Game running or Game closed, with a green or grey dot.

The app needs to know where World of Warcraft is installed. It usually finds it on its own.

Where the app looks

Pick another folder

Settings > World of Warcraft > Choose folder. Pick the World of Warcraft folder (the one with _retail_ in it); picking the _retail_ folder itself works too. Find automatically goes back to the usual places.

Game versions

If you have more than one installed, Game version buttons show under the folder: Retail, PTR, PTR 2 and Beta. The app shows the data, backups and combat logs of the version you pick.

WoW accounts

Every WoW account on this computer has its own saved files. With more than one, a WoW account picker shows at the bottom of the sidebar. Reports from every account show up in Reports.

Addons keep their data in the game's memory while you play. The game writes it to disk only when you /reload, log out or exit. That's when the app sees it.

The app watches those files. A second or two after the game finishes writing, its pages refresh, new reports show up and a backup is made. Pages that show saved data say when it's from, for example As of the game's last save (5 min ago).

The combat log is different: the game writes it while you play (if combat logging is on), so fights from the log and the live meter show up during play, without a reload.

Peel & Profit > Your data shows the gold the addon tracks, on a bigger screen. It's read-only: everything stays on this computer, and you change things in game.

Totals

Gold over time

Your total gold per day: each character's last known gold, carried forward, plus the Warband bank. Switch the range with 30D, 90D, 1Y or All. The range it opens on is a setting.

Characters and goals

• Characters: each character's level, class, when you last played it and its gold, richest first.
• Characters marked hidden were hidden in game; not counted ones were left out in the app's settings. Both are left out of the totals.
• Goals: how far along each open goal is. Add goals in game on the Goals tab.

Recent transactions

The newest 60 money changes: when, which character, the category (auction sale, vendor, repairs, mail and so on), the detail and the amount.

Peel & Profit > Settings changes how the app shows your gold. It doesn't touch the addon: its own settings are in game (/gt).

Characters counted in totals

Untick a character to leave it out of Total gold and the chart, for example a bank alt you share. Characters hidden in game are always left out and greyed out here. On Your data, left-out characters show as not counted.

Gold over time opens on

The range the gold chart starts with. You can still switch it on Your data.

The same page also has the settings every addon has: see Addon settings.

Peelometer's section in the sidebar turns the fights the addon saves into pages you can search, compare and export. Overview is the summary.

The tiles count the fights saved, boss kills, fights read from the combat log and your favorites (mark a fight as a favorite in game). Below are the newest fights: click one to open it (see One fight). For the full list, open Fights.

Where fights come from

The app joins two sources. Each fight in the list says which it has:

When both have the same fight, the app matches them by start time and boss, and shows them as one.

Peelometer > Fights lists every fight, newest first. Click a row (or Tab to it and press Enter) to open the fight.

Each row shows when, the fight and where it was, the result (kill, wipe, Mythic+ level), length, your DPS, group DPS, deaths, and whether it came from the saved history, the combat log, or both. A star marks a favorite.

Search and filters

The list shows the newest 500 matching fights. Narrow the filters to reach older ones.

Export to CSV or JSON

Export CSV and Export JSON (top right) save the fights the filters show to a file you pick. CSV opens in any spreadsheet: one row per fight with date, fight, instance, difficulty, key level, pull, result, length, character, your DPS, group DPS, deaths, interrupts, and the overhealing and interrupts via CC from the log. JSON has everything, including the addon's full saved fight.

A fight's page shows who did what, spell by spell. Open it from Fights, Recent fights on the Overview, Compare pulls or Trends.

At the top

The fight's name and result, when and where, length and group size. Badges say whether it has Saved history and a Combat log. Tiles show group DPS and HPS, your DPS and rank, deaths, interrupts, and interrupts via CC (estimated from the log).

Tabs

• From the game: the meters the addon saved, such as damage, healing and interrupts, plus Deaths.
• From the combat log: Overhealing, Crits, Uptime, CC done and Interrupts via CC. See What the combat log adds.

Click a player to see their spells on the right: amount, share and per second, with overkill and the target where known. Spells you could have dodged are marked avoidable or deadly.

A fight that's only in the combat log (for example, Peelometer was off) gets Damage, Healing, Absorbs, Interrupts and Deaths tabs read from the log instead.

Deaths

Who died and when, the killing blow and the overkill. Click a death to see the last hits before it (from the combat log). Without a log, the killing blow comes from the game's death recap.

Buttons

• Compare pulls (boss fights): opens Compare pulls for this boss.
• Export CSV and JSON: this fight only, with the combat log numbers.
• < All fights or Esc goes back to the list.

Peelometer > Compare pulls puts pulls of the same boss next to each other, so you can see what changed between a wipe and the kill.

Pick the pulls

1. Choose the Boss. The menu shows how many pulls each has, most recent boss first.
2. Choose the Night: one raid night or dungeon session. A night runs until 6 in the morning, so a late raid stays together.
3. Tick pulls in the Pulls list, up to 8. The last three of the night are picked to start with.

You can also get here from a boss fight's page with its Compare pulls button.

Group DPS over the fight

One line per picked pull, in 5-second steps, so you can see where a pull fell behind: a slow opener, a death, a long phase. This chart needs the combat log for those pulls.

Side by side

A table with a column per pull: result, length, group and your DPS, group HPS, deaths and the first death, interrupts, interrupts via CC, overhealing and avoidable damage. The best value in a row is green, the worst red. Open pull links take you to each fight.

Peelometer > Trends charts your DPS on one boss, fight by fight, over the weeks. Are you getting better?

Choose what to chart

The numbers

• Personal best and Last fight, with their dates.
• Average (last 4): your DPS averaged over your last four fights, which smooths out one lucky or unlucky pull.
• Change vs 4 fights ago: up or down compared with that average four fights back.

Personal bests

Every boss with your best DPS, where and on which date, how much better it was than your average, and how many kills. Click a boss to chart it; click the date to open that fight.

The game hides some things from addons, such as overhealing and enemy casts. It does write them to its combat log file. The app reads that file, so you get numbers no in-game meter can show.

How interrupts via CC are estimated

The game only counts kicks as interrupts. When an enemy starts a cast, a player's stun, incapacitate, silence or knockback lands on it, and the cast never finishes (within about 8 seconds, or the enemy dies or starts something else), the app counts a stop and credits the first crowd control. It's a good estimate, not an exact count.

How the log is split into fights

A boss fight runs from the pull to the end of the encounter. Other fights start when your group and enemies hit each other, and end after 6 seconds without that. A zone change, the end of a Mythic+ run or an arena match also ends a fight.

The game only writes a combat log when you ask it to. Turn it on in game, and turn on Advanced Combat Logging for the most accurate numbers.

Quick: /combatlog

Type /combatlog in chat to start logging, and again to stop. The game writes a WoWCombatLog file in its Logs folder.

Automatic: let Peelometer do it

1. Type /pm and open the 1svc Addon Utils section

2. Turn on combat logging automatically

   Pick where: In raids, In Mythic+, In other dungeons, In PvP or Everywhere (the biggest files).

3. Keep the helpers on

   Turn it off again when I leave, Turn on advanced combat logging too and Remind me on a boss pull if logging is off. Save extra info for the companion app helps the app match log files to your saved fights.

More about these options in the Peelometer wiki.

Advanced Combat Logging

In the game's Options > System > Network, tick Advanced Combat Logging (or let Peelometer do it, above). It adds details to each line that the app needs for pets and the most accurate numbers. Warcraft Logs asks for it too.

Check it in the app

Peelometer > Settings > Combat log shows what the app sees:

• Read the combat log while I play: on by default. The app follows the newest log file while it runs.
• Reading: the file it follows. Advanced logging says Off in red if you should turn it on.
• Fights read so far, and a button to open the live meter.

Peelometer > Live is a meter for a second screen. It reads the combat log as you play, a second or two behind the game.

What it shows

Pick Damage, Healing, Overheal, Interrupts or CC stops. The meter shows the current fight, and the last one between pulls.

Pop-out window

Pop out window opens the meter in its own small window. Drag it to your second screen, or over a corner of the game. Pop-out window stays on top (on by default) keeps it above WoW when you play in windowed mode.

Display and status

The Combat log card shows the file being read, its size, whether Advanced logging is on, when the last line came in, and how far behind the game it is.

Combat logs get big fast. Peelometer > Settings > Log files shows how much space they take and lets you tidy up. The app always asks first, and never touches the log the game is writing.

Compress or delete old logs

• Old means older than: which logs count as old (7, 14, 30 or 90 days).
• Warn above: a red warning when all logs together pass this size.
• Compress old logs: each becomes a .gz file, usually about a tenth of the size. The app can still read them, and you can unzip them for Warcraft Logs.
• Delete old logs: removes them for good. Fights already read keep their numbers in the app, but Warcraft Logs can't upload them afterwards.

Each file in the list also has its own Delete. The file the game is writing is marked game is writing and can't be deleted.

Read fights from an old log

The app reads the log while it runs. For fights from before (the app was closed, or a log from another computer in the Logs folder), click Read fights next to the file. A progress line shows how far it is.

Fights read from logs

The app keeps what it read in its own folder, so the detail stays after you delete a log. Keep the newest sets how many (500 by default). Forget fights read from logs clears them; your log files and Peelometer's saved history stay.

Export every fight

The Export card saves every fight on this account, saved history and combat log numbers together, as CSV or JSON.

All Peelometer settings in the app

Found a bug or have an idea? Write it in game. Addons can't go online, so the report waits in the addon's saved file. After /reload or logout it shows up in the app, where you check it and send it to wow.1svc.io.

Send a report

1. Write it in game

   Peel & Profit: /gt bug or /gt feature. Peelometer: /pm bug or /pm feature. Fill in the form, tick any Lua errors or test report to attach, and click Save for Addon Utils.

2. Type /reload or log out

   The game saves the report with the addon's data. The app sees it a moment later: the Reports count in the sidebar goes up.

3. Check it in Reports

   Click a report to see exactly what will be sent. To change it, edit it in game and /reload.

4. Click Send, or Send all

   You need to be signed in. Each report gets a number on wow.1svc.io and shows Sent with it.

What's in a report

What you typed, the addon and WoW versions, your game language, and any Lua errors, checklist item or test report you attached. Never your character, realm or guild names.

After sending

• A report is never sent twice, even if it's still in the game's outbox or you send from another computer.
• Sent reports stay in game until you delete them: /gt outbox in Peel & Profit, Clear in the /pm bug form in Peelometer. Reports older than 30 days are deleted in game on their own.
• Sent earlier at the bottom of Reports lists what you sent before, with its number.

If sending fails

Testing a beta? Peel & Profit > Tester shows your feature checklist, the Lua errors the addon caught and its recent activity, outside the game.

Turn on tester mode in game with /gt tester, then /reload. The page fills in as the game saves.

Feature checklist

Every item with its status: Works, Broken, Skipped, Other or Not tried. Filter with All, Not tried, Broken or Notes & errors. Badges mark items you added (yours), items new or changed in a version, notes and errors. Click an item to see what to expect, your note and its errors.

You set the status in game. The item text comes from the installed addon, so it always matches your version.

Caught Lua errors and activity

• Caught Lua errors: each error from the addon, how often and when it last happened, and the version. Copy copies it with the stack.
• Recent activity: what the addon logged, newest first.

Every time the game saves an addon's data, the app keeps a dated copy. If something goes wrong, you can put it back.

When copies are made

• Each time the game writes an addon's saved file (on /reload, logout and exit) while the app is running.
• Only when something changed: the same file isn't copied twice.
• Back up now makes a copy right away (or says Nothing changed since the last backup).
• Before every restore, so a restore can be undone.

How many are kept

The newest 20, plus the newest copy of each week for 12 weeks. Change the 20 (5, 10, 20 or 50) with Copies to keep on the addon's Settings page, or turn off Back up automatically there. See Addon settings.

Where they're kept

In the app's own folder, by game version, WoW account and addon. Open folder on the Backups page opens it. Each backup is a copy of the addon's .lua file named after the time it was made.

Restoring puts an addon's saved data back the way it was at that backup. Close the game first.

1. Close World of Warcraft completely

   The game rewrites the addon's file when it exits, which would undo the restore. While it runs, Restore is greyed out and the page says so.

2. Open Backups and find the addon

   Check the WoW account at the bottom of the sidebar.

3. Click Restore next to the date you want

   The app asks Restore this backup? and says what will happen.

4. Click Restore, then start the game

Changed your mind?

Anything recorded after that backup is replaced, but the app backs up the current file first. To undo, restore the newest copy (marked latest).

Settings at the bottom of the sidebar holds the app's own settings. Each addon also has its own Settings page in its section: see Addon settings.

What's on the page

• World of Warcraft: the game folder and game version. See WoW folder.
• wow.1svc.io sign-in: sign in or out. See Sign in.
• App: start with your computer, the close button, Dock or tray, and Run setup again. See Running in the background.
• Addons: every addon, its version and whether backups are on, a switch to show it in the sidebar, and a button to its settings.
• Updates: your version, Check for updates (the app and your addons) and Restart to update. See Updates.
• Advanced: the website address, for testing only. The bottom line shows the app's version and its data folder.

Every setting

Each addon's section in the sidebar ends with its own Settings page. These change how the app handles that addon; the addon's in-game settings stay in game.

Addon

• The installed version and the newest one on wow.1svc.io, the saved file's size and when the game last saved it, and the in-game command for the addon's own settings.
• Install, Update or Go back to the previous version, and What's new. See Updates.
• Update automatically: install new versions while the app runs (waits for the game to close). On by default.
• Show saved file in Finder (Mac) or Explorer (Windows) opens the game folder at the addon's file.
• Show in the sidebar: hide the addon's section if you don't use it.

Backups

• Back up automatically: a copy each time the game writes the addon's file. On by default.
• Copies to keep: 5, 10, 20 or 50 newest copies, plus one a week for 12 weeks.

All addons in one place

Settings > Addons lists every addon with its version and update status, an Install or Update button when there's one to do, an In sidebar switch and a button to its Settings page.

Reference

More on the extras: Peel & Profit settings, Peelometer log files and the live meter.

The app keeps itself and your wow.1svc.io addons up to date. It checks when it starts and every few hours while it runs, and installs new versions without a trip to the website.

The app

1. When a new version is out, the app downloads it in the background. You get a notification and a notice at the bottom of the sidebar.
2. Click Restart to update, or keep going: it installs when the app quits. Your settings, backups and sign-in stay.

Closing the notice hides it; the update still installs later. Settings > Updates > Check for updates checks the app and your addons right away. Versions before 0.3.0 can't update themselves: install 0.3.0 from the download page once.

Your addons

• With Update automatically on (the default; each addon's Settings page has the switch), the app installs a new version as soon as it's out, while the app is running.
• While World of Warcraft is open, the update downloads and waits: it installs as soon as you close the game. Install now installs it right away; then restart the game (a /reload isn't enough, the game reads addon files when it starts).
• Addons you don't have yet show an Install button on Home and in Settings > Addons. They go in the Retail AddOns folder.
• A dot next to an addon's name in the sidebar means an update is waiting.

What's new

After an update, Home says which version you have now. What's new shows the release notes since your old version. Each addon's Settings page has the same button.

Go back to the previous version

Before it replaces an addon, the app keeps the old copy. If an update causes trouble, open the addon's Settings page and click Go back to (the old version). Automatic updates then skip the version you left until a newer one is out. Saved data isn't touched either way; for that, see Backups.

Copies the app can't read a version from (for example one you copied in by hand) show as Dev copy and are never updated automatically. Replace with installs the release over it.

Latest version

The newest version of the app is 0.3.1 (November 7, 2026). What changed: What's new on the app page. Your version is at the bottom of Settings.

The app works on your computer. The only things it sends are the reports you choose to send, your sign-in, and update checks.

What it reads

• The saved files of the addons it supports, in WTF/Account/<account>/SavedVariables. It reads them as data and never runs them.
• The installed addon's own files, for the tester checklist text.
• The combat log files in the game's Logs folder, if Read the combat log while I play is on.
• Whether the game is running.

What it changes

Nothing in the game folder, unless you ask: restoring a backup rewrites that addon's file, and compressing or deleting old logs changes the Logs folder. Everything else (settings, backups, fights read from the log, exports you save) goes in the app's own folder or where you pick.

What it sends to wow.1svc.io

• Reports, when you click Send: what you typed, the addon and WoW versions, game language, and the errors or test report you attached. No character, realm or guild names.
• Sign-in: once, in your browser, with your computer's name so you can recognise it in Connected devices.
• Update checks: ask for the newest app and addon versions, and download them. No sign-in needed.

Most problems come down to the game not having saved yet, the wrong folder or account, or combat logging being off.

World of Warcraft wasn't found

Settings > World of Warcraft > Choose folder, and pick the folder with _retail_ in it. See WoW folder.

My report doesn't show up in Reports

• Did you click Save for Addon Utils in the form, then /reload or log out? The game only saves then.
• Is the app pointed at the right game version (Retail, PTR, Beta) in Settings?
• Is the app running? It needs to be open (or in the menu bar or tray) to notice the change. Opening it later works too.

Send is greyed out, or sending fails

Send needs you to be signed in. If a report shows an error, the end of the message says what to do: see If sending fails. Reports wait safely until they're sent.

My gold or fights look out of date

The app shows the game's last save. Type /reload in game and the app updates a moment later. Also check the WoW account picker at the bottom of the sidebar.

No combat log numbers

• Turn on combat logging in game: Turn on combat logging.
• Check Peelometer > Settings > Combat log: Read the combat log while I play on, a file under Reading, and Advanced logging On.
• The app has to run while you play. For fights from before, use Read fights on the log file (how).

Restore is greyed out

The game is still running (the sidebar says Game running). Quit World of Warcraft completely, then try again. See Restore a backup.

I closed the window and the app is still running

That's Run in the background. Click the icon in the menu bar or tray to bring it back, or choose Quit there. Change it in Settings > App (how).

Couldn't read the saved file

The addon's file is damaged or only half written. /reload in game to write it again. If the addon lost data, close the game and restore a backup.

Sign-in doesn't finish

Keep the app open while you sign in in the browser. If the page says the link isn't valid, or nothing happens after Connect, click Sign in with your browser in the app again for a fresh link.

Quick answers. Click a question to open it.

Removing the app doesn't touch your addons or their data in the game folder.

Mac

1. Quit the app

   Click its menu bar icon, then Quit.

2. Drag 1svc Addon Utils from Applications to the Trash

3. Optional: remove what it saved

   Delete ~/Library/Application Support/io.1svc.companion (settings, backups and fights read from the log). In Keychain Access, delete the entries named io.1svc.companion.

Windows

1. Quit the app

   Right-click its tray icon, then Quit.

2. Uninstall it

   Settings > Apps > Installed apps > 1svc Addon Utils > Uninstall.

3. Optional: remove what it saved

   Delete %APPDATA%\io.1svc.companion. In Credential Manager (Windows Credentials), remove the entries with io.1svc.companion in their name.

On wow.1svc.io

Remove the computer from Connected devices (or Sign out in the app before uninstalling).