Options: Monitoring - HearthStats/HearthStats.net-Uploader GitHub Wiki

The HearthStats.net Uploader currently has two monitoring options:

• Screen Analysis
• Screen Analysis + Log Monitoring

Screen Analysis is the default. You can change this setting on the Options tab of the uploader.

Screen Analysis

This is the original monitoring method for the HearthStats.net Uploader. It works by taking a screenshot of Hearthstone a few times a second, analysing each screenshot to work out what is happening in the game.

The reliability of screen analysis is good, but not yet perfect. It's still being worked on an improved, so see the Development Status page for where this is up to now.

Screen Analysis + Log Monitoring

This is a new monitoring method which is currently experimental. Inspired by this Reddit post from Flipperbw, it analyses a log file generated by Hearthstone itself. That log contains extra information about what happens during the match such as which cards are played, and when minions die. We can't get that information from screen analysis at the moment, so in this mode we combine data from the Hearthstone log with the screen analysis to capture that extra detail about the match.

Note that the log monitoring does not show you any information about the game that isn't already shown in Hearthstone, so it doesn't give you any advantage or let you cheat. What it does do is help you record what happened during a match so that you can review it afterwards.

Be aware that the Hearthstone log is undocumented, so we're guessing at how to interpret it. Though we think it generally displays accurate information about the game, there are probably some situations which the uploader doesn't understand and so won't be displayed properly... especially with the more unusual abilities of some Legendary cards. Also note that Blizzard may well change the log output in future patches, which might make it easier, harder or even impossible to use for analysis. For all those reasons, the log analysis is still experimental.

Enabling logging in Hearthstone

When you choose the Screen Analysis + Log Monitoring monitoring method, the HearthStats.net Uploader will create a log.config file for you automatically in this location:

• Windows: ~\AppData\Local\Blizzard\Hearthstone
• Mac OS X: ~/Library/Preferences/Blizzard/Hearthstone

(where ~ is your user's home folder)

This config file instructs Hearthstone to write to a log file while it is running. It doesn't log very much, and doesn't seem to have any impact on gameplay or performance. But if you want to stop the logging then you can safely delete the log.config file.