A cli application for pulling pgn files from Chess.com and Lichess.org and putting your games into a sqlite database.
It can also be used to save pgn files from a local folder to a sqlite database.
Requires Python 3.9 and above.
It is recommended that you install this package in a virtual or isoloated environment. The easiest way to do this is with pipx.
pipx install pgn_to_sqlite
Alternatively, you can install it with pip into your virtual environment:
MacOS / Linux:
python3 -m pip install pgn_to_sqlite
Windows:
python -m pip install pgn_to_sqlite
Usage: pgn-to-sqlite [OPTIONS] COMMAND [ARGS]...
Save your chess games to an sqlite database.
You can `fetch` your games from chess.com or lichess.org. You can also
`save` local pgn files to the database.
Type `pgn-to-sqlite --help` for more information.
Options:
-u, --user TEXT You username for the chess site.
-o, --output FILE Where you would like your database saved? [required]
--help Show this message and exit.
Commands:
fetch Fetch all games from the requested site.
save Fetch all pgn file from the given folder.
username
and output
are required when using fetch
to download, parse, and save your games to your database. fetch
accepts with chess
or lichess
as an argument for chess.com and lichess.org respectively.
Example:
pgn-to-sqlite -u endlesstrax -o data.db fetch lichess
If you've played a lot of games, be patient, it could take a minute or two.
output
is required when saving games from local pgn files to your database. save
expects a folder path as an argument.
Example:
pgn-to-sqlite -o data.db save .\chess\games\
If you find a bug, please file an issue.
If you have feature requests, please file an issue and use the appropriate label.
Please raise an issue before making a PR, so that the issue and implementation can be discussed before you write any code. This will save you time, and increase the chances of your PR being merged without significant changes.
Please lint and format you code with ruff. Use ruff check .
and ruff format .
to check and format your code respectively. This will help keep the codebase consistent and maintainable.
Please include tests for any PR's that include code (unless current tests cover your code contribution).
If you would like to show your support for the project you can sponsor me on Github, or buy me a coffee. 🤓