#image #join

app stitchy

CLI tool to combine multiple image files into a single image

4 releases

0.1.5 Apr 29, 2023
0.1.4 Apr 22, 2022
0.1.3 Oct 14, 2020
0.1.2 Apr 29, 2020

#56 in Images

Download history 9/week @ 2023-02-09 15/week @ 2023-02-16 2/week @ 2023-02-23 2/week @ 2023-03-09 6/week @ 2023-04-06 1/week @ 2023-04-13 3/week @ 2023-04-20 27/week @ 2023-04-27 20/week @ 2023-05-04 7/week @ 2023-05-11 13/week @ 2023-05-18 9/week @ 2023-05-25

51 downloads per month

MIT license


Stitchy CLI

example workflow Crates.io

Joins multiple existing image files into a single output. Supports various flags for arranging the output, choosing the image format, or scaling down to desirable dimensions.

This crate is a CLI tool which wraps the features of the stitchy-core crate, adding configuration capabilities using command-line arguments and profile defaults, and adding file output.


Performed with a simple command that operates on the current directory:

stitchy n

where n is the number of images you would like to stitch together into one. The tool will take the n most recent files and arrange them in a grid, resizing where needed, and outputting a file "stitch.jpg".

Various flags exist to adjust how source images are selected and how the output is generated. Run stitchy --help to see a list of these flags.


  • Install Rust and Cargo if you don't already have them - see the official documentation at https://www.rust-lang.org/tools/install to install rustup and cargo and set up a toolchain
  • Run cargo install stitchy

That's it! The binary will be built from source and placed in the .cargo/bin directory inside your home folder. This should be available on your PATH if Cargo is installed correctly.

Note that this crate will only compile with Rust version 1.56 and up.


If you are using NetBSD, stitchy is available from the official repositories. Simply run,

pkgin install stitchy

to install the binary package


  • Input files may be in JPEG, PNG, GIF or BMP format, and are taken from the current directory. The output format will match the source images if they are all the same, or default to JPEG otherwise. Flags can be used to require a particular output format.
  • Compatible with Windows, macOS, Linux and NetBSD.


~172K SLoC