Skip to main content

Creates GIFs from PGNs

Project description


Create GIFs from PGNs


Run ./pgn2gif with the following options:

Usage: pgn2gif [OPTIONS] COMMAND [ARGS]...

  Create GIFs from PGNs

  -p, --path TEXT                 path to the pgn file/folder
  -s, --speed FLOAT               speed with which pieces move in gif.
  -o, --out TEXT                  name of the output folder
  -si, --size INTEGER             size of the gif
  -c, --color [green|blue|brown]  color of chess board
  -g, --game-index INTEGER        index of the game for which gif is to be
  --all-games                     make gif of all the games found in a PGN
  --help                          Show help screen.

  chess_com  Get games played on
  lichess    Get games played on lichess

You can also run ./pgn2gif without any external options and in that case ./pgn2gif will run on the following default values:

* path          current working directory
* speed         0.5
* out           folder name `gifs` in current working directory
* size          480 X 480
* color         Brown
* game-index    1st


  • ./pgn2gif

alt text

  • ./pgn2gif -c blue

alt text

  • ./pgn2gif -c green

alt text

  • ./pgn2gif -p /home/mzfr/dev/mzfr.pgn

alt text

  • ./pgn2gif -p /home/mzfr/dev/mzfr-1.pgn -s 0.2

alt text

  • ./pgn2gif -si 600 -s 0.1

alt text

  • ./pgn2gif -si 680

alt text


  • You'll need Python3.

  • Clone the repository

git clone
  • Run pip install -r requirements.txt

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

pgn2gif-1.0.tar.gz (5.6 kB view hashes)

Uploaded source

Built Distribution

pgn2gif-1.0-py3-none-any.whl (5.5 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