Skip to content

Perform color correction on images using the ColorCorrectionPackage. Upload images, detect color charts, run color correction, visualize and save results.

License

Notifications You must be signed in to change notification settings

collinswakholi/ColorCorrectionPackage_UI

Repository files navigation

Color Correction Package UI

A modern web-based user interface for the ColorCorrectionPackage.

Overview

This application provides an intuitive React frontend paired with a Flask backend to perform color correction on images using the ColorCorrectionPackage pipeline. Upload images, detect color charts, run color correction, and visualize results.

Screenshot

Color Correction UI Upload images, detect color charts, and visualize correction results in real-time

Download Pre-built Executables

Get the latest release for your operating system.

Latest Release

Visit the Releases page to download:

  • Windows:

    • ColorCorrector-Setup-Windows-x64.exe - For Intel/AMD 64-bit processors
    • Double-click the installer and follow the wizard
    • Launch from Start Menu or Desktop shortcut
    • Browser opens automatically to http://localhost:5000
    • Note: May show Windows Defender warning (unsigned app) - click "More info" → "Run anyway"
  • macOS:

    • ColorCorrector-macOS-x86_64.dmg - For Intel Macs
    • ColorCorrector-macOS-arm64.dmg - For Apple Silicon (M1/M2/M3) - Native ARM64 build
    • Open the DMG file and drag ColorCorrector to Applications folder
    • Launch from Applications
    • Browser opens automatically to http://localhost:5000
    • Note: First run requires right-click → "Open" (unsigned app)
    • Apple Silicon users: Use the arm64 version for best performance (no Rosetta translation)
  • Linux:

    • ColorCorrector-Linux-x86_64.AppImage - For Intel/AMD 64-bit
    • Make executable: chmod +x ColorCorrector-Linux-*.AppImage
    • Run: ./ColorCorrector-Linux-*.AppImage
    • Browser opens automatically to http://localhost:5000
    • No installation required - runs directly

All installers are self-contained with the web interface included. No dependencies, no manual setup!

Features

  • Eash image upload with batch processing support
  • Automatic color chart detection using the ColorCorrectionPipeline
  • One-click color correction with visual before/after comparison
  • Interactive scatter plots showing correction quality
  • Downloadable results (corrected images and Model artefacts)
  • Cross-platform packaging (Windows EXE, macOS, Linux, Docker)

Quick Start

Docker (Recommended)

docker pull collins137/colorcorrector:latest
docker run -p 5000:5000 collins137/colorcorrector:latest

Open http://localhost:5000 in your browser.

Local Development

Prerequisites: Python 3.12+, Node.js 18+

  1. Backend:

    cd backend
    pip install -r requirements.txt
    python server_enhanced.py
  2. Frontend:

    cd frontend
    npm install
    npm run dev

Visit http://localhost:5173 (Vite dev) or http://localhost:5000 (Flask serves built frontend).

Building

Standalone Executable

cd frontend && npm run build
cd ../backend
pyinstaller -y colorcorrector.spec

The executable will be in backend/dist/ColorCorrector/.

Docker Image

docker build -t colorcorrector -f backend/Dockerfile .

Architecture

  • Frontend: React + Vite + Tailwind CSS
  • Backend: Flask REST API wrapping the ColorCorrectionPipeline
  • Core Library: ColorCorrectionPackage

License

See LICENSE.txt

Credits

This UI implementation wraps the ColorCorrectionPackage by Collins Wakholi.