{"id":34030726,"url":"https://github.com/blotz/pixelsort-cli","last_synced_at":"2026-04-08T12:02:33.314Z","repository":{"id":149900077,"uuid":"622389601","full_name":"Blotz/pixelsort-cli","owner":"Blotz","description":"A simple python command line tool for sort pixels in an image.","archived":false,"fork":false,"pushed_at":"2025-05-29T12:20:36.000Z","size":23780,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-11T19:55:29.239Z","etag":null,"topics":["cli","glitch-art","pixelsort","pixelsorting","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/pixelsort-cli/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Blotz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-02T00:44:02.000Z","updated_at":"2025-08-25T13:57:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"0d31e8ed-90fc-4dc6-8e87-8d69f760e493","html_url":"https://github.com/Blotz/pixelsort-cli","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/Blotz/pixelsort-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blotz%2Fpixelsort-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blotz%2Fpixelsort-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blotz%2Fpixelsort-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blotz%2Fpixelsort-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Blotz","download_url":"https://codeload.github.com/Blotz/pixelsort-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blotz%2Fpixelsort-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31554110,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","glitch-art","pixelsort","pixelsorting","python"],"created_at":"2025-12-13T18:03:18.642Z","updated_at":"2026-04-08T12:02:33.230Z","avatar_url":"https://github.com/Blotz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pixelsort cli\n\n[![tests](https://github.com/Blotz/pixelsort-cli/actions/workflows/python-package.yml/badge.svg)](https://github.com/Blotz/pixelsort-cli/actions/workflows/python-package.yml)\n[![package](https://github.com/Blotz/pixelsort-cli/actions/workflows/python-publish.yml/badge.svg)](https://github.com/Blotz/pixelsort-cli/actions/workflows/python-publish.yml)\n[![CodeQL](https://github.com/Blotz/pixelsort-cli/actions/workflows/codeql.yml/badge.svg)](https://github.com/Blotz/pixelsort-cli/actions/workflows/codeql.yml)\n\nA simple python command line tool for sort pixels in an image.\nBased on the works of [Kim Asendorf](https://github.com/kimasendorf/ASDFPixelSort).\n\nThe script blocks pixels into dark and light areas using a contrast mask.\nThen it sorts the pixels in a given direction via their luminance.\n\n- You can increase/decrease the contrast by setting the threshold.\n- You can also invert the mask to sort the light pixels instead of the dark ones.\n\n## Usage\n\n### Install\n\n```bash\npip install git+https://github.com/Blotz/pixelsort-cli\n```\n\nor\n\n```bash\npip install pixelsort-cli\n```\n\nor\n\n```bash\ngit clone https://github.com/Blotz/pixelsort-cli\ncd pixelsort-cli\npip install .\n```\n\n## Examples\n\n```bash\npixelsort --help\n```\n\n```bash\nusage: pixelsort [-h] [--angle ANGLE] [--image_path IMAGE_PATH] [--threshold THRESHOLD | --template_path TEMPLATE_PATH]\n                 [--sort_brightest SORT_BRIGHTEST] [--reverse_sorting REVERSE_SORTING] [--output OUTPUT] [--verbose | --quiet]\n                 [stdin]\n\nCommand line tool for sorting pixels in images\n\npositional arguments:\n  stdin\n\noptions:\n  -h, --help            show this help message and exit\n  --angle ANGLE         angle that the image is sorted. 0° is up. [0, 360]\n  --image_path IMAGE_PATH\n                        path to image\n  --threshold THRESHOLD\n                        threshold for contrast. [-1.0, 1.0] Default: 1.0\n  --template_path TEMPLATE_PATH\n                        path to template image\n  --sort_brightest SORT_BRIGHTEST\n                        Sort the brightest area of the image. Default: True\n  --reverse_sorting REVERSE_SORTING\n                        Sorts the pixels from lightest to darkest instead of darkest to lightest. Default: False\n  --output OUTPUT       path to output file\n  --verbose             print debug messages\n  --quiet               print less messages\n```\n\n```bash\npixelsort --image_path data/mountains.jpg --threshold 1.2 | display\n```\n\n![example 1](https://raw.githubusercontent.com/Blotz/pixelsort-cli/main/data/example1.png)\n\n```bash\ncat data/mountains.jpg | pixelsort --template_path data/pyramid_mask.png | display\n```\n\n![example 2](https://raw.githubusercontent.com/Blotz/pixelsort-cli/main/data/example2.png)\n\n```bash\npixelsort --image_path data/mountains.jpg --angle 30 --threshold 1.2 --output example.png\n```\n\n![example 3](https://raw.githubusercontent.com/Blotz/pixelsort-cli/main/data/example3.png)\n\nUse it with other tools like imagemagick\n```bash\nmagick data/mountains.jpg -colorspace gray PNG:- | pixelsort | display\n```\n\n![example 4](https://raw.githubusercontent.com/Blotz/pixelsort-cli/main/data/example4.png)\n\n\n---\n\n## License\n\nMIT Ferdinand Theil\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblotz%2Fpixelsort-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblotz%2Fpixelsort-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblotz%2Fpixelsort-cli/lists"}