{"id":18674878,"url":"https://github.com/kiddae/imagecolorizer","last_synced_at":"2025-10-15T12:25:33.618Z","repository":{"id":54189797,"uuid":"339144835","full_name":"kiddae/ImageColorizer","owner":"kiddae","description":"Make any wallpaper fit any terminal colorscheme.","archived":false,"fork":false,"pushed_at":"2021-10-30T19:06:07.000Z","size":35516,"stargazers_count":103,"open_issues_count":2,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-19T10:37:36.534Z","etag":null,"topics":["colorscheme","image-processing","palette","python","unixporn","wallpaper-generator"],"latest_commit_sha":null,"homepage":"","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/kiddae.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}},"created_at":"2021-02-15T16:54:03.000Z","updated_at":"2025-04-13T22:17:58.000Z","dependencies_parsed_at":"2022-08-13T08:50:15.236Z","dependency_job_id":null,"html_url":"https://github.com/kiddae/ImageColorizer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kiddae/ImageColorizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiddae%2FImageColorizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiddae%2FImageColorizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiddae%2FImageColorizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiddae%2FImageColorizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kiddae","download_url":"https://codeload.github.com/kiddae/ImageColorizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiddae%2FImageColorizer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274412492,"owners_count":25280197,"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","status":"online","status_checked_at":"2025-09-10T02:00:12.551Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["colorscheme","image-processing","palette","python","unixporn","wallpaper-generator"],"created_at":"2024-11-07T09:20:53.477Z","updated_at":"2025-10-15T12:25:28.569Z","avatar_url":"https://github.com/kiddae.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![Image](Demo/demo1.jpg)\n\n\n**`ImageColorizer` is a Python module and a CLI tool** that you can easily use to colorize wallpapers for them to fit a terminal colorscheme.\n\nIt currently supports importing colorschemes from the currently set `Xresources` variables, `pywal` and `colorer` (my [colorscheme management engine](https://github.com/ngynLk/colorer)).\n\n## 📓 How it works\n\nThe module uses two different algorithms: \n+ pixel by pixel (default): goes through each pixel and replaces it with the right color from the colorscheme\n+ average box: calculates the average color of each pixel before processing. This one gives smoother and better results in some cases.\n\nAverage                          | Pixel by pixel\n:-------------------------------:|:-----------------------------:\n![Average](Demo/montage_avg.png) | ![Original](Demo/montage.png)\n\n\n### Usage\n\n```\nusage: ImageColorizer [-h] [-x] [-c COLORSCHEME] [-w] [-p COLOR [COLOR ...]] [-s]\n                      [-b] [--average BOX_SIZE] [--no_quantize]\n                      input output\n\npositional arguments:\n  input                 File to generate image from.\n  output                File to generate image to.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -x, --xresources      Get palette from Xresources.\n  -c COLORSCHEME, --colorer COLORSCHEME\n                        Get palette from colorer.\n  -w, --pywal\n                        Gets palette from pywal.\n  -p COLOR [COLOR ...], --palette COLOR [COLOR ...]\n                        Manually set colors.\n  -s, --show            Show image using xdg-open when image is generated.\n  -b, --blur            Blur the image\n  --average BOX_SIZE    Use average algorithm (calculate the average color of\n                        each pixel with the pixels around) to generate the\n                        wallpaper, and set the size of the box to calculate\n                        the color from\n  --no_quantize         Do not quantize the image before processing (may make\n                        the image look better)\n\n```\n\n### Examples\n\n```shell\nImageColorizer a.jpg output.jpg -x # Generate the wallpaper from colors of the currently used ~/.Xresources or ~/.Xdefaults file\nImageColorizer a.jpg output.jpg -c ~/Configuration/colorschemes/nord # Generate the wallpaper using colorscheme nord from colorer\nImageColorizer a.jpg output.jpg -c ~/Configuration/colorschemes/nord --average 2 # Use average algorithm with box size of 2\nImageColorizer a.jpg output.jpg -c ~/Configuration/colorschemes/nord --average 2 -s # Show image at the end\nImageColorizer a.jpg output.jpg -p \"#3b4252\" \"#bf616a\" \"#a3be8c\" -s # Use these colors.\n```\n\n## 💻 Installation\n\nClone the repo and run `./install.sh` (or `pip3 install .`)\n\n## ✔️ Todo\n\n- [ ] Multi-threading\n- [ ] More colorscheme importing options\n\n## ❎ Troubleshoot\n\nAny common fixes to any errors will be added here.\n\n## 👍 Credits\n\nHeavily inspired by [ImageGoNord](https://github.com/Schrodinger-Hat/ImageGoNord-pip).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiddae%2Fimagecolorizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiddae%2Fimagecolorizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiddae%2Fimagecolorizer/lists"}