PokerTH

Hello everyone,

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
2. Install the application
3. Run the application
Run from a terminal or find it in your application menu.

Troubleshooting

If you get a Core Dump on launch, install the libxcb dependencies.

Ubuntu / Debian
Fedora / RHEL

---

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

Options

• Configure HUD… — Opens the HUD configuration dialog

Help

• 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

Displayed stats correspond to those configured in
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

Stats are arranged automatically in rows of 2.

---

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

Filters

• Position — BTN, SB, BB, UTG, CO…
• Number of players — table size
• A counter shows how many hands match the filters

---