search

matt57225 / bovada-hand-history-converter

31 stars 10 forks source link

readme

Ignition/Bovada Hand History Converter

This program converts Ignition/Bovada poker hand histories to PokerStars format. It will not convert hand histories as you play.

All hole cards are shown (optional) in HM2's latest version

You can update to the latest version by re-downloading all of the files in this repository and replacing the old files with the new ones.

This converter is beta software and has not been tested extensively (use it at your own risk). It has been tested with NLHE and PLO cash game hands (and some NLHE tournament hands). It is recommended that you backup your original hand history files (and keep them in a safe place) before using this converter. It is also recommended that you backup your databases before using this converter.

A large portion of the code in this project is modified code (mostly unused code was removed) from the FPDB project (GitHub page 1, GitHub page 2)

If you find this program useful and would like to make a donation click on the link below

PayPal

BitCoin - 1EJ7RQKfD18PttnoKXfXqx8LnXrGNELxjs

Windows

Complete the following steps in order.

Short Version

  1. Install Python 3.x (install the latest 3.x)
    • enable/install "Add Python 3.x to PATH" (from the first screen) and "pip" (from the "Customize installation" screen), no other features need to be installed
  2. Install PyQt5
    • install via Command Prompt with the following command:
    • pip3 install PyQt5
  3. Install pytz
    • install via Command Prompt with the following command:
    • pip3 install pytz
  4. Download and run the converter
    • scroll to the top of this webpage and download the converter (click on "Clone or download" then click "Download ZIP")
    • extract the folder within the zip file you downloaded to a new folder on your computer
    • open a Command Prompt window to that folder and run the following command:
    • python app.py
    • the program might load slowly the first time but each time after that it should load quickly
    • you probably will want to make a shortcut to run the converter (see details below)

Detailed Version

  1. Install Python 3.x (install the latest 3.x)
    • on the installer's first screen check/enable "Add Python 3.x to PATH"
    • (optional) on the same screen you can click "Customize installation" and uncheck all features except for "pip" (pip is required for step 2)
    • click "Next" button until you see an "Install" button and then click the "Install" button (you do not need to check any more boxes)
    • when installation is complete you will have an option to "Disable path length limit", do not choose this option just click the "Close" button
    • Test if Python is installed by doing the following:
    • open a Command Prompt window
    • type python --version
    • press Enter key
    • if a version is shown then Python is installed
    • if this is not working you might need to sign out of your Windows user account and sign back in or restart the computer
  2. Install PyQt5
  3. Install pytz
  4. Download and run the converter
    • scroll to the top of this webpage
    • click on "Clone or download" then click "Download ZIP"
    • extract the folder (this folder can be renamed) within the zip you downloaded to a new folder on your computer
    • open a Command Prompt window to that folder
    • type python app.py
    • press Enter key and the converter should start running and the GUI should appear (you can minimize the Command Prompt window while it's running), the program might load slowly the first time but each time after that it should load quickly
    • you probably will want to make a shortcut to run the converter by doing the following:
    • within the folder you extracted from the zip file make a new text document (right click --> "New" --> "Text Document"
    • open the text document and type python app.py
    • save the document
    • rename the text document from New Text Document.txt to anyname.cmd (or anyname.bat), you might have to set Windows to show file name extensions to be able rename the file's extension (you can change the setting back to hide file extensions after completing this step)
    • you can double click on this cmd (or bat) file to run the converter, you can also make a shortcut by right clicking on the cmd (or bat) file and then clicking "Send to" --> "Desktop (create shortcut)" (the shortcut can be renamed)

Mac

Misc

Packaging converter into a single executable file (Windows and Mac)