Online hand history converter
Drop PPPoker, PokerBROS, Suprema Poker or ClubGG hand logs and download a PokerStars-format file for Holdem Manager 3, PokerTracker 4 or Hand2Note. Files are processed on your device.
1. Add hand logs
2. Download for your tracker
Import the file in Holdem Manager 3, PokerTracker 4 or Hand2Note as a PokerStars hand history. Import help →
3. Auto-sync a folder Free
Pick the folder where your hand logs are saved and your tracker's auto-import folder. While this tab is open, MergeConverter checks for new logs and writes converted files for the tracker to pick up.
Tips
- Use a dedicated output folder, e.g.
Documents\MergeConverter, and add it to your tracker's auto-import list. - Each log is converted once; edit and re-save it to convert it again.
- Keep the tab open (it can stay in the background).
Input format
The browser converter reads MergeConverter JSON (mergeconverter/v1), a simple open format that describes a hand the way you would read it out loud: seats and stacks, actions per street, board cards, showdown and rake. Our hand recorder and the Pro cloud parsers produce it from native PPPoker, PokerBROS, Suprema Poker and ClubGG exports, and you can write it yourself from any spreadsheet or script.
{
"format": "mergeconverter/v1",
"app": "PPPoker", // PPPoker | PokerBROS | Suprema | ClubGG
"club": "Golden Dragon 482193",
"game": "NLH", // NLH | PLO | PLO5
"sb": 0.10, "bb": 0.20, "max": 6, "hero": "Hero",
"hands": [{
"id": "88213451", "time": "2026-10-21T19:42:05Z", "button": 1,
"seats": [{"seat": 1, "name": "Hero", "stack": 20, "cards": "Ah Kd"},
{"seat": 2, "name": "DragonKing", "stack": 18.4}, ...],
"preflop": [["nitro_cat", "fold"], ["Hero", "raise", 0.60], ["DragonKing", "call"], ...],
"flop": {"cards": "2c 7h Td", "actions": [["DragonKing", "check"], ["Hero", "bet", 0.80], ...]},
"turn": {"cards": "Js", "actions": []},
"river": {"cards": "4d", "actions": []},
"showdown": {"Hero": "Ah Kd", "DragonKing": "Qs Qd"}, // optional
"winners": [["Hero", 1.33]], // optional, computed if omitted
"rake": 0.07
}]
}
- Amounts are in table currency (club chips are written as $). For
betandraise, give the player's total for the street, i.e. "raise to". - Actions:
fold,check,call(amount is calculated),bet,raise,allin. - Blinds are posted automatically from the button position. Heads-up, the button posts the small blind.
- Winners can be omitted. Pots, side pots and splits are then worked out from the showdown cards.
- Top-level fields (
app,club,game, blinds,hero) are defaults that any hand can override.
Output
Each hand is written in the PokerStars hand history layout with a unique hand number per app, the table name built from app, club and table, and timestamps in UTC and ET.
PokerStars Hand #188213451: Hold'em No Limit ($0.10/$0.20 USD) - 2026/10/21 19:42:05 UTC [2026/10/21 15:42:05 ET]
Table 'PPPoker Golden Dragon 482193 NLH 3' 6-max Seat #1 is the button
Seat 1: Hero ($20 in chips)
Seat 2: DragonKing ($18.40 in chips)
...
DragonKing: posts small blind $0.10
Lucky88: posts big blind $0.20
*** HOLE CARDS ***
Dealt to Hero [Ah Kd]
nitro_cat: folds
...
Hero: raises $0.40 to $0.60
DragonKing: calls $0.50
Lucky88: folds
*** FLOP *** [2c 7h Td]
DragonKing: checks
Hero: bets $0.80
DragonKing: folds
Uncalled bet ($0.80) returned to Hero
Hero collected $1.33 from pot
*** SUMMARY ***
Total pot $1.40 | Rake $0.07
Board [2c 7h Td]
Seat 1: Hero (button) collected ($1.33)
Seat 2: DragonKing (small blind) folded on the Flop
...
Not sure how to import the file?
Our step-by-step guides cover Holdem Manager 3, PokerTracker 4 and Hand2Note.