fusebead

Turn a photo into a fuse-bead pattern: a pegboard grid, the nearest bead color, a printable PNG, and a color-count chart.

Color matching follows the ROCKIMG fuse-bead pattern maker: sRGB to CIE Lab, CIE76 distance, the same brightness and contrast sliders, and the same three palettes.

Perler, Hama, and Artkal are trademarks of their owners. This package is not affiliated with those brands. Palette RGB values are the approximations used by the website, not official manufacturer color cards.

Install

pip install fusebead

From a checkout of this repository:

pip install -e packages/fusebead

Requires Python 3.9+ and Pillow.

Library

from fusebead import Pattern

pattern = Pattern.from_image(
    "cat.png",
    palette="perler",      # perler, hama, or artkal
    grid_width=50,         # max pegs on the long side; aspect ratio is kept
    grid_height=50,
    brightness=0,          # website slider range is -80..80
    contrast=0,
    remove_background=True,
)
pattern.save_png("pattern.png")
pattern.save_csv("beads.csv")

pattern.width, pattern.height
pattern.total
pattern.cell(0, 0)          # BeadColor or None when the background was removed
pattern.entries[0].color.code
pattern.entries[0].count

Phone photos are rotated with EXIF orientation before sampling. The website canvas does not do that step.

Command line

fusebead cat.png -o pattern.png --csv beads.csv --palette hama --width 40 --height 40 --remove-bg

--no-grid draws beads flush. --bead-size sets the peg diameter in pixels. By default the PNG width follows the source image, capped at 1000 pixels, and each peg is at least 4 pixels.