OverlayBatch

A small Python tool for batch-processing images with a transparent overlay.

About The Project

OverlayBatch watches a folder for new images, resizes them to a fixed output size, applies a transparent PNG overlay, and saves the result as final PNG files.

• Watches a folder and processes images automatically
• Resizes and center-crops each image to a consistent canvas
• Applies the same transparent overlay to every output image
• Supports continuous watching or a single batch run

Built With

• 
• 

(back to top)

Getting Started

Prerequisites

• Python 3.9+
• pip

Installation

1. Clone the repository

   git clone https://github.com/webjocke/OverlayBatch.git
   cd OverlayBatch

2. Install the dependency

   pip install -r requirements.txt

Usage

Run the watcher with the default project folders:

python3 overlaybatch.py

Default behavior:

• Reads new images from input/
• Writes finished PNG files to output/
• Uses overlay.png as the overlay
• Produces images at 800x600

Run a single batch instead of a continuous watcher:

python3 overlaybatch.py

Example with custom folders and dimensions:

python3 overlaybatch.py \
  --watch-folder incoming \
  --output-folder exported \
  --overlay-image overlay.png \
  --width 1200 \
  --height 1200 \
  --keep-originals

(back to top)

Notes

• Supported formats include JPG, JPEG, PNG, WEBP, BMP, and TIFF
• Output files keep the original filename stem and are saved as .png

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)