gif — gif recording

The gif module is used for gif recording.

class Gif – Gif recorder

You can use the gif module to record small video clips. Note that gif files save uncompressed image data. So, they are best for recording short video clips that you want to share. Use mjpeg for long clips.

Example usage:

import sensor, gif

# Setup camera.

# Create the gif object.
g = gif.Gif("example.gif")

# Add frames.
for i in range(100):

# Finalize.


class gif.Gif(filename[, width[, height[, color[, loop=True]]]])

Create a Gif object which you can add frames to. filename is the path to save the gif recording to.

width is automatically set equal to the image sensor horizontal resolution unless explicitly overridden.

height is automatically set equal to the image sensor vertical resolution unless explicitly overridden.

color is automatically set equal to the image sensor color mode unless explicitly overridden:

loop when True results in the gif automatically looping on playback.



Returns the width (horizontal resolution) for the gif object.


Returns the height (vertical resolution) for the gif object.


Returns sensor.RGB565 if color is True or sensor.GRAYSCALE if not.


Returns the file size of the gif so far. This value is updated after adding frames.


Returns if the gif object had loop set in its constructor.

add_frame(image[, delay=10])

Add an image to the gif recording. The image width, height, and color mode, must be equal to the same width, height, and color modes used in the constructor for the gif.

delay is the number of centi-seconds to wait before displaying this frame after the previous frame (if not the first frame).


Finalizes the gif recording. This method must be called once the recording is complete to make the file viewable.