A downloadable tool for Windows, macOS, and Linux

Download NowName your own price

Magic Pencil is an extension for Aseprite that provides additional options for the pencil tool.

How to use the extension

Go to the Edit menu and click the Magic Pencil option, select an effect from the dialog window and use the pencil tool.

Please note that most options use magic colors, selected colors will be restored after closing the Magic Pencil dialog window or selecting the Regular option.


Tool [Outline] - adds an outline around a closed shape that you click on, works with foreground (left-click) and background (right-click) colors.

Brush [Outline] - adds an outline around the brush as you draw. After selecting this option, the outline's color can be changed under this option in the dialog window.

Lift - moves a part of the image into its own layer.

Unique [Mix] - mixes colors, left-click uses the RGB color model to mix colors, while right-click uses HSV.

Proportional [Mix] - mixes colors taking into account the number of pixels of each color, left-click uses the RGB color model to mix colors, while right-click uses HSV.

Colorize - changes color (hue), works with foreground (left-click) and background (right-click) colors.

Desaturate - removes color (hue) completely.

Hue/Saturation/Value/Lightness [Shift] - changes the colors based on the selected property, left-click to add, right-click to subtract. You can change how much of a shift will be applied by changing the percentage slider under these options.

Indexed Mode - when enabled, prevents new colors from being introduced, and any option that modifies colors will use colors from the palette.

Known issues

  • Using any option from the Magic Pencil on a completely empty cel will result in the first stroke being treated as a regular pencil
  • Selecting colors from the palette when using any option from the Magic Pencil other than Outline or Colorize (which actually use the selected color) will interfere with its working and result in odd behavior

See also

Updated 18 hours ago
PlatformsWindows, macOS, Linux
Rated 5.0 out of 5 stars
(15 total ratings)
AuthorKacper Woźniak
Tagsaseprite, Effects, extension, fx, Magic, pencil, Pixel Art, plugin, script, tool


Download NowName your own price

Click download now to get access to the following files:

Magic Pencil v1.0.3 2 MB
Magic Pencil v1.0.2 6 kB
Magic Pencil v1.0.1 6 kB
Magic Pencil v1.0.0 7 kB

Development log


Log in with itch.io to leave a comment.

Hey! It seems that the mix tool doesn't work well with the latest Aseprite version (it doesn't replace the template color by the mix).

Could you explain what you mean by the template color? Could you also provide information about what version of Aseprite are you using?

Sorry! I just figured out the problem. My pencil color mode was in "Copy Alpha+Color". This mode negate the mix effect (it just draw the pink alpha color of the tool). I don't know if this is a bug or expected behaviour, but there is an easy alternative so it's ok! 

Also I forgot to thank you for all your extension and awesome tools for aseprite! 

Oh, thank you for reporting it - this sounds like a missed cases, I’ll investigate this issue further. ✌

Doesn't seem to work for me, my foreground and background colors switch to an index which doesn't exist in the palette when I close the dialog, and I cannot select any of the tools while it is open.

I am using v1.3beta21, is the extension incompatible with beta atm?

I tested the extension with this version Aseprite - didn’t encounter any issues. What Color Mode are you using for the sprite - RGB or Indexed?

It was Indexed, switched it to RGB and everything seems to be working! Great tool 👍

This is one of the greatest plugins of all time.

(2 edits)

doesnt work to me

What version of Aseprite are you using? Do other extensions work for you?

v.1.2.29, but i will soon update it

Magic Pencil relies on events that were introduced in version 1.2.30, I believe the oldest version I tested this extension on was 1.2.35.

If you’d like to use this extention (and gor other reasons), I’d recommend to upgrade Aseprite to the newest, available version.

Where can do atomization effect ? I no find it ....
can you help me ?

I’m assuming that by atomisation you mean the simulated sand/water - they aren’t included in the Magic Pencil, they will be released separately in the future.

I meant blur tool , like it

I see, Magic Pencil doesn’t have that but Aseprite itself has a built-in Blur Tool.

Blur Tool

You are my Hero !


Thanks ✌️

I try 10 times, still got this error, install 1.02 or 1.03 same error.... can you help me ?

(1 edit)

You can try to:

  • Uninstall the extension first from Edit > Preferences > Extensions, it might throw this error, ignore it
  • Close and reopen Aseprite, make sure it’s removed in Prefer Edit > Preferences > Extensions
  • Try installing Magic Pencil fresh, v1.0.3 would be the best, this shouldn’t throw an error
  • Restart Aseprite and check does Magic Pencil appear in the Edit menu and does it work

If this doesn’t help, please provide:

  • Aseprite version
  • Operating system version I’ll try to investigate this issue further.

Cool, I got it

And I pay you $2 USD, good job! ^___^

(1 edit)

I’m glad it works 😃 Thanks!

I dont know if its a bug, but you can spawn another windows even though it's already appear?

99% chance it’s a bug, 1% it’s an extra feature - this is an untested case, thank you for reporting this!

Does the magic pencil work with indexed palettes?

Sadly, it doesn’t there are technical reasons for it, the current implementation makes it difficult. Until API changes or I find a solution to make it work reliably it’s only for RGB color mode.

However, it does have an Indexed Mode which restricts all colors to the current palette, which means no function of the Magic Pencil will introduce new colors to your image.

Hi Sir,

Yeah, i saw the Indexed Mode check option, but i wasn't sure how it works. So if keep my Color mode in RGB and check the Indexed mode. Do i understand correctly that it takes only colors from the available Palette?


Yes, exactly as you described.

This is so useful and easy to use. Great job!

A noob question. How am I supposed to install it?

(1 edit)

That’s a fair question

  • Download the ZIP file from this page - any version, though the newest is recommended
  • Extract files from the ZIP archive
  • Open the Magic Pencil.aseprite-extension file, extracted from the ZIP archive
  • A window within Aseprite should pop-up asking you to confirm the installation, click Yes (twice if that’s an update)
  • Restart Aseprite
(1 edit)

Thanks! I thought I install it wrong, turned out the menu appear on Edit.

Good stuff. Thank you!

That's just awesome...you're a genius! <3

I said I would live and die for magic pencil and now I get to live that out. Best extension on the web.

Excellent stuff!

This is incredible!

(2 edits) (+1)

amazing, it's the Excalibur.

This is awesome!