Skip to main content

Fetch your games from and and add them to a sqlite database

Project description

PGN to Sqlite

PyPI version GitHub Black

A cli application for pulling pgn files from and 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.8 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


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 or You can also
  `save` local pgn files to the database.

  Type `pgn-to-sqlite --help` for more information.

  -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.

  fetch  Fetch all games from the requested site.
  save   Fetch all pgn file from the given folder.

Fetch games from or

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 and respectively.


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.

Save games from local folder

output is required when saving games from local pgn files to your database. save expects a folder path as an argument.


pgn-to-sqlite -o data.db save .\chess\games\

Feedback and Contribution

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 format you code with Black and isort. I also reccomend using ruff to lint your code.

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. 🤓

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pgn_to_sqlite-2.1.6.tar.gz (23.6 kB view hashes)

Uploaded source

Built Distribution

pgn_to_sqlite-2.1.6-py3-none-any.whl (6.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page