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

Drop files here or click to browse .json logs in MergeConverter format, or PokerStars .txt files to merge

    2. Download for your tracker

    0hands converted

    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.

    not selected
    not selected
    Idle

    Folder sync needs the File System Access API, available in Chrome, Edge and Opera on desktop. In other browsers, convert files with drag and drop above, or use cloud sync on Pro.

    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 bet and raise, 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.

    Read the import guide