A deck tracker for Hearthstone running under Proton or Wine on Linux. It was developed on Bazzite and should work on any distribution. It reads Hearthstone's own log files and shows your remaining deck, your opponent's cards, Arena draft ratings and detailed stats in a browser window.
- Features
- Requirements
- Installation
- Usage
- How it works
- Limitations
- Troubleshooting
- Reporting bugs
- Development
- Credits
- Disclaimer
- License
- Your deck, live. Cards are crossed off as you draw them, with copies left and the chance to draw each one next. Your deck is detected automatically for Arena, Underground Arena and constructed games, or you can paste a deck code.
- Your opponent's cards. Every card they've played, by turn, with generated cards marked, plus everything revealed from their deck. Their hand and deck sizes are always shown.
- Win chance. During a game, your win rate in earlier games like it: the same matchup and turn order, e.g. Mage vs Rogue on the coin. Until a matchup has 5 games, it falls back to the matchup in either turn order, then your class with that turn order, then all games. Only games of the same game type count, so Underground Arena and normal Arena are kept apart. All four are listed with their records.
- Your opponent's hand. Each card in their hand, in order, with the turn it arrived and how: opening hand, mulligan, drawn, drawn by a card's effect, created by a card, or returned to their hand. Cards you know, such as a minion you bounced, are shown by name.
- Secret helper. While your opponent has a hidden secret, you see every secret it could be. Secrets are crossed off as soon as you do something that would have triggered them and it didn't, e.g. casting a spell rules out Counterspell. Hover over "ruled out" to see why. In Arena, the list is limited to the secrets in HearthArena's tier list for their class.
- Arena draft ratings. HearthArena scores for every pick and for every card in your Arena deck. Cards that came in a legendary's package are tagged with that legendary, since HearthArena rates only the legendary (needs Read draft offers). With memory reading turned on, the three cards you're offered appear automatically with their scores and the best one highlighted. Without it, a quick lookup box shows the score of any card for your class. When choosing a class, each one shows its win rate this patch from Firestone (Arena and Underground Arena separately) and your own average wins per run with it in that mode.
- Statistics. Every game is saved locally. The Stats tab shows:
- a class-vs-class win-rate matrix
- win rates over time, by mode, going first vs. on the coin, by game length and by time of day
- Arena runs, with average wins per class
- win rates per card: when drawn, when in your opening hand, and when played
- Catches up on missed games. Games played while the tracker was off are imported from Hearthstone's logs the next time it starts.
- Desktop app or browser. Use it as an app with its own window and a tray icon, or as a page in any browser, e.g. on a second monitor or your phone.
- Few requirements. The tracker itself uses only Python's standard library. The desktop app also needs PySide6, which Bazzite already includes. That suits immutable systems like Bazzite.
- Doesn't touch the game. By default it only reads log files that Hearthstone writes itself. Nothing is injected and nothing runs inside Proton. The optional memory reading only reads, never writes.
| Arena draft with memory reading | Stats |
|---|---|
 |
 |
