HUD Troubleshooting

PokerTracker 4 version 4.0.x
October 25, 2013
  • Overview

    This guide is purely focused on fixing any problems that affect your use of the HUD.

    For help configuring or using the HUD please read the following guides:

  • HUD Issues
    • HUD Does Not Appear

      You don't need to do anything to activate the HUD. Once Get Hands While Playing is running and you have a table open with hands being imported, the HUD will be shown once a complete hand has been played.

      If the HUD is not appearing please try these steps:

      • Your poker client must be installed in English (not just writing hand histories in English). Please re-install it and choose English if you are given the option.
      • In the Configure HUD / HUD Options > Filters section:
        • Disable "Show stats for current limit only".
        • Set "Minimum Hands Required" to 0 (zero) - you will not see stats for a player until they have this many hands in your database.
          Note: if you are using multiple databases, the minimum hands must be in BOTH database individually, not combined.
        • Make sure the correct database(s) is/are selected in the HUD Options.
        • Set "Stats from the last X hands" to 0 (zero) so that you see all stats.
        • Remove all Player Ranges.

      These filters can interact with each other in ways which may not be immediately obvious, but setting them as described above should remove any of these issues.

      As an example if you have the Minimum Hands set to non-zero and Player Ranges enabled then this could prevent any stats being shown when there are more or less players active then the tables you normally play.

      Tutorial: Configuring HUD Options

      • If you have configured the Hud to read from multiple databases try setting it to read from only the current active database.  Hud > Edit Hud Options > General > Advanced.
      • If hands are importing and the PT-icon appears on the table, or switching to a single database helped, but you still see no player stats try rebuilding the cache via Database > Database Management for any databases used by the Hud.  If you have large databases this will take some time.


      If you still can't get the HUD to appear please report your problem so that we can check your configuration and troubleshoot the issue.

      The best thing is to enable logging and restart then play about 20 or 30 hands at a single table.
      Take a screenshot of the table and attach it along with the hand history file for the session and the PokerTracker4.log and PokerTrackerHUD4.log files to a Support ticket.

    • HUD Appears But Has Problems

      If the HUD is working but has partial stats or is slow or "laggy", or the stats disappear from time to time try some performance tweaking:

      • Check the Database > Database Management window for your PostgreSQL version - if you're using 8.3.x but not at least 8.3.9 or later then you should update to the latest 8.3.x version. Directions here.

      NOTE: PokerTracker 4 supports PostgreSQL versions 8.3.9 or later, 8.4.x, 9.0.x and 9.3.x.

      • For optimum performance the cache needs to be at 100% for all of your databases.

      One option is to Rebuild Cache.  If you choose to Rebuild Cache that will force a complete rebuild of the cache from scratch, which is good for making sure everything is correct if you're seeing strange behaviour.

      Performance Tuning: Hard Drives
      Performance Tuning PostgreSQL

      If you still have issues please report your problem so that we can check your configuration and troubleshoot your specific issue.

    • Blurry or Fuzzy HUD Text - Microsoft Windows Only

      PokerTracker 4's Vector HUD Engine utilizes the advanced text rendering abilities of the Windows Operating System to display crisp scalable text as the HUD expands with the size of the table.  

      The ClearType wizard will tune your operating system to make sure that all text looks the way you want it too on your screen.  In addition to helping PokerTracker 4's HUD, you will find this will be a benefit to the display of fonts system-wide.


      Windows 7

      Click Start -> Control panel -> Appearance and Personalization -> Display ​and then select Adjust ClearType text on the left hand pane.


      Check Turn on Cleartype and click next to cycle through the pages of the ClearType wizard to tune your on-screen text to your optimal conditions.




      Windows Vista or XP users should visit the following page on the MicroSoft website to enable and tune ClearType:

    • Preferred Seating Issues

      If you have problems with Preferred Seating or Auto Center, or even stats appearing by the wrong players when you are not using these options please read the Preferred Seating tutorial, and also consult the PokerTracker 4 Site Configuration Guide for your respective poker site or network. 

    • Fast Fold Table HUD Issues (Zoom, Rush, Strobe, Fast Forward, Fast Poker)

      There are two major issues users have reported with their HUD when playing at "Fast Fold" tables such as PokerStars Zoom, Full Tilt Poker Rush, OnGame Strobe, PartyPoker Fast Forward, or iPoker's Fast Poker.

      1. The HUD stats do not appear to change while playing
      2. There may be a large delay before the HUD displays

      note - you will not see on table HUD groups for players names with whom you do not have prior hands for in your database, but you will see the Hero's on-table HUD group and the PokerTracker 4 HUD icons at the end of the first hand played, once the hand history has ben saved to your local computer.

      To address both issues you will need to first configure enable the Fast Fold HUD option for your poker site:

      Once the options are configured correctly to allow the Fast Fold table HUD to be displayed, then follow these steps exactly to ensure the HUD is displayed above each opponent's name:

      1. Close any open poker clients and PokerTracker 4. 
      2. Start PokerTracker 4
      3. Start your poker client and then Login
      4. Click "Get Hands While Playing" in PokerTracker 4
      5. Join a Fast Fold table (Zoom, Rush, Fast Forward, Strobe, Fast Poker; or Snap tournament)

      If you have follwed these instrctions but you continue to have any HUD issues, please close both PokerTracker 4 and your poker client and then start again from step 1.

      If you experience a large delay before your HUD displays on Fast Fold tables you may have some hand histories files that aren't being processed correctly.  Please follow the steps from this guide on moving processed files to ensure hands are being processed efficiently at the end of your session.  Enabling the Move Processed Files feature will greatly reduce the time between starting the import and the appearance of your HUD.

      NOTE: The Mac OS X version of PokerTracker 4 cannot support Rush, fastforward, or Fast Poker due to the unavailability of opponent seating information in the Hand Histories.  If you wish to play fast fold games on the Mac we sugest you try PokerStars' Zoom or OnGame's Strobe tables which are fully supported in OS X, or 888's Snap tournaments. 
    • PFR > VPIP

      VPIP and PFR both use actual opportunities in PT4.  Take a situation where you have $60 and your opponent goes all-in in front of you for $200.  In this situation you can call or fold (which affect your VPIP), but you cannot raise (which affects your PFR).


      • If you face a situation like that and fold your VPIP=0% (0/1) and PFR=N/A (0/0).
      • Let's say in the next hand you raise. Now VPIP = 50% (1/2) and PFR = 100% (1/1).
    • Mac OS X Specific Issues
      • Missing HUD in OS X Lion (OS X 10.7)

        OS X Lion introduced a new feature called Mission Control which altered the way that Desktop Spaces work.  Mission Control is a window and app manager built into Mac OS X that combines Virtual Desktops (Spaces), an application switcher, and a window manager into one centralized tool. 

        PokerTracker 4's HUD will only function if the poker table or the replayer is within the primary Mission Control desktop space.  The PokerTracker 4 application can exist in any of the desktop spaces assignable within Mission Control, but the HUD will only appear within Desktop 1.