superwand 0.2.2

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

uv sync

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 (default: False).
• -gradient: Gradient style (none, auto, vertical, horizontal, radial, bottom-up, top-down, left-right, right-left) (default: none). When a theme is applied, the gradient transitions from the primary theme color of the region to the next color in the theme.
• -polarity: Gradient midpoint bias (0.0 to 1.0, default: 0.5). 0.5 is linear, lower values bias towards the start color, higher values bias towards the end color.

Enforce Gradients

gradient-enforce examples/images/charizard.png --style radial --color1 "#FF0000" --color2 "#0000FF"

Arguments

• image_path: Path to the input image.
• --style: Direction of gradients (auto, vertical, horizontal, radial, bottom-up, top-down, left-right, right-left) (default: auto).
• --completeness: Impacted regions (auto, aggressive, filter) (default: auto).
• --opacity: Opacity handling (default: auto).
• --polarity: Gradient midpoint bias (0.0 to 1.0, default: 0.5).
• --output: Path to the output image (default: gradient_<style>_.png).
• --color1: Start color for the gradient (e.g., '255,0,0' or '#FF0000').
• --color2: End color for the gradient (e.g., '0,0,255' or '#0000FF').

Note on Colors: By default, the start and end colors are automatically derived from each region's original color by adjusting its brightness. To explicitly define the gradient colors, use --color1 and --color2. When provided, all prominent regions will be replaced with a gradient transitioning between these two colors.

Gradients

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

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
Safari	Urban	Neon	Tropical	Paixão
Vaporwave	Cyberpunk	Retro80s	Sunset	Midnight

Example: Charizard

Spring	Summer	Fall	Winter	Arctic
Safari	Urban	Neon	Tropical	Paixão
Vaporwave	Cyberpunk	Retro80s	Sunset	Midnight

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