Skip to content

mgjules/batimag

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

batimag

Go Doc License

Batimag is short for Batch Imager which applies basic image processing functions to a batch of images in a specific directory recursively.

JPG/JPEG, GIF, PNG, TIF/TIFF, BMP and WEBP images are supported.

Installation

From Source (recommended)

go install github.com/mgjules/batimag@v0.1.3

From Binary

Download the corresponding binary for your operating system and architecture from the releases page and place it in a $PATH directory.

Usage

❯ batimag
NAME:
   batimag - Batch Image Processor!

USAGE:
   batimag [global options] command [command options] [arguments...]

DESCRIPTION:
   Batimag applies a set of image processing functions to images in a given directory recursively.

AUTHOR:
   Michaël Giovanni Jules <julesmichaelgiovanni@gmail.com>

COMMANDS:
   process     Process some images!
   version, v  Shows the version
   help, h     Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help

COPYRIGHT:
   (c) 2023 Michaël Giovanni Jules
❯ batimag help process
NAME:
   batimag process - Process some images!

USAGE:
   batimag process [command options] [arguments...]

OPTIONS:
   --debug              run in debug mode (default: false)
   --clean              remove images in output directory (default: false)
   --config-path value  path to config file (default: config.yml)
   --help, -h           show help

Example usage

Run batimag using the default configuration file config.yml.

batimag process --clean --debug

Configuration

Example configuration (see config.example.yml):

input_dir: "./samples/input"
output_dir: "./samples/output"
resize:
  # Desired width in pixels.
  # Zero value will resize image proportionally to height.
  # Default value: 0.
  width: 100
  # Desired height in pixels.
  # Zero value will resize image proportionally to width.
  # Default value: 0.
  height: 50
  # Whether to upscale.
  # Default value: false.
  upscale: true
  # Resize type.
  # Accepted values: Normal, Thumbnail, Fit and Fill.
  # Default value: Normal.
  type: Normal
  # Resize resampling filter.
  # Accepted values: Lanczos, CatmullRom, MitchellNetravali, Linear, Box and NearestNeighbor.
  # Default value: Lanczos.
  filter: Lanczos
  # Anchor is used for image alignment when using Resize Type 'Fill'.
  # Accepted values: Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom and BottomRight.
  # Default value: Center.
  anchor: Center
transform:
  # Automatically fix orientation after processing.
  # Default value: false.
  auto_orientation: true
  # Rotate clockwise by certain angle in degrees.
  # Accepted values: 0 90 180 270.
  # Default value: 0.
  rotate: 90
  # Flip on a certain axis.
  # Accepted values: Vertical and Horizontal.
  # Default value: None.
  flip: Vertical
effect:
  # Strength of the gaussian blur effect.
  # Accepted values: 0.0 to 5.0.
  # Default value: 0.
  gaussian_blur: 2.0
  # Strength of the sharpening effect.
  # Accepted values: 0.0 to 5.0.
  # Default value: 0.
  sharpen: 1.0
adjust:
  # Gamma correction.
  # Accepted values: 0.0 to 5.0.
  # Values less that 1.0 are darker while values greater than 1.0 are lighter.
  # Default value: 0.
  gamma: 0.5
  # Percentage value.
  # Accepted values: -100 to 100.
  # Negative values are grayer.
  # Default value: 0.
  contrast: 50
  # Percentage value.
  # Accepted values: -100 to 100.
  # Lower negative values are darker while higher positive values are lighter.
  # Default value: 0.
  brightness: 50
  # Percentage value.
  # Accepted values: -100 to 100.
  # Negative values decrease image saturation while positive values increase image saturation.
  # Default value: 0.
  saturation: 50
  # Grayscale version.
  # Default value: false.
  grayscale: true

Credits

Stability

This project follows SemVer strictly and is not yet v1.

Breaking changes might be introduced until v1 is released.

This project follows the Go Release Policy. Each major version of Go is supported until there are two newer major releases.