charlestudor / PokerNowLogConverter

A simple CLI tool for converting logs from Poker Now games to the PokerStars format.
MIT License
12 stars 3 forks source link

🂡 Poker Now Log Converter 🂡

pypi python Build Status

A command line utility for converting logs from Poker Now games to other formats.

Introduction

Poker Now is a free online client for playing Texas Hold'em, Omaha PL and Omaha PL Hi/Lo poker.

Currently the game logs that can be downloaded from the Poker Now client are not supported by most poker analysis programs such as GTO Wizard, PokerTracker, Holdem Manager, UpSwingPoker etc

Poker Now Log Converter can be used to convert Poker Now logs into the PokerStars format for further analysis.

This project was written for my personal use, and is not affiliated, endorsed or sponsored by the Poker Now team.

Features

Installation

Poker Now Log Converter supports Python 3.8 to 3.11.

1. Install via Pip:

$ pip install poker-now-log-converter
$ python -m poker_now_log_converter 

2. Install from Git:

$ git clone git://github.com/charlestudor/PokerNowLogConverter
$ python setup.py install
$ python -m poker_now_log_converter 

3. Use as a script without installing

$ git clone git://github.com/charlestudor/PokerNowLogConverter
$ python ./PokerNowLogConverter

Usage

As a command line tool:

$ python -m poker_now_log_converter -h

usage: __main__.py [-h] [-o OUTPUTDIR] [-H HERONAME] [-a ALIASES] [-c CURRENCY] [-tz TIMEZONE]
               [-f FILENAME | -d DIRECTORY] [-q | -i]

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUTDIR, --outputDir OUTPUTDIR
                        Specify output directory to save logs to. Defaults to current folder.
  -H HERONAME, --heroName HERONAME
                        Specify the name of the hero. This should match an alias or unique 'name @ id' of the player
                        who cards are being dealt to.
  -a ALIASES, --aliases ALIASES
                        Specify a mapping of player ids to aliases. The format should
                        be:'player1=alias1,player2=alias2'
  -c CURRENCY, --currency CURRENCY
                        Set currency being used in games. Defaults to USD
  -tz TIMEZONE, --timezone TIMEZONE
                        Set timezone these games were recorded in. Defaults to ET
  -f FILENAME, --filename FILENAME
                        Specify PokerNow Log file to convert.
  -d DIRECTORY, --directory DIRECTORY
                        Specify directory containing PokerNow Log files to convert.
  -q, --quiet           Run converter tool without outputting to terminal.
  -i, --interactive     Use interactive mode to set the aliases of players seen in the log

$ python -m poker_now_log_converter -H CT -f ./PNLogExample.txt -c GBP -tz GMT -i -o ./OutputDir

As a library:

$ python
>>> from poker_now_log_converter.main import convert_poker_now_files
>>> convert_poker_now_files(hero_name="CT", input_filename="./PNLogExample.txt")

Contributing

If you find a bug please file an issue. Please upload an example log which is broken to aid in fixing.

License

MIT

Special thanks to Samuel Simões for creating Poker Now, which is a brilliant poker client.