https://github.com/bradsec/goimagegrid

A Go program to generate image grids
https://github.com/bradsec/goimagegrid

image-crop image-grid image-resize image-tiles

Last synced: 3 months ago
JSON representation

A Go program to generate image grids

• Host: GitHub
• URL: https://github.com/bradsec/goimagegrid
• Owner: bradsec
• License: mit
• Created: 2024-07-26T06:43:28.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-07-26T06:45:48.000Z (11 months ago)
• Last Synced: 2025-01-07T17:24:24.439Z (5 months ago)
• Topics: image-crop, image-grid, image-resize, image-tiles
• Language: Go
• Homepage:
• Size: 23.3 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GOIMAGEGRID

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

## Features

- 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

## Requirements

- Go 1.20 or higher

## Installing

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:

```terminal

go install github.com/bradsec/goimagegrid@latest

```

## Usage

Run the program with the following command:

```

./goimagegrid [flags]

```

### 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)

### Samples

**Source images from [Pexels](https://www.pexels.com/)**

![Sample Images](output/nonames/grid_001.jpg)

![Sample Images](output/nonames/grid_002.jpg)

  

With `-n` option adds image names:

![Sample Images](output/grid_001.jpg)

![Sample Images](output/grid_002.jpg)

## License

This project is licensed under the MIT License.