gifing

A lightweight python tool for creating GIF

Quick start

Let's make a GIF with these images:

from gifing import GIF

path = "tests/img/image"
path_to_files = [f"{path}1.jpg", f"{path}2.jpg", f"{path}3.jpg",]

gif = GIF(
  path_to_files,
  frame_duration=500,      # in ms
  n_repeat_last_frame=3,   # 500x3
)
gif.set_background_color("red")
gif.set_size((900, 700), scale=1.2)
gif.make("img/output.gif")

This package offers:

• a streamlined approach to creating GIF
• automatic image resizing
• ability to set a background color during resizing

It's a basic prototype of the functionality I envision for this tool. The API is still unstable.

Installation

Install directly via pip (requires Python >=3.9):

pip install gifing

Usage

Import the GIF class and provide a list of image file paths:

from gifing import GIF

path = "tests/img"
gif = GIF(
    [f"{path}/image{i}.jpg" for i in range(1, 4)],
    frame_duration=800,  # Duration per frame (in milliseconds)
    n_repeat_last_frame=3,  # Repeat last frame 3x longer
)

You can set a background color, which is useful if your images have varying sizes:

gif.set_background_color("black")

You can also set a custom size for your GIF. The set_size method allows you to specify a target size and scale factor:

gif.set_size((300, 800), scale=2) # (600px, 1600px)

Finally, call the make() method to generate the GIF:

gif.make("path/to/output/file.gif")

If not specified, by default, the GIF will be saved as output.gif.