Overview

Pixora is a lightweight Python library and command-line tool for converting ordinary images into retro-style pixel art. Built on top of Pillow, it provides a simple API for pixelizing images with customizable pixel sizes while supporting both file paths and in-memory objects. Whether you are creating game assets, generating pixelated avatars, or adding a nostalgic visual effect to your images, Pixora offers a fast, and easy-to-use solution for both scripts and terminal workflows.

PyPI Counter
Github Stars

Branch	main	dev
CI

Code Quality

Installation

Source Code

• Download Version 0.3 or Latest Source
• pip install .

PyPI

• Check Python Packaging User Guide
• pip install pixora==0.3

Usage

Library

from pixora import NearestNeighbor, Lanczos
from pixora import pixelize
pixelize("input.png", output="output.png", algorithm=NearestNeighbor(pixel_size=12))
image = pixelize("input.png", algorithm=Lanczos(pixel_size=12), grayscale=True)
image.show()

CLI

pixora input.png output.png

pixora input.png output.png --pixel-size=12

pixora input.png output.png --algorithm="bilinear"

pixora input.png output.png --grayscale

Available Algorithms

The following examples use the same input image with pixel_size=8.

Algorithm	Description	Example
NearestNeighbor	Pixelate using nearest-neighbor resampling
Bilinear	Pixelate using bilinear resampling
Bicubic	Pixelate using bicubic resampling
Lanczos	Pixelate using Lanczos resampling

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

• Please complete the issue template

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.3 - 2026-08-23

Added

• grayscale parameter
• --grayscale CLI argument

Changed

• Opened image bug fixed
• --info CLI argument bug fixed
• --algorithm CLI argument bug fixed
• save method modified
• Pixel size validation bug fixed
• CLI structure modified
• Test system modified
• README.md updated

0.2 - 2026-07-27

Added

• Lanczos algorithm
• Bilinear algorithm
• Bicubic algorithm
• Logo

Changed

• Test system modified
• README.md updated

0.1 - 2026-07-14

Added

• NearestNeighbor algorithm
• pixelize function
• Converter class
• PixoraError class
• PixoraImageError class
• PixoraValidationError class