Turn your image folders into stunning videos or GIFs with a single Python script! Mache is a lightweight, flexible tool for anyone who wants to quickly create media from images—perfect for slideshows, demos, or social sharing.

What It Does

Mache takes a directory of images and stitches them into a video or GIF, supporting custom frame durations, multiple formats, and advanced image types (including HEIC/HEIF). Whether you want a quick GIF or a high-quality MP4, Mache makes it easy.

Key Features

• Multi-format output: mp4, gif, webm, avi, mov, mkv, wmv
• Custom frame durations: Set timing for any image, skip frames
• HEIC/HEIF support: Works with modern phone images
• Simple CLI: One command to create your video or GIF
• Lightweight & fast: Minimal dependencies, quick results

Quick Setup

1. Clone & Install bash git clone <repository-url> cd <repository-folder> pip install -r requirements.txt

2. Prepare Your Images Place your images in the /img directory.

3. Create Your Video or GIF bash python make_video.py --folder ./img --format mp4 --output myvideo --duration 0.2 --override

See all options: bash python make_video.py --help

Example: Custom durations for first and last frame, resize to 720p height: bash python make_video.py --resize_height 720 --format mp4 --di "[(0,1),(-1,2)]" --override

The rendering of a mache sprout growing in animated webp from a list of HEIC images :

Technical Specs

• Formats: mp4, gif, webm, avi, mov, mkv, wmv
• Dependencies: opencv-python, Pillow, imageio, pillow-heif, numpy
• Optional: FFmpeg for best compatibility
• Directory Structure:
  • /img — input images
  • make_video.py — main script
  • README.md — docs
  • requirements.txt — dependencies

License

This project is licensed under the WTFPL License.

Links:

• GitHub: 4skl/Mache