superwand 0.1.9

A tool for retheming images and CSS using color palettes and gradients.

superwand

Leverage magic wand to breath life to images, especially posterized and vector art images.

Setup

pip install .

SuperWand Studio

The SuperWand Studio provides an interactive web interface for real-time image retheming, CSS retheming, and gradient application.

Running the Studio

Simply run the superwand command without applying a theme:

superwand

Access the UI

Once the server is running, open your browser and navigate to http://127.0.0.1:5001.

CLI Usage

Apply a Theme

superwand examples/images/zebra.png -theme Urban

Arguments

• image_path: Path to the input image file (optional if starting studio).
• -theme: Theme to apply (Tropical, Urban, Winter, etc.).
• -k: Number of regions to identify (default 4).
• -tolerance: Color matching tolerance (default 50).
• -flood: Apply morphological flood filling.
• -gradient: Gradient style (none, auto, vertical, horizontal, radial).
• -intensity: Gradient intensity (0.0 to 1.0, default 0.2).
• --headless: Run in headless mode without opening the studio.

Enforce Gradients

gradient-enforce examples/images/charizard.png --style radial

Arguments

• image_path: Path to the input image.
• --style: Direction of gradients (auto, vertical, horizontal).
• --completeness: Impacted regions (auto, aggressive, filter).
• --opacity: Opacity handling.
• --intensity: Gradient dramaticism (0.0 to 1.0, default 0.2).
• --output: Path to the output image.

Gradients

Included: bottom-up, top-down, left-right, right-left, radial

CSS Retheming

Identify color schemes in CSS and replace with a theme.

Before	After

Color Themes

Themes included:

Spring	Summer	Winter	Fall	Arctic

Example: Charizard

Spring	Summer	Fall	Winter	Arctic

Gallery

Rio De Janeiro Skyline

Original	Arctic	Fall	Neon	Tropical

Austin Ladybird Lake Plankton rendered in ZIT

Original	Spring	Summer	Winter	Safari

Me in Rio de Janeiro

Original	Paixão	Urban	Arctic	Fall