How do I connect two GIFs to play one after another in Python?

Question:

If I have two GIFs, GIF 1 being 10 seconds long and GIF 2 being 5 seconds long, is there a way to connect them so the final GIF is a total of 15 seconds long?

Would I have to loop through each frame of both the GIFs with imageio.mimread() and output, once all the frames are read in memory?

Or is there another way by knowing the start and end times and shifting it?

Edit:
The solution presented by FirefoxMetzger is extremely Pythonic, ideal if you do not wish to install other software / packages like gifsicle.

import imageio.v3 as iio
import numpy as np

frames = np.vstack([
    iio.imread("imageio1.gif"),
    iio.imread("imageio2.gif"),
])

# get duration each frame is displayed
iio.imwrite("imageio_combined.gif", frames)

This completes in 15.6 seconds for two GIFs, each containing 100 frames.

However, if runtime is important, I recommend gifsicle:

gifsicle(
    sources=["imageio1.gif", "imageio2.gif"], # or just omit it and will use the first source provided.
    destination="imageio3.gif",
    options=["--optimize=2", "--threads=2", "--no-conserve-memory"]
)

This completes in 4.8 seconds, which is three times as fast.

Asked By: Andrew

||

Answers:

I think this works:

from pygifsicle import gifsicle

gifsicle(
    sources=["imageio_00.gif", "imageio_01.gif"], # or a single_file.gif
    destination="destination.gif", # or just omit it and will use the first source provided.
    optimize=True, # Whetever to add the optimize flag of not
    colors=256, # Number of colors t use
    options=["--verbose"] # Options to use.
)
Answered By: Andrew

You already found a way to do it, but as you were referring to imageio let me add an answer using it. At least in the old imageio v2 API it was a pretty straightforward business too even if more verbose.

import imageio

gif_1 = imageio.get_reader(path_gif_1)
gif_2 = imageio.get_reader(path_gif_2)

combined_gif = imageio.get_writer('combined.gif')

for frame in gif_1:
    combined_gif.append_data(frame)

for frame in gif_2:
    combined_gif.append_data(frame)

gif_1.close()
gif_2.close()    
combined_gif.close()
Answered By: Mr K.

The exact solution depends on whether your GIFs have the same FPS or not. If they do, you can simply concatenate them and are good to go.

import imageio.v3 as iio
import numpy as np

frames = np.vstack([
    iio.imread("my_first.gif"),
    iio.imread("my_second.gif"),
])

# get duration each frame is displayed
duration = iio.immeta("my_first.gif")["duration"]

iio.imwrite("combined.gif", frames, duration=duration)

If the GIFs do not have the same framerate things get a little bit more complicated. Here, you will first have to normalize the FPS of both GIFs before concatenating them. I’d recommend using ImageIO’s pyav plugin for this, which allows delegating this procedure to FFMPEG:

import imageio.v3 as iio
import numpy as np

# make sure pyav is installed (pip install av)

frames = np.vstack([
    iio.imread(
        "my_first.gif",
        plugin="pyav",
        # normalize the GIF to 50 FPS
        filter_sequence=[("fps", "50")]
    ),
    iio.imread(
        "my_first.gif",
        plugin="pyav",
        # normalize the GIF to 50 FPS
        filter_sequence=[("fps", "50")]
    ),
])

iio.imwrite("combined.gif", frames, duration=50)
Answered By: FirefoxMetzger