---

maple allows you to composite images/text with templates into animated GIFs/Videos. templates/ has some fun ones to try!

Install

cargo install --path .

Requires Rust 1.80+. Video output requires ffmpeg.

Usage

maple --zip <template.zip> --in <image.png> --gif out.gif

Output

Flag	Description
--gif <path>	Animated GIF
--vid <path>	Video (ffmpeg required)
--save "frame_%06d.jpg"	Individual frames
--single	Single frame only

Transform

Flag	Description
-w/-H	Output dimensions
--auto_zoom	Auto-fit content
--start <n>	Starting frame offset
--first/--last	Frame range

Text

Flag	Description
--in "text:Hello"	Text as image layer
--font_size <n>	Size (default: 72)
--text_color "FF0000"	Hex color
--text_bg "FFFFFF"	Background hex

Multi-layer

--in img1.png img2.png      # Layers 1, 2
--in img1.png +img1b.png    # Both on layer 1

JSON Config

maple --json config.json

Examples

# Photo to toaster GIF
maple --zip templates/toaster.zip --in photo.jpg --gif out.gif

# Text billboard
maple --zip templates/billboard-cityscape.zip --in "text:SALE" --gif ad.gif

# Book cover + back
maple --zip templates/book.zip --in front.png back.png --vid book.mp4

Included Templates

back-tattoo, billboard-cityscape, book, circuitboard, flag, flag2, fortune-cookie, heart-locket, rubiks, toaster, valentine

License

MIT