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.


Graffiti - adds an effect of paint drips and specks to the brush. After selecting this option, a slider controlling the effect's strength will appear underneath.

Tool [Outline] - adds an outline around a closed shape that you click on, works with the 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 the 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

  • Selecting colors from the palette while using any option from the Magic Pencil other than GraffitiOutline ToolOutline Brush, or Colorize will interfere with its working and result in odd behavior

See also

PlatformsWindows, macOS, Linux
Rated 4.7 out of 5 stars
(30 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.5 13 kB
Magic Pencil v1.0.4 13 kB
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.

You have produced some absolutely fantastic aseprite plugins man! Love them all, especially this one!

Anyone else getting a console error when trying to use this?

Most likely that’s due to your Aseprite version being too old and not supporting the necessary Lua API. If you’re able to, try updating to at least Aseprite v1.2.30, or best to v1.2.40.

I was looking for a script that finds "islands" separated with empty space on a layer and splits them into layers - but this tool with the "lift" option is just as good!

0.00 usd? omg thank you!!!

Hi! Unfortunately, it's never worked for me. I use the last Steam version.

It was a problem with installing and uninstalling. And the magic pencil had never appeared at the Edit menu. What can I do? Thank you

Some problem adding a pic. It was a screenshot with an error text "cannot open *....* such file or directory"

(3 edits)

I think the cyrillic characters in your path to the user data directory cause this error as Lua cannot resolve the path. 🤔

That would explain why the FX extension doesn’t work as well, but some smaller extensions (that load no additional Lua files) will work correctly.

I think I’ve seen this issue reported before on Windows.

Just to check one other possible cause, do you have an aseprite.ini file in your C:\Program Files (x86)\Steam\steamapps\common\Aseprite directory? This can occure and cause Aseprite to function as a portable version, and install extensions in a different place.

Thank you for the answer!

I don't have aseprite.ini file in that folder, so I think you're right about the cyrillic name of the user's name. I haven't found the safe way to change it, so the most of the extensions don't work at all.

If you message me on Twitter or via e-mail (kac.wozniak[at]gmail.com) I’ll send you a build that should work while I’m figuring out how to tackle this issue. ✌

Hi, just discovered your extension, but it doesn't fit on the screen when UI scaling is > 100%

Hope this is an easy fix! Thank you.

Thank you for reporting this issue. A redesign of the dialog is on the roadmap, this issue should be mitigated in the next update.

Great news. I'll keep my eyes open.

if only some one cued code us a brush who can randomize the colors you know like the once in clip studio paint & photoshop this will be perfect for pixel art the Clipping Masks are different topic

Could you link me an example of how the random color brush works in other software? This one might be doable, depending on the expected behaviour. 🤔

ugh i need a min to find the link . i only know that it works hue and so on https://www.youtube.com/watch?v=HK3CKCIPh44&list=PLzSHl36nXG14_7FWHgV56hivUNGXaNLZp&index=43 in clip studio paint its called Jitter

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!