The hearthssconsole installation guide from hearthstats explains how to install HearthsConsole for Hearthstone logging. It lists required files, prepares the PC, and shows initial setup steps. The guide keeps steps clear. The reader will follow short commands and simple checks. The guide uses precise terms and avoids fluff. It aims to make logging work quickly and reliably.
Key Takeaways
- The HearthsConsole installation guide from HearthStats requires a Windows 10 or 11 PC with admin access and Hearthstone installed for proper logging setup.
- Users must download the latest HearthsConsole release matching their OS, install .NET 6 if prompted, and keep their HearthStats API key ready for configuration.
- Step-by-step setup includes running HearthsConsole.exe, inputting the API key, setting the Hearthstone log folder, enabling features like deck parsing, and verifying log uploads with a test game.
- The app needs write permissions to the log folder and may require closing overlays or adjusting Hearthstone log settings to avoid missing data.
- Troubleshooting includes checking API key validity, reviewing app error codes, enabling debug logs, and managing antivirus exclusions to prevent logging interruptions.
- Users can enable HearthsConsole to start with Windows via settings and reset configurations by deleting the config file to resolve persistent issues.
What You Need Before Installing HearthsConsole
HearthStats lists the required items for the hearthssconsole installation guide from hearthstats. The user needs a Windows 10 or 11 PC. The user needs admin access to that PC. The user needs Hearthstone installed from Blizzard. The user needs a stable internet connection for downloads and updates.
The user should download the latest HearthsConsole release from the HearthStats site. The release file must match the OS. The user should unzip the release into a new folder. The user should check the folder for the executable named HearthsConsole.exe. The user should install .NET 6 if Windows prompts for it. The user should keep a copy of the HearthStats API key handy. HearthStats provides the API key on the user account page. The user should copy that key to a safe text file.
The user must allow the app to write logs. The user must confirm disk space of at least 200 MB for logs and cache. The user should disable conflicting overlay tools during the initial run. The hearthssconsole installation guide from hearthstats warns that overlays can block log writes. The user should close Hearthstone before starting the install. The user should create a restore point if they want an easy rollback.
Step-By-Step Installation And Initial Setup
Step 1. The user runs the HearthsConsole.exe from the unzipped folder. Step 2. The app asks for permission to run. The user accepts UAC when prompted. Step 3. The app opens a setup window. The window asks for the HearthStats API key. The user pastes the API key into the field. The user clicks Save.
Step 4. The app asks for game log directory. The user selects the default Hearthstone log folder. The path usually shows as C:Users[name]AppDataLocalLowBlizzardHearthstone. The app tests the path. The app shows a green check if the path works. The user clicks Next.
Step 5. The app offers optional features. The user can enable or disable real-time uploading. The user can enable local JSON export. The user can toggle deck parsing. The hearthssconsole installation guide from hearthstats recommends enabling deck parsing for accurate game data.
Step 6. The app sets a schedule for log polling. The user accepts the default 2-second poll or chooses a slower poll to save CPU. The app writes a config file to the HearthsConsole folder. The user can open the config file to confirm settings. The user restarts the app after saving settings.
Step 7. The app runs a test match parser. The app reads a sample log and displays parsed events. The user checks that the parser shows game start and end events. The hearthssconsole installation guide from hearthstats suggests running one quick game to verify uploads. If uploads succeed, HearthStats shows the session on the user dashboard.
Configure Logging, Permissions, And Troubleshooting Tips
The app needs write permission to the log folder. The user grants permission via File Explorer Properties or by running the app as admin. The user should set the folder to allow the user account Modify rights. The hearthssconsole installation guide from hearthstats notes that restricted permissions cause missing entries.
If the app fails to find logs, the user checks the Hearthstone log settings. The user ensures that Hearthstone is set to produce full logs. The user runs Hearthstone in windowed mode if the app still misses events. The user restarts both Hearthstone and HearthsConsole after any change.
If uploads fail, the user checks the API key. The user makes sure the key is active on the HearthStats account. The user checks the app status page for error codes. The app shows HTTP codes for failed uploads. The hearthssconsole installation guide from hearthstats explains common codes: 401 means bad API key, 403 means account limits, and 500 means server error. The user retries after a 5-minute wait for transient 500 errors.
The user can enable debug logs in the app settings. The user opens the debug log file with a text editor. The log shows timestamps and parser steps. The user posts the relevant log lines when asking for support. HearthStats support asks for the last 200 lines of the log and the config file.
If the app freezes, the user checks for antivirus blocks. The user adds the HearthsConsole folder to antivirus exclusions. The hearthssconsole installation guide from hearthstats warns that real-time scanning can delay writes and create parser gaps.
For Windows startup, the user can enable the app to run at login. The user opens the Settings tab and toggles Start with Windows. The app creates a registry key or a Task Scheduler entry. The user may prefer Task Scheduler for stricter control.
If the user needs to reset settings, the user closes the app and deletes the config.json file. The app recreates a default config on restart. The hearthssconsole installation guide from hearthstats recommends keeping a backup of custom configs before replacing them.
If the user still has issues, the user visits the HearthStats support page. The support page lists known issues and fixes. The hearthssconsole installation guide from hearthstats also links to community threads where users share fixes and sample configs.