The stats screenshot shows sample data.
- Linux with Hearthstone installed through Battle.net under Proton or Wine. This includes a non-Steam game in Steam, Lutris, Bottles and Heroic.
- Python 3.10 or newer. It comes preinstalled on most distributions.
- For the desktop app: PySide6 with QtWebEngine. Bazzite already includes it. Without it, the tracker runs in your web browser instead.
git clone https://github.com/justfaked/hs-decktracker-linux.git
cd hs-decktracker-linux
python3 -m decktracker setupsetup finds your Hearthstone install and turns on the log files the tracker needs, in log.config inside the Wine prefix. Your original file is backed up as log.config.bak.
Restart Hearthstone afterwards. It only reads log.config at startup.
Install the decktracker command, then add it to your app menu. These steps were tested on Bazzite; the ones for other distributions are the usual pipx route but untested.
Bazzite and Fedora: PySide6 comes with the system (on Fedora: sudo dnf install python3-pyside6).
pip install --user .
decktracker setup-desktopOther distributions: install PySide6 from your package manager (e.g. sudo pacman -S pyside6 on Arch), then:
pipx install --system-site-packages .
decktracker setup-desktopIf decktracker isn't found afterwards, make sure ~/.local/bin is on your PATH and open a new terminal.
setup-desktop adds Deck Tracker to your app menu and starts its tray icon when you log in, so games are recorded even when the window is closed.
Use decktracker setup-desktop --no-autostart to skip starting at login, or --remove to undo it.
You can also skip installing: running python3 -m decktracker setup-desktop inside the cloned folder creates a menu entry that runs the app from there.
git pull && pip install --user . # update (pipx: pipx install --force --system-site-packages .)
decktracker setup-desktop --remove && pip uninstall hs-decktracker-linux # uninstallOpen Deck Tracker from your app menu, or run decktracker app.
Closing the window keeps the tracker running in the tray; quit it from the tray menu.
| Tray menu | What it does |
|---|---|
| Open tracker / Stats | Show the window on the Live or Stats tab (left-click on the icon works too) |
| Open in browser | Open the same page in your web browser, e.g. on a second monitor |
| Read draft offers (game memory) | Show the three cards offered in an Arena draft automatically. See below. |
| Always on top | Keep the window above the game. Applies when the app next starts; on KDE you can also right-click the title bar → More Actions → Keep Above Others. |
| Start at login | Start the tray icon when you log in |
The last three are also in the window's Settings menu, which is the only place for them if your desktop has no system tray.
These choices are saved in ~/.config/decktracker/settings.json.
Without PySide6, or if you prefer a browser tab:
./decktracker.shThis starts the tracker and opens http://localhost:8765 in your browser. Keep the terminal open while you play and press Ctrl+C to stop.
| Option | Description |
|---|---|
--hs-dir PATH |
Hearthstone folder, if auto-detection doesn't find it, e.g. ".../drive_c/Program Files (x86)/Hearthstone". Also works with decktracker app. |
--port 8765 |
Port of the web page |
--host 0.0.0.0 |
Make the page reachable from other devices, like a phone or tablet. It has no login, so only use this on a network you trust. |
--locale deDE |
Card language. By default it matches your game client. |
--db PATH |
Use a different history database |
--read-memory |
Show the Arena draft offer automatically by reading it from the game's memory. See below. |
- While drafting in Arena, turn on Read draft offers (or run with
--read-memory) to see the offered cards' ratings automatically, or type part of a card's name into the lookup box. - If your constructed deck isn't detected, open Use a deck code and paste the code from Hearthstone's deck builder.
- To open the Stats tab directly in a browser, use http://localhost:8765/#stats.
Hearthstone can write detailed logs of everything that happens in a game. The tracker follows these files while you play:
| Log | Used for |
|---|---|
Power.log |
Every card, zone change and tag in the game: the game state |
Arena.log |
Arena drafts and your Arena deck |
Decks.log |
The constructed deck you queued with |
The tracker rebuilds the game state from these logs, saves each finished game to a local SQLite database and serves the page from a small local web server.
Hearthstone doesn't write the three cards you're offered during an Arena draft to any log file.
To show them automatically, the tracker can read them from the game's memory while you draft, about twice a second.
Turn on Read draft offers in the app's Settings menu or the tray menu, or start the browser version with ./decktracker.sh --read-memory.
- Read-only. The tracker opens
/proc/<pid>/memfor reading. It never writes to the game, sends inputs or changes anything. - What it reads: the draft screen's current offer, plus your Arena deck with exact copy counts. This also makes Arena deck tracking exact during games. To find these, it looks up class names and Hearthstone's internal service list; it doesn't read your collection, account or anything else.
- Requirements: run the tracker as the same user as the game, directly on the host and not inside a container (for example not in a distrobox).
Your kernel must allow reading another process's memory:
cat /proc/sys/kernel/yama/ptrace_scopemust print0, as it does on Bazzite. - Blizzard's terms: the EULA forbids third-party software that "collects information from" the game. Memory reading is the same technique Hearthstone Deck Tracker and Firestone use for this feature, and Blizzard has tolerated such trackers for years. It only shows what's already on your screen, but it is not explicitly approved by Blizzard. That's why it's off unless you turn it on.
- After Hearthstone updates: if a patch changes the game's internals, the tracker shows "memory not readable" on the draft panel and everything else keeps working.
| What | Where |
|---|---|
| Match history | ~/.local/share/decktracker/history.db |
| App settings | ~/.config/decktracker/settings.json |
| Card data and ratings (refreshed daily) | ~/.cache/decktracker/ |
The tracker only connects to the internet to download card data from HearthstoneJSON, the HearthArena tier list and arena class win rates from Firestone. Card images are loaded by your browser from art.hearthstonejson.com.
Nothing about you or your games is sent anywhere.
- Without
--read-memory, Arena card counts are approximate.Arena.loglists the cards in your Arena deck, but not how many copies of each. The number of cards left in your deck is always exact, and draw chances are based on it. The per-card list gets more accurate as you play, because the tracker learns copy counts from the cards you draw during a run. With--read-memory, the deck is read with exact copy counts whenever the draft screen is open. - Without
--read-memory, the three offered cards aren't shown automatically. They aren't in the logs, so the draft view has a lookup box instead. - Battlegrounds and Mercenaries are detected but not tracked.
- The secret helper only rules out secrets whose trigger it knows. Secrets that trigger under conditions the logs don't show (e.g. Ice Block, Hidden Cache) always stay on the list. In Standard and Wild games, every secret of the class is listed, as the tracker doesn't know which sets are in Standard.
- Hearthstone only keeps the logs of the last ~6 sessions. Start the tracker regularly, or games older than that can't be imported.
"Could not find a Hearthstone install"
Pass the path to the folder that contains Hearthstone.exe:
./decktracker.sh --hs-dir "$HOME/.local/share/Steam/steamapps/compatdata/<id>/pfx/drive_c/Program Files (x86)/Hearthstone""Port 8765 is already in use"
The desktop app is probably already running and using that port. Open it from the tray icon, use Open in browser, or start the browser version with another --port.
The page keeps saying "Waiting for a game"
Make sure you ran python3 -m decktracker setup and restarted Hearthstone afterwards.
The tracker warns at startup if log.config is missing something.
My deck shows as "Unknown deck"
For constructed games the deck comes from Decks.log, which setup enables, so restart Hearthstone after running it.
You can always paste a deck code under Use a deck code.
Found something that's wrong or confusing? Please open an issue on GitHub, even if you're not sure it's a bug. Hearthstone changes with every expansion and new game modes appear, so many problems only show up in real games. Your report is often the only way they get noticed.
These make a bug much easier to find and fix:
- What happened and what you expected, e.g. "after keeping 30 of 35 cards in an Arena redraft, the deck list still showed the old cards".
- The game mode (Arena, Underground Arena, Ranked, …) and roughly when it happened.
- Desktop app or browser version, whether memory reading is on, and the tracker version (
git rev-parse --short HEADin the cloned folder). - Hearthstone's logs from that session. They're in the
Logsfolder next toHearthstone.exe, in a subfolder named after the time the game was started, e.g.Hearthstone_2026_10_03_22_06_25.Arena.logandDecks.logare usually enough for deck problems; for problems during a game, also attachPower.log. The tracker can replay these logs exactly, which is often the fastest way to reproduce a bug. The logs contain your BattleTag and your opponents' names. Remove them first if you don't want them public. - The tracker's output, if it printed a warning or error. Start it from a terminal with
-vfor more detail, e.g.decktracker app -vor./decktracker.sh -v.
python3 -m unittest discover -s tests -t .| Path | Contents |
|---|---|
decktracker/power.py |
Power.log parser that rebuilds the game state |
decktracker/decks.py |
Deck detection from Arena.log / Decks.log |
decktracker/tracker.py |
Combines game state and deck into what the page shows |
decktracker/stats.py |
Statistics over the match history |
decktracker/memory.py, hsmemory.py |
Read-only Mono memory reader and the Arena draft paths |
decktracker/gui.py, desktop.py |
Desktop app (Qt window and tray icon) and app menu integration |
decktracker/web/ |
The browser UI (plain HTML, CSS and JavaScript) |
Pull requests are welcome. For bugs, see Reporting bugs.
- HearthstoneJSON by HearthSim, for card data and card art
- HearthArena, for Arena card ratings
- Firestone, for Arena class win rates
- Firestone's UnitySpy fork (MIT), whose open-source research into Hearthstone's memory layout made
--read-memorypossible - Inspired by Hearthstone Deck Tracker for Windows
This project is not affiliated with or endorsed by Blizzard Entertainment. Hearthstone® is a registered trademark of Blizzard Entertainment, Inc. Card names and images © Blizzard Entertainment.
If this tracker is useful to you, you can support its development:
