{"id":14133045,"url":"https://github.com/Jantero93/pokerstars-statistics-script","last_synced_at":"2025-08-04T13:33:00.254Z","repository":{"id":214380847,"uuid":"734004318","full_name":"Jantero93/pokerstars-statistics-script","owner":"Jantero93","description":"Script for tracking history on PokerStars","archived":false,"fork":false,"pushed_at":"2024-12-15T11:10:02.000Z","size":292,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-15T12:20:01.154Z","etag":null,"topics":["card-game","holdem","node","omaha","poker","pokerstars","pokerstars-hand-history","scripting","statistics","text-parsing","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jantero93.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-20T16:24:42.000Z","updated_at":"2024-11-29T20:50:32.000Z","dependencies_parsed_at":"2023-12-27T21:18:18.058Z","dependency_job_id":"8b2d8f2b-234c-49b6-8b35-4ef27813cc59","html_url":"https://github.com/Jantero93/pokerstars-statistics-script","commit_stats":null,"previous_names":["jantero93/poker-statistics-script"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Jantero93/pokerstars-statistics-script","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jantero93%2Fpokerstars-statistics-script","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jantero93%2Fpokerstars-statistics-script/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jantero93%2Fpokerstars-statistics-script/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jantero93%2Fpokerstars-statistics-script/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jantero93","download_url":"https://codeload.github.com/Jantero93/pokerstars-statistics-script/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jantero93%2Fpokerstars-statistics-script/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268701786,"owners_count":24292999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["card-game","holdem","node","omaha","poker","pokerstars","pokerstars-hand-history","scripting","statistics","text-parsing","typescript"],"created_at":"2024-08-16T05:01:32.102Z","updated_at":"2025-08-04T13:32:59.724Z","avatar_url":"https://github.com/Jantero93.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# PokerStars Statistics\n\nThis script is designed to track poker game history and uses `console.log` to print statistics to the terminal.\n\n**This script supports only play money**\n\n## Supported Games\n\n* The list of supported games can be found in the [types/general.ts](https://github.com/Jantero93/poker-statistics-script/blob/master/src/types/general.ts) file.\n\n## Features\n\nThe script keeps track of the count of played hands for each supported game, including both cash and tournament games. Games with zero counts are not printed (customizable from the .env file).\n\nThe script attempts to detect the localization from your system, with a default value of \"en-US\". You can also set this in the .env file.\n\n**For tournaments and sit \u0026 go's, it tracks:**\n\n* Total games played\n* Total wins\n* Winning percentage\n* Tournament earnings\n* Paid buy-ins \u0026 re-entries\n* The difference between wins and buy-ins \u0026 re-entries\n* Earnings compared to costs (percentage value)\n\n\n**Example output of script time when readme is updated. (fi-FI) localization, minimun played hands for game is 10 to show in statistics**\n```\n--- Played hands by game ---\nHold'em No Limit         1 607\nHold'em Limit            488\nOmaha Hi/Lo Limit        475\nRazz                     467\n7 Card Stud              427\n7 Card Stud Hi/Lo        418\nTriple Draw 2-7 Lowball  389\nOmaha Pot Limit          366\n------------------------------\nAll played hands         4 647\n\n--- Tournament, sit \u0026 go statistics ---\nTotal games                   23\nTotal wins                    7\nWinning percentage            30,43 %\nEarned money                  943 625\nPaid buy-ins (and rebuys)     580 000\nDiff on buy-ins and winnings  363 625\nEarnings compared to costs    62,69 %\n```\n\n## Environment variables and requirements\n\nYou need Node 17 (lower versions may be okay, not tested). The script may not work with Node \u003e= 20.0.6 because dotenv is built-in.\n\nIf you have PokerStars installed on the default path and only one player account, the script will attempt to automatically detect the necessary environment variables if none are set. Otherwise, you need to set folder paths and player name manually in the .env file on the project root.\n\nLocalization and showing a minimum of played hands in statistics are optional.\n\nThere is a .env.example with instructions on what it should look like. If you do not provide an .env file, the script will try to detect these values from your operating system.\n\nExample of .env file\n```bash\n# Name actual env file .env on project root\n# You must set these three (HAND_HISTORY_FOLDER_PATH, TOURN_HAND_HISTORY_FOLDER_PATH, PLAYER_NAME)\n# If you want try to script may be able to get these values automatically, build project without .env file.\n# If build fails, then you need to set .env file\nHAND_HISTORY_FOLDER_PATH=\"C:\\Users\\Windows_User\\AppData\\Local\\PokerStars\\HandHistory\\Player_Name\"\nTOURNAMENT_STATISTICS_FOLDER_PATH=\"C:\\Users\\Windows_User\\AppData\\Local\\PokerStars\\TournSummary\\Player_Name\"\n# This is needed if you give path but you have multiple accounts/player names in history folder\nPLAYER_NAME=\"Player-name\"\n\n# Optional, default value \"en-US\"\n# This can be removed\nLOCALIZATION=\"fi-FI\"\n\n# Optional, don't show games played under n hands\n# By default show all games which are played even once\n# This can be removed\nMIN_GAMES_SHOW=10\n```\n## Building the project\nRun the following commands in the root to install dependencies and build the project:\n\n```bash\nnpm install\n```\n```bash\nnpm run build\n```\nTo run the statistics, use the command:\n\n```bash\nnpm start\n```\nor\n```bash\nnode dist/index.js\n```\n\n\n\nI recommend creating for example a bash script for this. I have the following bash script set as an alias\n```bash\nSTART_DIR=$(PWD)\n\ncd /C/Users/\u003csome path\u003e/pokerstatistics/dist\nclear\nnode index.js\ncd $START_DIR\n\nexit 0\n```\n\n## Bugs\n\nPlease [open an issue](https://github.com/Jantero93/pokerstars-statistics-script/issues) on GitHub if you find a bug. There may be a few.\nAlso open an issue if you encounter problems with installation or anything else.\n\n## Feature Suggestions\n\nPlease [open an issue](https://github.com/Jantero93/pokerstars-statistics-script/issues) on GitHub. I am open to new suggestions.\n\n**I'm open-minded for all kinds of discussions**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJantero93%2Fpokerstars-statistics-script","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJantero93%2Fpokerstars-statistics-script","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJantero93%2Fpokerstars-statistics-script/lists"}