Scarlet Sign in

Scarlet records what you do in WoW Forever and keeps it on your PC

The addon writes a timestamped line for each thing that happens: a step, a cast, a kill, a death, a coin looted. The desktop app reads those lines and draws your character's overview, timeline, maps, charts and loot tables. Uploading to the website is optional and off until you turn it on.

Demo session of 19 Nov 2026, 19:02 to 19:40. The character and places are invented.

  • kill
  • death
  • quest turned in
  • new level
  • flight path
  • ghost run
scarlet.txt19:26:03.42

    Scarlet writes 252 kinds of event lines

    Every line has a time to the hundredth of a second, a code and its fields. These codes are the whole format. Pick one to read what it records.

    K

    A mob died to your group, and whether you landed the killing blow.

    Combat

    What Scarlet never records

    Scarlet does not store free text. Where a window holds someone's words, it keeps a count, a name or a price instead.

    Not recordedKept instead
    Chat text and whispersMessage and word counts per channel.
    Mail subjects and bodiesWho sent or received it, the money and the items.
    Auction notification textThe item, the count and the price.
    The text of UI errorsThe error's name and how often it appeared.
    Support ticket and report text, and who a report was aboutThat a report was sent, and its type.
    Guild notes, the message of the day and rank namesYour rank number, and whether you are an officer or the leader.
    Calendar titles, friend notes and group finder commentsCounts: invites waiting, list sizes, listings found.
    Other players' GUIDs, account names and account friend tagsCharacter names only: players you group, trade, mail or roll against, players you inspect and the gear they wear, players a /who search lists, other rows of a battleground scoreboard, and the character a hardcore death notice names.
    ScreenshotsThe file name and the time. Scarlet takes none and never reads one.

    Your own chat is kept as counts too. Scarlet counts each lol and rip you type and stores the number, not the sentence.

    The capture map: 789 of 4,132 client data points are recorded

    The capture map lists every function and event the WoW Forever client documents, build 1.60.1.70959, and the globals its own interface calls that the documentation leaves out, sorted by what they are about. A data point is an event, or a function that returns a value. Interface plumbing such as frames, settings and sound is listed on the map and not counted here.

    4,132
    data points in the capture map
    3,343
    left out, each with a written reason
    789
    recorded by Scarlet

    recordedleft out, with a reason

    The desktop app draws the log as a timeline, a heatmap, maps and loot tables

    The app has eight views: Overview, Activity, Timeline, Sessions, Map, Charts, Compress and Settings. The figures here are drawn from the demo session and the demo character on this site.

    Timeline: the state you were in at each moment

    Each event is exported with the tags that were on when it happened, so a kill can be read as mounted or on foot, solo or grouped, in a dungeon or outside.

    Activity: play time by day

    0over 4h

    Loot: drop rates and who looted what

    tables/drops.csv
    CreatureItemLoot ruleLootedDropsRate
    Reed StalkerStalker Hidesolo21213162%
    Reed StalkerCracked Fangsolo2128842%
    Fellcrag MaulerThick Bear Peltgroup loot, 2 players642133%
    Fellcrag MaulerMauler's Claspgroup loot, 2 players6435%
    Old RimeclawRimeclaw Talongroup loot, 2 players22100%
    tables/attribution.csv
    CharacterItemsUncommonRareEpicRolls wonLostPassed
    Maren-Ashlow1,904212191312214
    Tovin-Greywake412587024279
    Isolde-Fennmoor187314112106
    A rate is drops per corpse you looted, split by the loot rule in force. Group members' items are read from the client's loot messages; the message text is not stored.

    The log is plain files on your PC

    1. The addon writes compressed chunks

      In game, lines collect in a buffer and are sealed into compressed chunks in the addon's SavedVariables file. The game rewrites that file on /reload, logout or disconnect.

    2. The companion exports them

      scarlet export reads every account folder and writes a readable scarlet.txt, compressed payloads and CSV tables under out/Name-Surname/.

    3. The app reads the folder

      The desktop app opens out/ and can run the export itself. It keeps its settings next to the exe.

    • out/

      • Maren-Ashlow/

        • scarlet.txtevery event, one readable line each

        • payloads/

          • 412-431.sclone export run, compressed

        • tables/

          • events.csvevery event with its place and tags

          • sessions.csvstart, end, class and levels

          • names.csvids to names

          • stats.csvcharacter stats over time

          • statistics.csvthe client's Statistics panel

          • drops.csvdrop rates per creature and loot rule

          • attribution.csvwho looted what

    • The addon keeps up to 8 MB of chunks and warns in chat at 6 MB. Past that it drops the oldest, so the companion tracks which chunks it has already exported.
    • Lines not yet sealed are saved with the file on reload, logout or disconnect, and sealed at the next login.
    • A client crash writes no SavedVariables. Lines since the last save are lost.
    • A field the client marks secret is written as ?.

    The demo character Maren Ashlow has 96 hours of play on record

    The overview shows experience by level and source, gold, dungeon runs, deaths and every session, all drawn from invented data.