Repository files navigation

goimagegrid is a Go program that creates image grids or walls from a collection of input images.

• Parallel image processing for improved performance
• Customisable grid dimensions
• Support for JPEG and PNG image formats
• Intelligent image cropping to find the most interesting areas
• Option to add image names to the grid

• Go 1.20 or higher

To install GOIMAGEGRID, you need to have Go installed on your system (https://go.dev/doc/install). Once you have Go installed, you can either clone the repo and run from source or download and install with the following command:

go install github.com/bradsec/goimagegrid@latest

Run the program with the following command:

./goimagegrid [flags]

• -w : Width of the grid thumbnail wall (default: 900)
• -h : Maximum height for a single grid image (default: 900)
• -c : Number of columns in the grid (default: 3)
• -i : Directory containing input images (default: "./input")
• -o : Directory to save output images (default: "output")
• -n : Add image names to the grid images (default: false)

Source images fromPexels

With-n option adds image names:

This project is licensed under the MIT License.