-
Notifications
You must be signed in to change notification settings - Fork 2
Home
Poker Mavens is a popular commercial software package for hosting card games online published by Briggs Softworks.
PokerTracker4 (often abbreviated PT4) is a popular commercial package used by poker players to track their play in various game sessions over time to analyze and improve their play. PT4 works with a number of popular online sites, making it easy to pull in hand histories from a variety of sources and track play.
To date, however, there is no integration available with Poker Mavens.
Pokertracker does however, offer a standard for import called Open Hand History (or OHH) that should allow vendors to write their own conversion routine.
The purpose of this script is to take Poker Mavens hand history text files, and transform the hand history to OHH format for import to PT4.
The Python script convertMavensHH.py takes a number of input files and produces .ohh text files containing the same hand histories transformed to OHH format.
usage: convertMavensHH.py [-h] [-c CURRENCY] [-i] [-p PLAYER] [-t TIMEZONE] [file [file ...]]
It is important to specify a "hero" player name when converting the hand history. You can specify this on the command line with the -p switch, or list this in the external configuration file.
PokerTracker also wants to sequence by time, so be sure to understand the local time used in your hand history and specify the timezone for proper transformation to UTC time. Again do this on the command line with the -t switch or specify in the configuration file.
Finally currency is by default play money PPC. You will want to specify a currency if using PokerTracker to harmonize various currencies. Use a three letter currency abbreviation (like USD or GBP). Specify with the -c switch on the command line or specify in the configuration file.
Initial test of the import seems to indicate that a table name represented in non-ASCII characters will result in import issues in PT4.
A to-do for the project is to transform these consistently. In the mean time, you may need to transform table names ahead of time or avoid trying to import these.
The Open Hand History specifications seem to indicate support for Stud games, but there are specifics in the documentation that seem to indicate that is not the case. Primarily, there is a requirement that there is always a Showdown round with an ID of 4. This does not match a 7-card stud game sequencing.
The import has been tested only with Hold 'Em. It should also work with Omaha and split pot Omaha Hi-Lo.
This has been tested with the following software:
- Poker Mavens 6.25, 6.26, 6.27
- PokerTracker 4.15.26
Although the python script is completely self-contained, it will look for an INI file for configurable options (most importantly the default hero name and the timezone and currency for games).
By default the INI is expected to have a name convertMavensHH.ini and be found in the same directory where the script is executed.
A sample INI file is provided.
The input should be one or more text files holding hand history information from Poker Mavens. By default, players accessing Poker Mavens on a Web browser will not produce hand history files. To capture hand history from Poker Mavens, go to the Hand History window and choose "Save". this will open the hand history in a separate browser window. Save the text contents of this window to a local text file.
The conversion script will read the named files listed on the command line when executing the script. It will look for duplicate hand history and only list them once in output (so if you save a file at one point in the evening, and then save to another file later, just import both files and the script should avoid duplication).
As recommended by Poker Tracker, hand histories are separated by table and exported as text files. Each hand is represented as a separate line in JSON format, with a blank line separator in between hands.
Therefore there will be one output file for each separate table found in imported hand history files.
The output files will have names like
Prefix-YYYY-MM-DD-TableName.ohh
Where "Prefix" is specified in the defaults (or the INI file if External Configuration is used), YYY-MM-DD is the date of the LATEST hand found in the input files for a given table, and TableName is as specified in the Mavens hand history file. The Table Name will be as listed, with the exception that characters not allowed in Windows file names will be replaced with an underscore.