pixora 0.4

Pixora: A Python Library for Pixel Art Conversion

Overview[](https://pypi.org/project/pixora/#user-content-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[](https://pypi.org/project/pixora/#user-content-installation)

Source Code[](https://pypi.org/project/pixora/#user-content-source-code)

Download Version 0.4 or Latest Source
`pip install .`

PyPI[](https://pypi.org/project/pixora/#user-content-pypi)

Check Python Packaging User Guide
`pip install pixora==0.4`

Usage[](https://pypi.org/project/pixora/#user-content-usage)

Library[](https://pypi.org/project/pixora/#user-content-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[](https://pypi.org/project/pixora/#user-content-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[](https://pypi.org/project/pixora/#user-content-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 | | | MeanBlock | Pixelate by calculating the mean RGB color of each block | | | ModeBlock | Pixelate by replacing each block with its most frequent color | | | MedianBlock | Pixelate by replacing each block with its median RGB color | |

Issues & Bug Reports[](https://pypi.org/project/pixora/#user-content-issues--bug-reports)

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

Please complete the issue template

Show Your Support[](https://pypi.org/project/pixora/#user-content-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[](https://pypi.org/project/pixora/#user-content-changelog)

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

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

Unreleased[](https://pypi.org/project/pixora/#user-content-unreleased)

0.4 \- 2026-10-02[](https://pypi.org/project/pixora/#user-content-04---2026-10-02)

Added[](https://pypi.org/project/pixora/#user-content-added)

`MeanBlock` algorithm
`ModeBlock` algorithm
`MedianBlock` algorithm

Changed[](https://pypi.org/project/pixora/#user-content-changed)

Test system modified
`README.md` updated

0.3 \- 2026-08-23[](https://pypi.org/project/pixora/#user-content-03---2026-08-23)

Added[](https://pypi.org/project/pixora/#user-content-added-1)

`grayscale` parameter
`--grayscale` CLI argument

Changed[](https://pypi.org/project/pixora/#user-content-changed-1)

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[](https://pypi.org/project/pixora/#user-content-02---2026-07-27)

Added[](https://pypi.org/project/pixora/#user-content-added-2)

`Lanczos` algorithm
`Bilinear` algorithm
`Bicubic` algorithm
Logo

Changed[](https://pypi.org/project/pixora/#user-content-changed-2)

Test system modified
`README.md` updated

0.1 \- 2026-07-14[](https://pypi.org/project/pixora/#user-content-01---2026-07-14)

Added[](https://pypi.org/project/pixora/#user-content-added-3)

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

Metadata

Release files for pixora 0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

| Source distribution for pixora 0.4 | File | Size | Uploaded | | | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----------- | ------------------------------------------------------------- | | | pixora-0.4.tar.gz | 16.8 kB | Oct 2, 2026 | Details | |

---

Built distribution (wheel)

| Table of built distributions (wheels) for pixora 0.4 | File | Interpreter | ABI | Platform | Reset | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ----------- | --- | ----------------------------------------------------------------------- | ----------------------------------------------- | | pixora-0.4-py3-none-any.whl 17.1 kB Oct 2, 2026 | Python 3 | none | any | Details | |

---

Total release size: 33.9 kB

Release files/ pixora-0.4.tar.gz

| Download URL | pixora-0.4.tar.gz | | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Size | 16.8 kB | | Tags | Source | | SHA-256 checksum How to use checksums | 131cf0f5c8efabe3a5539eaf1b0ec45bfb94bcacd46f45dac86484f2a337d922 | | BLAKE2b-256 checksum How to use checksums | 7aa0da65bacdbb45fd9e5526485b8dda13ea45f5a4f0a7ad32835c2446e05e12 | | Upload date | Oct 2, 2026 | | Uploaded using Trusted Publishing? What is trusted publishing? | No | | Uploaded via | twine/7.0.0 CPython/3.14.7 |

Release files/ pixora-0.4-py3-none-any.whl

| Download URL | pixora-0.4-py3-none-any.whl | | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Size | 17.1 kB | | Tags | Python 3 | | SHA-256 checksum How to use checksums | 594dbf63ff358af3010c6b1f627cbbf87ef66d55867b850617df857a401c711f | | BLAKE2b-256 checksum How to use checksums | 631ec767c8184e8eb4bf60cce9a38072d13442af777b5fa3c781c51c4140f7e2 | | Upload date | Oct 2, 2026 | | Uploaded using Trusted Publishing? What is trusted publishing? | No | | Uploaded via | twine/7.0.0 CPython/3.14.7 |