How it works: from club app to tracker
Step-by-step help for the browser converter, folder auto-sync and importing converted hands into Holdem Manager 3, PokerTracker 4 and Hand2Note.
Convert hands in the browser
- Open the online converter. It works in Chrome, Edge, Firefox, Safari and Opera.
- Drag one or more
.jsonhand logs onto the drop area, or click it to browse. You can mix files from different apps and clubs. - Check the log: it shows how many hands were converted per file and explains any hand that was skipped, such as a missing big blind or an unknown player in the action.
- Click Download .txt. The file contains every converted hand in PokerStars format with Windows line endings.
Files are read by JavaScript in your tab. Nothing is sent to MergeConverter servers; you can even disconnect from the internet after the page has loaded.
Set up folder auto-sync
Auto-sync is the modern replacement for the old desktop converter that sat in the system tray. It uses the browser's File System Access API, so it needs desktop Chrome, Edge or Opera.
- Create two folders, for example
Documents\PokerLogs(where your exports land) andDocuments\MergeConverter(for converted files). - On the converter page, under Auto-sync a folder, choose the log folder and then the output folder. The browser asks for permission once per session.
- Set how often to check (30 seconds is a good default) and click Start auto-sync.
- Add the output folder to your tracker's auto-import list (see below). From now on new logs flow into your database on their own.
Every log file is converted once. If a file is updated, for example a recorder appending hands to the same session file, it is converted again and the tracker's duplicate check skips hands it already has.
Import into your tracker
Holdem Manager 3
- Open HM3 and go to the import section.
- For a one-off import, choose to import files and select the downloaded
.txt. - For automatic import, add your MergeConverter output folder to the auto-import folders and start auto-import.
PokerTracker 4
- Use Get Hands from Disk to import a single file or a whole folder.
- To import continuously, add the output folder to the hand history folders used by Get Hands While Playing, with PokerStars as the site.
Hand2Note
- Open the import menu and choose files to import the
.txt. - For auto-import, add the output folder to Hand2Note's hand history folders.
Converted hands are recognised as PokerStars hands. Set your hero name in the tracker to the screen name you use in the club app, so your own stats and graphs are separated from opponents.
Troubleshooting
The tracker imports 0 hands
Make sure you import the converted .txt, not the original .json. If you edited the file, save it as UTF-8 text.
Some hands were skipped
The converter log says why: usually a player who acts after folding, a call when there is nothing to call, or a missing board card. Fix the log and convert it again.
Stacks and winnings look 100× too big or small
Amounts are taken exactly as written in the log. If your export uses chips ×100 (for example 2000 for a 20.00 stack), scale the numbers before converting.
Times are off by a few hours
Write time in ISO format with a time zone, such as 2026-10-21T19:42:05Z. The converter prints both UTC and US Eastern time, as PokerStars does.
Convert your first session in under a minute
Drop a hand log into the browser converter and download a file your tracker imports straight away.