Skip to main content

Pixora: A Python Library for Pixel Art Conversion


built with Python3 GitHub repo size PyPI version

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 CodeFactor

Installation

Source Code

PyPI

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))
image.show()

CLI

pixora input.png output.png

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

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

Available Algorithms

Algorithm Description
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.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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pixora-0.2.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pixora-0.2-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file pixora-0.2.tar.gz.

File metadata

  • Download URL: pixora-0.2.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for pixora-0.2.tar.gz
Algorithm Hash digest
SHA256 dc3a12634393201e9a57bc10169f0815477cecd5d88cf2d33cd1042826989646
MD5 15541e07018377977e3b4ca4340f27b7
BLAKE2b-256 63964e9da257a5527716f5ecb036d8c5d288f58d38a70b2a9c688a95cea7f9c1

See more details on using hashes here.

File details

Details for the file pixora-0.2-py3-none-any.whl.

File metadata

  • Download URL: pixora-0.2-py3-none-any.whl
  • Upload date:
  • Size: 13.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for pixora-0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1314542b369f55e7ac75dcb9de4401326c37ef97ffd7b575b39b6a5619c7f483
MD5 6ee5db3b778dbee729761fea01402c47
BLAKE2b-256 d99ad6d033f7600013c7156973d90a6828c85722c358714fa53e17c109eaaf52

See more details on using hashes here.

Release history Release notifications | RSS feed

0.3

2 files

This release

0.2 This release

2 files

0.1

2 files

0.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page