I’ve developed a tracker for PokerTH that provides a real-time HUD and player statistics during games by analysing PokerTH log files.
The application displays key stats directly on the table, allows importing past games, and includes a range viewer to analyse hands shown at showdown.
The tracker is available for Linux, Windows, and macOS (Apple Silicon).
Below you can find the installation instructions and a full description of the features.
Features
- Real-time tracking of played hands
- HUD overlay on the PokerTH window with per-player stats
- Historical import of all past games
- Range visualisation (grid of hands shown at showdown)
- SQLite database to persist stats between sessions
PokerTH-Tracker is available for download on pokerth download section.
GitHub Main Page: https://github.com/MCNCHEESYF/pokerth-tracker
Installation
Setup (Released version)
Windows
Run the portable EXE.
MacOS Silicon
Open the DMG file and copy the PokerTH-Tracker application to Applications.
Linux
1. Make the application executable
Code: Select all
chmod +x PokerTH-Tracker-1.1.3-Linux-x86_64.AppImage
Code: Select all
./PokerTH-Tracker-1.1.3-Linux-x86_64.AppImage --install
Code: Select all
pokerth-tracker
Troubleshooting
If you get a Core Dump on launch, install the libxcb dependencies.
Ubuntu / Debian
Code: Select all
sudo apt install -y \
libxcb-cursor0 \
libxkbcommon-x11-0 \
libxcb-xinerama0 \
libxcb-render0 \
libxcb-shape0 \
libxcb-randr0 \
libxcb-icccm4 \
libxcb-keysyms1 \
libxcb-image0 \
libxcb-util1
Code: Select all
sudo dnf install -y \
xcb-util-cursor \
libxkbcommon-x11 \
xcb-util-image \
xcb-util-keysyms \
xcb-util-wm
Interface
Main window
Log folder
At the top of the window, the application shows the folder it reads PokerTH logs from.
Main buttons
| Button[/th][th]Description | |
| Start tracking / Stop tracking | Starts or stops real-time monitoring of the active log file. Disabled during import. |
| Show HUD / Hide HUD | Shows or hides the overlay HUD. Available only when tracking is active and stats exist. |
| Show Range / Hide Range | Opens or closes the range window for the selected player. |
| Import | Imports all .pdb files from the log folder (incremental import). Disabled during tracking. |
Statistics table
Displays stats for all known players.
Click a column header to sort. Default sorting: number of hands.
| Player | Player username |
| VPIP% | % of hands where the player voluntarily put money in preflop |
| PFR% | % of hands where the player raised preflop |
| AF | Aggression factor (bets + raises / calls) |
| 3-Bet% | % of 3-bets when possible |
| C-Bet% | % of continuation bets after preflop aggression |
| F3B% | % of times the player folds to a 3-bet |
| FCB% | % of times the player folds to a continuation bet |
| WTSD% | % of hands reaching showdown after flop |
| W$SD% | % of showdowns won |
| Hands | Total number of recorded hands |
Menu
File
- Import history… — Same as the Import button
- Clear stats — Deletes all statistics from the database
- Quit (Ctrl+Q) — Closes the application
- Configure HUD… — Opens the HUD configuration dialog
- About — Displays version and features
HUD Overlay
Once tracking is active, each player gets a floating panel on the PokerTH table.
- Move a panel: left-click and drag
- G / U button: toggle grouped / individual movement
- Right-click: context menu with Reset positions
Options → Configure HUD.
HUD Configuration
Accessible via Options → Configure HUD
- Checkboxes — select which stats to display
- Reset — restore default stats (VPIP, PFR, AF, Hands)
- Cancel — discard changes
- Save — save configuration
Range Window
Accessible by selecting a player and clicking Show Range.
Displays a 13×13 grid representing hands shown at showdown.
- Diagonal — pairs (AA, KK, QQ…)
- Top-right triangle — suited hands (AKs, KQs…)
- Bottom-left triangle — offsuit hands (AKo, KQo…)
- Colour gradient — green → yellow → red → grey
- Position — BTN, SB, BB, UTG, CO…
- Number of players — table size
- A counter shows how many hands match the filters