Skip to main content

Pixora: A Python Library for Pixel Art Conversion

Project description

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
from pixora import pixelize
pixelize("input.png", output="output.png", algorithm=NearestNeighbor(pixel_size=12))
image = pixelize("input.png", algorithm=NearestNeighbor(pixel_size=12))
image.show()

CLI

pixora input.png output.png

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

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.1 - 2026-07-14

Added

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

Project details


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.1.tar.gz (13.0 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.1-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pixora-0.1.tar.gz
Algorithm Hash digest
SHA256 cd48f6f20406c38fe2999e9d02c6e302ff4c9989454c1fb1e00cf046be4565bc
MD5 5f8d9ceff66fbc893403544dfae16f3f
BLAKE2b-256 3a4f8de78e56db170fb5daa0d03e6f3da722cd5110986dcd65181763c59f719f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pixora-0.1-py3-none-any.whl
  • Upload date:
  • Size: 11.2 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5d4e32548a91936b7358fe6cc2b33b7f2f9a2750cb215a0146bc81c4565e2ecb
MD5 fe83a0021cbf57a4e9485f020dc7054e
BLAKE2b-256 9c177ebaa530b2a5846e3b6fa17722964f3d83399b4c08dfbc5e86ea158669ca

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page