explaingit

nklbdev/aseprite-stamp-brush

Analysis updated 2026-05-18

4LuaAudience · designerComplexity · 2/5LicenseSetup · easy

TLDR

An Aseprite extension that adds a clone stamp brush for copying pixel art from one part of an image to another, with soft edges and tiling support.

Mindmap

mindmap
  root((aseprite-stamp-brush))
    What it does
      Clone stamp painting
      Soft brush mask
      Tiled canvas preview
    Tech stack
      Lua
      Aseprite extension
    Use cases
      Pixel art retouching
      Seamless tile patterns
      Selection masked painting
    Audience
      Pixel artists
      Aseprite users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clone and retouch parts of a pixel art sprite using a soft edged stamp brush

USE CASE 2

Preview and paint across tiling seams using the extension's tiled canvas mode

USE CASE 3

Fix overlapping brush strokes without visible seams using max alpha blending

What is it built with?

LuaAseprite

How does it compare?

nklbdev/aseprite-stamp-brushk0nserv/dotfilesorlp/ncui
Stars433
LanguageLuaLuaLua
Last pushed2026-05-022015-03-13
MaintenanceMaintainedDormant
Setup difficultyeasyeasymoderate
Complexity2/52/51/5
Audiencedesignerdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Aseprite 1.3 or newer, install the extension file through Aseprite's Preferences menu.

Free to use, modify, and share for any purpose under the MIT license.

In plain English

This is an extension for Aseprite, a popular pixel art drawing program, that adds a clone stamp brush tool. A clone stamp lets you pick a source area of your image and then paint copies of it elsewhere, the same way a clone stamp tool works in other image editors. You click to choose a source point, then click and drag to paint with that sampled area, and you can set a new source point at any time to keep copying from different places, including your own earlier strokes. The brush includes a soft edged mask with adjustable radius, softness, and opacity, so strokes blend smoothly instead of having hard edges. Overlapping strokes do not create visible seams or double darkening, because the tool tracks the strongest coverage per pixel for each stroke and applies it once. There is also a tiled canvas mode that shows the image repeated in a grid, useful for both checking how a pattern tiles and for painting across those tile boundaries. You can pan around the canvas by dragging with the middle mouse button and zoom in and out with the mouse wheel. If you make a selection first, the brush only paints inside that selected area, and the selection outline is drawn so it stays visible against any background color. Painting outside the edge of the current layer automatically grows the layer to fit the new pixels, matching how Aseprite's own tools behave. The tool keeps its own undo and redo history separate from strokes, and if you accidentally close its window you can choose to apply your changes, discard them, or keep editing. To install it, you download a single extension file from the project's releases page and either double click it or add it through Aseprite's extension preferences, after which a Clone Stamp command appears in the Edit menu. It works with Aseprite version 1.3 and newer. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through installing the aseprite-stamp-brush extension and assigning it a keyboard shortcut
Prompt 2
Explain how tiled mode in aseprite-stamp-brush helps me paint a seamless repeating pattern
Prompt 3
Help me troubleshoot why the clone stamp brush in Aseprite won't paint outside my current cel
Prompt 4
Show me the mouse and keyboard controls for using the Clone Stamp tool in Aseprite

Frequently asked questions

What is aseprite-stamp-brush?

An Aseprite extension that adds a clone stamp brush for copying pixel art from one part of an image to another, with soft edges and tiling support.

What language is aseprite-stamp-brush written in?

Mainly Lua. The stack also includes Lua, Aseprite.

What license does aseprite-stamp-brush use?

Free to use, modify, and share for any purpose under the MIT license.

How hard is aseprite-stamp-brush to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is aseprite-stamp-brush for?

Mainly designer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.