CollisionStoneGuard (CSG) Image Tool

The CSG Image Tool is a streamlined local web application designed to process and upload product photos directly to a WooCommerce store. It simplifies the workflow of importing, processing (background removal, watermarking), and uploading images.

Features

1. 🚀 Quick Start Local Server

start.bat Launcher: Automatically detects Python or Node.js on your machine to start a local web server (required for API access and image processing capabilities) and opens the application in your default browser.

2. 📥 Import

Drag & Drop: Easily drag and drop images directly into the browser.
Folder Support: Select individual files or entire folders of images at once.

3. 🛠️ Image Processing & Batch Editing

Background Removal: Automatically removes photo backgrounds. Includes an adjustable color tolerance slider for precision.
Center & Crop: Automatically crops to the subject and centers it on a square canvas.
Drop Shadow: Adds a soft, professional drop shadow to the subject.
Solid Black (Silhouette): Turn parts into a solid black silhouette (ideal for black objects with glare).
Watermarking: Automatically overlays the CSG watermark. Includes options to upload custom watermarks, change opacity, and adjust size.
Adjustable Quality & Size: Slider for image quality (compression) and options to set the maximum image dimension to keep file sizes optimized.

4. 🎨 Individual Image Editor

Access the editor to fine-tune individual photos:

Move Watermark: Click and drag the logo to reposition it per image.
Box & Lasso Cutout: Draw a rectangle or freehand shape to clear anything outside the subject.
Lasso Erase: Draw a shape around leftover shadows or background artifacts to manually delete them.
Nudge Part: Click and drag the product to fine-tune its position in the frame.
White Preview: Toggle a solid white background instead of the transparent checkerboard for a better preview.
Reset: Undo manual changes on an image-by-image basis.

5. ☁️ Direct WooCommerce Upload

WooCommerce REST API Integration: Configure your Site URL, Consumer Key, and Consumer Secret to upload processed photos directly to your store.
WordPress Application Passwords: Support for WP Auth to bypass 401 Unauthorized errors when uploading to the Media Library.
Upload Log: Real-time logging of upload success or failure for bulk jobs.

Requirements

To run this tool locally, you need either:

Python 3 (Recommended) or
Node.js (npm/npx)

Simply run start.bat to begin!

2.6 KiB Raw Blame History