Perler Pattern Generator for Openclaw

A sophisticated Python-based utility that converts standard images into customizable, print-ready perler bead patterns with automated background removal.

tobewin
v1.2.0
Mar 22, 2026
0
861
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install perler-pattern

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install perler-pattern using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Perler Pattern Generator?

The Perler Pattern Generator is a specialized tool within the Openclaw Skills ecosystem designed for hobbyists and digital creators. It utilizes the GrabCut algorithm to perform fully offline background removal, ensuring privacy and zero API costs. By processing images through the Lab color space for superior accuracy, it maps pixels to real-world bead palettes like Hama, Artkal, and Perler, producing professional-grade design assets.

This skill goes beyond simple pixelation by generating a suite of useful outputs: an interactive HTML viewer for digital tracking, print-ready SVGs with color-coded numbering, 3D bead previews for realistic visualization, and a comprehensive shopping list for required materials. It bridges the gap between digital photography and physical bead artistry with technical precision.

Perler Pattern Generator Use Cases

  • Creating custom bead patterns from photos of pets or family members.
  • Converting cartoon and anime characters into pixel-perfect fuse bead templates.
  • Generating brand-specific logos and icons for physical merchandise using universal palettes.
  • Preparing large-scale Artkal or Hama projects with precise bead count estimations and color codes.

How Perler Pattern Generator Works

  1. The user provides an image via a local path or URL along with desired grid dimensions and bead palette preferences.
  2. The system executes an offline GrabCut process to isolate the subject and apply a clean background contrast.
  3. The image is resized and center-cropped to the target grid dimensions (e.g., 29x29 for single boards up to 64x64).
  4. Brightness and contrast are normalized using Lab color space equalization and Unsharp Mask sharpening.
  5. Pixels are quantized and mapped to the nearest physical bead colors based on Delta-E distance calculations.
  6. A complete package of HTML, SVG, PNG, and TXT files is generated for the user to review and use.

Perler Pattern Generator Setup

Ensure your environment has Python 3 installed. You can verify and install the necessary libraries using the following commands:

# Check and install required packages
python3 -c "import cv2" 2>/dev/null || pip3 install opencv-python-headless --quiet
python3 -c "from PIL import Image" 2>/dev/null || pip3 install Pillow --quiet
python3 -c "import numpy" 2>/dev/null || pip3 install numpy --quiet
echo "Ready"

Perler Pattern Generator Data Schema & Taxonomy

The skill organizes generated assets in a dedicated output directory with the following structure:

File Format Description
pattern.html HTML/JS Interactive viewer with highlighting, zoom, and print controls.
pattern.svg SVG Vector template with grid lines and color-code numbers for printing.
preview_beads.png PNG A 3D-rendered preview simulating physical beads with shadows.
preview_flat.png PNG A high-resolution flat pixel-art preview.
bead_list.txt TXT A detailed manifest of bead codes, names, and exact quantities required.

Perler Pattern Generator Advanced Features

  • Support for multiple professional bead palettes: Hama, Artkal (C-series), Perler, and a Universal mix.
  • Lab Color Space processing for high-fidelity color matching that respects human visual perception.
  • Interactive HTML viewer featuring a 'bead highlighter' to isolate specific colors during the assembly process.
  • Dynamic grid resizing ranging from single-board 'small' (29x29) to 'xlarge' (64x64) layouts.
  • Automated bead count calculation to facilitate easy material procurement and project planning.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*