superwand 0.1.3

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.

Color Themes

Themes included:

Example: Charizard

Gallery

Rio De Janeiro Skyline

Austin Ladybird Lake Plankton rendered in ZIT

Me in Rio de Janeiro