# RefColorSync 2.0 — Auto-Paint from Reference + Cursor Color Sync

**URL:** https://community.aseprite.org/t/refcolorsync-2-0-auto-paint-from-reference-cursor-color-sync/28835
**Category:** Scripts & Extensions
**Created:** [September 23, 2026, 4:58am UTC](https://community.aseprite.org/t/refcolorsync-2-0-auto-paint-from-reference-cursor-color-sync/28835 "2026-09-23T04:58:53Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![alalal\_68](https://community.aseprite.org/user_avatar/community.aseprite.org/alalal_68/32/28332_2.png) [@alalal\_68](https://community.aseprite.org/u/alalal_68)
#### Post date: [September 23, 2026, 4:58am UTC](https://community.aseprite.org/t/refcolorsync-2-0-auto-paint-from-reference-cursor-color-sync/28835/1 "2026-09-23T04:58:53Z")

</div>

RefColorSync is an extension for Aseprite built for pixel artists who draw  
from reference images.

It has two independent modes:

🖱 **Cursor Color Sync** — automatically samples the foreground color from  
a reference layer as you move your cursor over the canvas. No more manual  
color-picking every few strokes.

🖌 **Auto-Paint from Reference** — gradually fills in the empty (transparent)  
pixels of your active layer using the reference as a source, one small batch  
at a time. It never touches pixels you’ve already drawn by hand — every tick  
re-checks the target before writing, so your manual work is always safe.

**Highlights:**

- Raster or Random paint order, with adjustable speed (ticks/sec and pixels/tick)
- Live progress bar while Auto-Paint runs
- Works with nested/grouped reference layers (recursive search)
- Sample from a single layer or the full composite
- Supports RGB, Indexed, and Grayscale color modes
- Clean, honest Undo — one Ctrl+Z undoes one tick, not the whole run
- Bounding-box optimization so large canvases stay fast

Fully tested in Aseprite’s real Lua runtime (not a mock), covering edge  
cases like closing the sprite, deleting the layer, locking the target, or  
switching frames mid-run.

📦 GitHub (download + source):

> **[GitHub - alalal68-wq/RefColorSync\_V2.0: Aseprite extension: syncs the foreground color to...](https://github.com/alalal68-wq/RefColorSync_V2.0)**
>
> Aseprite extension: syncs the foreground color to the pixel under your cursor from a reference layer, and can auto-paint empty pixels from that reference in the background — preserving your hand-drawn work. Supports RGB/Indexed/Grayscale, nested layers, composite sampling, and full Undo control.

🎥 There’s also a video walkthrough of the extension — I’ll drop the link  
in the comments below once I’m able to post more links.

Feedback, bug reports, and feature suggestions are very welcome!