Automated Mockup Generator

Automatically generate hundreds of product mockups in seconds. Perfect for e-commerce, print-on-demand, and marketing teams.

Mockup Generator Demo

Features

Batch Processing - Generate all design x mockup combinations automatically
Smart Detection - Automatically detects placeholder boxes by color
Rotation Support - Handles angled/rotated design placements
Flexible Alignment - 9 alignment options (top-left to bottom-right)
Multiple Formats - PNG, JPEG, WebP output support
Parallel Processing - Fast generation with multi-threading
CLI & Python API - Use from command line or integrate into your workflow

Quick Start

Installation

pip install mockup-generator

Or install from source:

git clone https://github.com/CTDave001/automated_mockups.git
cd automated_mockups
pip install -e .

Basic Usage

Step 1: Prepare Your Mockup Templates

Create mockup templates with a colored placeholder box where designs should be placed:

mockups/
  ├── tshirt_front.png    # Has a red (#FF0000) box where design goes
  ├── tshirt_back.png
  └── hoodie_front.png

Step 2: Calculate Placeholder Positions

mockup-generator calculate --hex-color "#FF0000" --input mockups/ --output params.json

This analyzes your mockups and saves the position, size, and rotation of each placeholder.

Step 3: Generate Mockups

mockup-generator generate \
  --params params.json \
  --designs designs/ \
  --mockups mockups/ \
  --output output/

That's it! Your output/ folder now contains all combinations.

Python API

from mockup_generator import MockupCalculator, MockupGenerator, Color
Step 1: Calculate placeholder positions
calculator = MockupCalculator(Color.from_hex("#FF0000"))
params = calculator.process_directory("mockups/")
calculator.save_parameters(params, "params.json")
Step 2: Generate mockups
generator = MockupGenerator(params)
results = generator.generate_all(
    design_dir="designs/",
    mockup_dir="mockups/",
    output_dir="output/"
)
print(f"Generated {len([r for r in results if r.success])} mockups!")

CLI Reference

Calculate Command

Analyzes mockup templates to find placeholder boxes.

mockup-generator calculate [OPTIONS]

Options: --color R G B Target color as RGB (e.g., --color 255 0 0) --hex-color HEX Target color as hex (e.g., --hex-color "#FF0000") -i, --input DIR Input directory with mockup templates (required) -o, --output FILE Output JSON file (default: parameters.json) --tolerance N Color matching tolerance 0-255 (default: 30) --recursive Process subdirectories -v, --verbose Show detailed output

Generate Command

Creates mockups from designs and templates.

mockup-generator generate [OPTIONS]
Options:   -p, --params FILE    Parameters JSON file (required)   -d, --designs DIR    Directory with design images (required)   -m, --mockups DIR    Directory with mockup templates (required)   -o, --output DIR     Output directory (required)   --alignment ALIGN    Design alignment: topleft, topcenter, top_right,                        centerleft, center, centerright, bottom_left,                        bottomcenter, bottomright (default: top_center)   --scale-mode MODE    Scaling: fit, fill, stretch, none (default: fit)   --format FORMAT      Output format: PNG, JPEG, WEBP (default: PNG)   --quality N          JPEG quality 1-100 (default: 95)   --pattern PATTERN    Output naming pattern (default: {design}_{mockup})   --no-parallel        Disable parallel processing   --workers N          Number of parallel workers (default: 4)

Configuration Options

Alignment Modes

| Alignment | Description | |-----------|-------------| | top_left | Design aligned to top-left of placeholder | | top_center | Design centered horizontally, aligned to top | | top_right | Design aligned to top-right | | center_left | Design centered vertically, aligned to left | | center | Design centered both ways | | center_right | Design centered vertically, aligned to right | | bottom_left | Design aligned to bottom-left | | bottom_center | Design centered horizontally, aligned to bottom | | bottom_right | Design aligned to bottom-right |

Scale Modes

| Mode | Description | |------|-------------| | fit | Scale to fit within placeholder, maintaining aspect ratio | | fill | Scale to fill placeholder completely (may crop) | | stretch | Stretch to exact placeholder size (ignores aspect ratio) | | none | Use original design size |

Use Cases

Print-on-Demand - Generate product previews for your POD store
E-commerce - Create product images for multiple colors/variants
Marketing - Quickly visualize designs on merchandise
Design Agencies - Present client designs on realistic mockups
Social Media - Generate promotional images at scale

Project Structure

automated_mockups/
├── mockup_generator/
│   ├── init.py       # Package exports
│   ├── calculator.py     # Box position detection
│   ├── generator.py      # Mockup generation
│   ├── cli.py           # Command-line interface
│   └── utils.py         # Utilities and helpers
├── examples/
│   ├── designs/         # Sample design files
│   ├── mockups/         # Sample mockup templates
│   └── output/          # Generated mockups
├── tests/               # Unit tests
├── pyproject.toml       # Package configuration
└── README.md