# \[Extension\] Recolouriser

**URL:** <https://community.aseprite.org/t/extension-recolouriser/12011>\
**Category:** Scripts & Extensions\
**Created:** [December 4, 2021, 2:00am UTC](https://community.aseprite.org/t/extension-recolouriser/12011 "2021-12-04T02:00:40Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![surt](https://community.aseprite.org/user_avatar/community.aseprite.org/surt/32/7459_2.png) [@surt](https://community.aseprite.org/u/surt)\
**Post date:** [December 4, 2021, 2:00am UTC](https://community.aseprite.org/t/extension-recolouriser/12011/1 "2021-12-04T02:00:40Z")

</div>

**Recolouriser** is an extension to perform multiple ramp-to-ramp colour remappings.

Find it in menu at _Edit_ → _FX_ → _Recolouriser…_

**Note:** only been tested with _v1.3-beta_ so that may be a requirement.

**Features:**

- Apply mappings to pixels or palette
- Works with Indexed and RGB images
- Respects pixel selection and layer/frame selection
- Switch between multiple To ramps for each From ramp
- To and From ramps can differ in length
- Can save/load remappings in User Data

**Basic usage:**

- Select a ramp of colours in palette to map from
- Click _Add Mapping_
- Select a ramp of colours in palette to map to
- Click _Add Ramp_
- Click _Apply Mappings_

**Issues:**

- Due to limitations with Aseprite’s GUI scripting API each mapping uses a lot of vertical space which limits the usable number
- Misusing Shades controls for ramps and they automatically adjust to nearest colours when the palette is changed so editing palette after creating mappings or undoing after applying mapping to palette can produce iffy results
- Adding/removing mappings has to recreate the dialog from scratch and Aseprite has a bug with getting the window bounds in the current beta which means they can’t be restored so the dialog bounds will reset

> **[Releases · not-surt/aseprite-extensions](https://github.com/not-surt/aseprite-extensions/releases)**
>
> Extensions for Aseprite. Contribute to not-surt/aseprite-extensions development by creating an account on GitHub.

 ![Recolouriser](https://community.aseprite.org/uploads/default/original/2X/0/07fd1e2f95720568419487d8fe590b297efd2ef7.png)

---

<div class="post-metadata">

**Author:** ![surt](https://community.aseprite.org/user_avatar/community.aseprite.org/surt/32/7459_2.png) [@surt](https://community.aseprite.org/u/surt)\
**Post date:** [December 8, 2021, 6:26pm UTC](https://community.aseprite.org/t/extension-recolouriser/12011/2 "2021-12-08T18:26:46Z")

</div>

Was reported that it was broken with RGB images, should be fixed now.

> **[Release Recolouriser 0.0.2 · not-surt/aseprite-extensions](https://github.com/not-surt/aseprite-extensions/releases/tag/2021-12-09)**
