{"id":21011423,"url":"https://github.com/r-cha/recolorcluster","last_synced_at":"2025-03-13T15:47:47.614Z","repository":{"id":104768220,"uuid":"218906990","full_name":"r-cha/ReColorCluster","owner":"r-cha","description":"Recolors an image to the color set you provide.","archived":false,"fork":false,"pushed_at":"2020-07-20T17:18:07.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-20T11:22:59.415Z","etag":null,"topics":["command-line","image-processing","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r-cha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2019-11-01T03:30:37.000Z","updated_at":"2022-05-17T18:44:43.000Z","dependencies_parsed_at":"2023-05-29T17:45:21.131Z","dependency_job_id":null,"html_url":"https://github.com/r-cha/ReColorCluster","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-cha%2FReColorCluster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-cha%2FReColorCluster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-cha%2FReColorCluster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-cha%2FReColorCluster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r-cha","download_url":"https://codeload.github.com/r-cha/ReColorCluster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243438003,"owners_count":20290863,"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":["command-line","image-processing","python"],"created_at":"2024-11-19T09:28:11.351Z","updated_at":"2025-03-13T15:47:47.583Z","avatar_url":"https://github.com/r-cha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# (Re)ColorClusters\n\n## Installation\n\nTo set up a python virtual environment:\n\n```bash\ncd [directory where you cloned this repository]\npython -m venv 'imagecluster'\nsource imagecluster/bin/activate\npip install -r requirements.txt\n```\n\n## Usage\n\n### Prepare image\n\nThis process is nondestructive, so your photo is completely safe!\n\nIf you have an image you like, provide the path to it in the `--infile` argument on the command line. Alternatively, copy and paste the image itself into the directory of this code and rename it `YOUR_IMAGE.JPG`.\n\nTo name change the name or location of the output image, specify the `--outfile` argument on the command line. By default, the image will be saved in the directory of the script under the name `RESULT.PNG`.\n\n### Run script\n\n`python image_cluster.py`\n\nThis will downsample the color space of your image to 4 colors, then recolor it to the Polar Night palette of the [Nord Color Scheme](https://www.nordtheme.com/).\n\n## Customization\n\nTo recolor to different colors,\n\n- specify the `--colorway` argument on the command line. This parameter must match the name of a colorway in `utils.py` (a black image result indicates that the requested colorway is not built-in).\n- specify the `--colorfile` argument on the command line. This parameter must be the filename of a color file, which is a simple file consisting of a list of RGB hex values, including the leading '#' character.\n- specify the `--like` on the command line. This flag expects two arguments; the first is the filename of an image and the second is the number of colors you want to see in the resulting image.\n- specify the `--compress` argument on the command line. This parameter must be an integer. Specifying `--compress K` is identical to specifying `--like \u003cinfile\u003e K`\n\nThese arguments are all mutually exclusive (but not enforced, so mixing them results in undefined behavior!).\n\n## Support\n\nAgain, some of this should be implemented as features but for now is just on the \"Nice To Have\" list... in other words this tool is not under active development. Regardless, let me know if you have any problems.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-cha%2Frecolorcluster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr-cha%2Frecolorcluster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-cha%2Frecolorcluster/lists"}