{"id":18441548,"url":"https://github.com/zokis/img_to_pixel_art","last_synced_at":"2025-07-12T23:34:01.282Z","repository":{"id":219194378,"uuid":"748424465","full_name":"zokis/img_to_pixel_art","owner":"zokis","description":"Script that transforms any image into pixel art","archived":false,"fork":false,"pushed_at":"2024-01-26T02:35:05.000Z","size":1641,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T19:47:22.950Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zokis.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-25T23:51:44.000Z","updated_at":"2024-02-06T03:15:39.000Z","dependencies_parsed_at":"2024-11-06T06:39:48.861Z","dependency_job_id":"b4aaf3c8-d88a-4489-8b8f-5780e39e58e6","html_url":"https://github.com/zokis/img_to_pixel_art","commit_stats":null,"previous_names":["zokis/img_to_pixel_art"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zokis/img_to_pixel_art","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zokis%2Fimg_to_pixel_art","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zokis%2Fimg_to_pixel_art/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zokis%2Fimg_to_pixel_art/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zokis%2Fimg_to_pixel_art/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zokis","download_url":"https://codeload.github.com/zokis/img_to_pixel_art/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zokis%2Fimg_to_pixel_art/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265068405,"owners_count":23706442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-06T06:38:20.186Z","updated_at":"2025-07-12T23:34:01.006Z","avatar_url":"https://github.com/zokis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# img_to_pixel_art\n\n## Introduction\nThis project contains a Python script that transforms any image into pixel art. The script analyzes the image and determines the best block size for the pixel art based on color homogeneity. It also allows specifying a block size manually. The resulting pixel art image maintains the essential features and colors of the original image, but with a unique pixelated aesthetic.\n\n## Installation\nTo run this script, you need Python installed on your machine. Clone this repository and navigate into the project directory. Then, install the required dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage\nRun the script with the following command:\n\n```bash\npython img_to_pixel_art.py \u003cpath_to_image\u003e\n```\n\nTo specify a block size and the number of colors, use:\n\n```bash\npython img_to_pixel_art.py \u003cpath_to_image --block_size \u003cblock_size\u003e --n_colors \u003cn_colors\u003e\n\n```\n\nReplace \u003cpath_to_image\u003e with the path to your image file and \u003cblock_size\u003e with the desired size of each pixel block (optional).\n\n## Learning Purpose\n\nThis project is intended for educational purposes. It provides a practical example of image processing using Python, demonstrating techniques such as color analysis, multiprocessing, and image manipulation with libraries like NumPy and PIL.\n\n\n## Comparing Results\nTo see the difference between pixel art transformation and conventional resizing methods, compare the three images. The pixel art image will have a distinct, stylized appearance that differs significantly from the smoothly resized image.\n\n### Original\n![Original](vulcao.png \"Original\")\n\n### Pixeled\n![Pixeled](vulcao_6_pixeled.png \"Pixeled\")\n\n### Resized\n![Resized](vulcao_6_resized.png \"Resized\")\n\n### Diff\n![Diff](diff.png \"Diff\")\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzokis%2Fimg_to_pixel_art","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzokis%2Fimg_to_pixel_art","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzokis%2Fimg_to_pixel_art/lists"}