pixelsort
What is Pixel Sorting?
Have a look at this post or /r/pixelsorting
Dependencies
Should work in both Python 2 and 3, but Python 3 is recommended.
Usage
From the command line:
pip install pixelsort
python3 -m pixelsort %PathToImage% [options]
Tip: To replicate Kim Asendorf's original processing script, first sort vertically and then horizontally in threshold (default) mode:
python3 -m pixelsort %PathToImage% -a 90
python3 -m pixelsort %PathToSortedImage%
As a package:
>>> from pixelsort import pixelsort
>>> from PIL import Image
>>> a = Image.open("examples/image.jpg")
>>> a
<PIL.JpegImagePlugin.JpegImageFile image mode=RGB size=576x324 at 0x7F8F6A2AC208>
>>> pixelsort(a)
<PIL.Image.Image image mode=RGBA size=576x324 at 0x7F8F66AA57B8>
Parameters:
| Parameter | Flag | Description |
|---|---|---|
| Interval function | -i |
Controls how the intervals used for sorting are defined. See below for more details and examples. Threshold by default. |
| Output path | -o |
Path of output file. Uses the current time for the file name by default. |
| Randomness | -r |
What percentage of intervals not to sort. 0 by default. |
| Threshold (lower) | -t |
How dark must a pixel be to be considered as a 'border' for sorting? Takes values from 0-1. 0.25 by default. Used in edges and threshold modes. |
| Threshold (upper) | -u |
How bright must a pixel be to be considered as a 'border' for sorting? Takes values from 0-1. 0.8 by default. Used in threshold mode. |
| Char. length | -c |
Characteristic length for the random width generator. Used in mode random and waves. |
| Angle | -a |
Angle at which you're pixel sorting in degrees. 0 (horizontal) by default. |
| External interval file | -f |
Image used to define intervals. Must be black and white. |
| Sorting function | -s |
Sorting function to use for sorting the pixels. Lightness by default. |
| Mask | -m |
Image used for masking parts of the image. |
| Logging level | -l |
Level of logging statements made visible. Choices include DEBUG, INFO, WARNING, ERROR, and CRITICAL. WARNING by default. |
Interval Functions
| Interval function | Description |
|---|---|
random |
Randomly generate intervals. Distribution of widths is linear by default. Interval widths can be scaled using char_length. |
edges |
Performs an edge detection, which is used to define intervals. Tweak threshold with threshold. |
threshold |
Intervals defined by lightness thresholds; only pixels with a lightness between the upper and lower thresholds are sorted. |
waves |
Intervals are waves of nearly uniform widths. Control width of waves with char_length. |
file |
Intervals taken from another specified input image. Must be black and white, and the same size as the input image. |
file-edges |
Intevals defined by performing edge detection on the file specified by -f. Must be the same size as the input image. |
none |
Sort whole rows, only stopping at image borders. |
Sorting Functions
| Sorting function | Description |
|---|---|
lightness |
Sort by the lightness of a pixel according to a HSL representation. |
hue |
Sort by the hue of a pixel according to a HSL representation. |
saturation |
Sort by the saturation of a pixel according to a HSL representation. |
intensity |
Sort by the intensity of a pixel, i.e. the sum of all the RGB values. |
minimum |
Sort on the minimum RGB value of a pixel (either the R, G or B). |
Examples
python3 -m pixelsort examples/image.jpg -i random -c 20
python3 -m pixelsort examples/image.jpg -i edges -t .5
file: Intervals taken from image specified with-f. Must be black and white.
python3 -m pixelsort examples/image.jpg -i file -f examples/intervals.png
(generated with elementary-ca)
mask: Mask taken from image specified with-m. Must be black and white.
python3 -m pixelsort examples/image.jpg -i random -c 20 -m examples/mask.png
Todo
- Allow defining different intervals for different channels.
Based on https://gist.github.com/prophetgoddess/667c5554e5d9d9a25ae6
1 maintainer
Release files for pixelsort 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pixelsort-1.0.2.tar.gz | 9.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pixelsort-1.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.7 kB
Release files / pixelsort-1.0.2.tar.gz
| Download URL | pixelsort-1.0.2.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0143f861e501eb6edb758840beb3cb599117de333417a8b37ba8465eefc7fbbe
|
|
BLAKE2b-256 checksum How to use checksums |
b7c2b292db978be0da4bd42088e20326acae4949e3ef68e07eb1274abe5df4b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 3, 2026.
Transparency logRelease files / pixelsort-1.0.2-py3-none-any.whl
| Download URL | pixelsort-1.0.2-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
28ee83a3674fd1e88d5b28ff51a9855fb57b02492e5d7de713e8a2dd2877e7a6
|
|
BLAKE2b-256 checksum How to use checksums |
f9323d88f43e0f1640191316ac1100251c26dee3927d83338df93e3397e979e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 3, 2026.
Transparency log
