Pixelate an image using various methods and conditions.
Note
- Supported image types:
.png
.webp
.jpg
.jpeg
.jpg_large
.bmp
.jfif
.tiff
.tif
.ico
This tool is designed to be used with AI-generated images in the pixel art style. It's common for these images to be generated with mushed colors and/or sloppy pixel shaping. Processing those images with this tool can enhance the pixel art style, and improve image quality.
Add to custom palette list...
- Create a folder named
Palettes
in the same directory as the app. - Place any
PNG
image into thePalettes
folder. - Restart the app and it will scan the
Palettes
folder for new images. - Palettes will appear using their filename in the custom palette drop-down menu.
Tip
You don't need to worry about any requirements with the Windows 💾portable/executable version.
Python requirements...
Python 3.10+
You will need Pillow
, NumPy
, TkinterDnD2
, scikit-learn
, and matplotlib
:
pip install pillow numpy tkinterdnd2 scikit-learn matplotlib
Or use the included requirements.txt
when creating your virtual enviroment.
Click here to view release notes for v1.01
-
New:
Batch Mode
: Allows input/output entries to accept folder paths.- Processes all supported images in subfolders while maintaining folder structure.
- Before and After preview images are now displayed. (When not in Batch mode)
- The Before image also works as a drop target to set the input image path.
- Right-click on the palette in the UI to quickly save the palette image with
Save As...
. - Additional palettes can be used by placing
.PNG
files in aPalettes
folder in the app's parent directory.- Supports up to 256 colors per palette.
Sharpen
Setting: Enhances image sharpness to improve pixel contrast and color.- Sharpen value range: From -100, to 100.
- You can now choose between two color transfer modes:
Normal
andBlend
.Normal
mode assigns each pixel to the nearest color in the palette. (Previous behavior)Blend
mode blends the two nearest colors based on their distance.
- Added
Open
buttons to each input entry to quickly open the selected directory.
-
Fixed:
- Fixed error when processing non-RGB format images. Alpha channels are now preserved.
- Fixed issue where color palettes included colors not present in the input image.
- Unsupported file types can no longer be drag-and-dropped into input fields.
-
Other changes:
- Image processing is ~70% faster (Kmeans/Normal) due to improved pixel-color handling.
- Setting
Image Downscale
to0
, or1
, now disables downscaling. - Palette images are now saved as 1x1 grids, expanding in width.
- Palettes contain only unique colors, sorted by brightness.
- Unfortunately, it's not easy to prevent very similar colors from being included.
- Maximum number of colors changed from 999 to 256.
- Supported image file types now include:
.jfif
,.tiff
,.tif
, and.ico
. - All spinboxes can be adjusted with the mouse-wheel.
- Tooltips now mostly appear when hovering the mouse over label text and not input widgets, reducing their annoyance.
- Numerous small tweaks, fixes, and improvements in both logic and UI.
- The app has been internally restructured and organized.