Hearthstone Deck Tracker in Linux

hdt_linux.md

Hearthstone Deck Tracker on Linux via Faugus Launcher

The Problem

Hearthstone Deck Tracker (HDT) must run in the same Wine prefix and sandbox as Hearthstone to detect the game. Faugus Launcher isolates each game entry in its own bubblewrap sandbox with its own wineserver, so adding HDT as a separate entry won't work — even if both entries point to the same prefix.

The solution is to use Faugus's Add App feature to launch HDT alongside Battle.net in a single sandbox.

Prerequisites

• Faugus Launcher installed
• Battle.net installed and working through Faugus (with Proton-GE Latest)
• Hearthstone installed and playable via Battle.net
• HDT installer downloaded (HDT-Installer.exe)

Step 1: Install HDT into the Battle.net prefix

In Faugus Launcher, run the HDT installer targeting the battlenet prefix:

• Set the executable path to your downloaded HDT-Installer.exe
• Set the prefix to /home/<user>/Faugus/battlenet
• Set the runner to Proton-GE Latest
• Run it once to install HDT

HDT will be installed to:

~/Faugus/battlenet/drive_c/users/steamuser/AppData/Local/HearthstoneDeckTracker/

Step 2: Create the batch file

Create the file at:

~/Faugus/battlenet/drive_c/Program Files (x86)/Battle.net/faugus-battlenet.bat With the following contents: bat @echo off start "" "C:\users\steamuser\AppData\Local\HearthstoneDeckTracker\app-1.49.15\HearthstoneDeckTracker.exe" "C:\Program Files (x86)\Battle.net\Battle.net.exe"

Note: If HDT updates to a newer version, you'll need to update the version number in the path (e.g., app-1.49.15 → app-1.50.0).

Step 3: Enable Add App in Faugus

Edit ~/.config/faugus-launcher/games.json and update the Battle.net entry: json "addapp_checkbox": "addapp_enabled", "addapp": "HearthstoneDeckTracker", "addapp_bat": "/home//Faugus/battlenet/drive_c/Program Files (x86)/Battle.net/faugus-battlenet.bat", Alternatively, this can be configured through the Faugus Launcher GUI by editing the Battle.net entry and enabling the Add App option.

Step 4: Launch

1. Open Faugus Launcher
2. Launch Battle.net — HDT will start automatically alongside it
3. Launch Hearthstone from Battle.net
4. HDT should detect Hearthstone and display its overlay

Why This Works

Faugus Launcher uses umu-run with Proton, which wraps each game in a bubblewrap (pressure-vessel) sandbox. Each sandbox has its own isolated wineserver. By using the Add App batch file, both Battle.net and HDT are launched within the same sandbox, sharing the same wineserver, so HDT can see the Hearthstone process.

I have this problem where the background of the overlay is black and it cover almost all of the game, but i can view the widgets fine, do you have any solution on how to fix this? i'm on cachy os + niri