gifpgn 0.2.0

Convert a PGN into a GIF with stockfish evaluation chart

gifpgn

Generate a GIF of a chess game from a PGN with optional stockfish analysis chart.

Demo

Stockfish analysis and move arrows:

Board only, small:

Installation

pip install gifpgn

For stockfish analysis a local stockfish binary is required. For best performance you can compile your own with support for the fastest instruction sets available on your hardware. Alternatively you can install using your distribution's package manager.

eg. apt-get install stockfish

Usage

1. Import the package:

from gifpgn import CreateGifFromPGN

2. Initialise the class:

   • Using a PGN string:

   gif = CreateGifFromPGN(pgn_string)

   • Using a PGN file:

   gif = CreateGifFromPGN(path_to_pgn,pgn_file=True)

3. Optionally enable stockfish evaluation:

gif.enable_evaluation()

Stockfish evaluation is expensive and may take a large amount of time to complete.

The default depth of 18 provides a reasonable trade-off of time versus accuracy. Reducing this number will significantly reduce processing time.

Please see the enable_evaluation documentation below for configuation options for numbers of threads and memory usage.

4. Optionally enable move arrows:

gif.enable_arrows = True

5. Generate the GIF:

gif.generate(output_file_path)

See reference section for optional parameters.

Reference

class  CreateGifFromPGN()

Arguments:

• pgn str - PGN as a string or filepath. Filepath requires optional parameter pgn_file=True
• reverse bool, optional - Whether board should be reversed. Defaults to False.
• duration float, optional - Duration of each GIF frame in seconds. Defaults to 0.5.
• pgn_file bool, optional - Specify whether pgn contains a pgn string [False] or filepath [True]. Defaults to False.

Properties

• board_size int - Size of the board in pixels. Defaults to 480.
• bar_size int - Width of the evaluation bar in pixels. Defaults to 30.
• graph_size int - Height of the evaluation graph in pixels. Defaults to 81.
• ws_color str - Color of the white squares. Defaults to "#f0d9b5".
• bs_color str - Color of the black squares. Defaults to "#b58863".
• max_eval int - Maximum position evaluation in centipawns. Defaults to 1000.
• enable_arrows bool - Enable move arrows. Defaults to [False].

enable_evaluation

| enable_evaluation(path_to_stockfish='stockfish', depth: int = 18, threads: int = 1, memory: int = 1024)

Enable stockfish evaluation

Arguments:

• path_to_stockfish str, optional - Path to stockfish binary. Defaults to 'stockfish'.
• depth int, optional - Depth of stockfish evaluation. Defaults to 18.
• threads int, optional - Number of threads to use in stockfish evaluation. Defaults to 1.
• memory int, optional - Amount of memory to use in stockfish evaluation in Mb. Defaults to 1024.

generate

| generate(output_file: str)

Output GIF

Arguments:

• output_file str - Full path and filename of output file