Stitchy

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

Images of the same size will stitch together neatly:

| Input files | | | Output | | --- | --- | --- | --- | | Sample 1 | Sample 2 | Sample 3 | Sample Output |

If the images are more irregular in shape, the tool will attempt to arrange them as neatly as possible, and scale some images in the process:

| Input files | | | | Output | | --- | --- | --- | --- | --- | | Sample 1 | Sample 2 | Sample 3 | | Sample Output |

Running

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 the output is created. Run stitchy --help to see a list of these flags.

Installing

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 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.34 and up, due to a dependency.

Details

Input files may be in JPEG, PNG, GIF or BMP format, while the output will always be a JPEG file named "stitchy.jpg". Operates entirely within the current directory.
This project has currently only been tested (minimally) on 64-bit Windows using nightly Rust and the GNU toolchain, i.e. nightly-x86_64-pc-windows-gnu. Testing the MSVC toolchain, as well as the GNU toolchain on Linux, is likely to come soon.