{"id":28493911,"url":"https://github.com/chickensoft-games/palettepainter","last_synced_at":"2025-07-08T11:30:56.126Z","repository":{"id":264992714,"uuid":"887018291","full_name":"chickensoft-games/PalettePainter","owner":"chickensoft-games","description":"Command-line, general-purpose palette generator for use with pixel art, textures, or art software.","archived":false,"fork":false,"pushed_at":"2025-05-30T20:27:29.000Z","size":70,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-03T16:10:42.103Z","etag":null,"topics":["chickensoft","gamedev","palette","palettes","pixelart"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/Chickensoft.PalettePainter/","language":"C#","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/chickensoft-games.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-11-12T02:52:12.000Z","updated_at":"2025-05-30T20:27:33.000Z","dependencies_parsed_at":"2024-11-27T04:39:26.235Z","dependency_job_id":null,"html_url":"https://github.com/chickensoft-games/PalettePainter","commit_stats":null,"previous_names":["chickensoft-games/palettepainter"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/chickensoft-games/PalettePainter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickensoft-games%2FPalettePainter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickensoft-games%2FPalettePainter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickensoft-games%2FPalettePainter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickensoft-games%2FPalettePainter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chickensoft-games","download_url":"https://codeload.github.com/chickensoft-games/PalettePainter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickensoft-games%2FPalettePainter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264259594,"owners_count":23580840,"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":["chickensoft","gamedev","palette","palettes","pixelart"],"created_at":"2025-06-08T09:37:26.837Z","updated_at":"2025-07-08T11:30:56.119Z","avatar_url":"https://github.com/chickensoft-games.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎨 PalettePainter\n\n[![Chickensoft Badge][chickensoft-badge]][chickensoft-website] [![Discord][discord-badge]][discord]\n\nCommand-line, general-purpose palette generator for use with pixel art, textures, or art software. Palettes are constructed based on the principles described in [Slynyrd][slynyrd]'s seminal blog on [pixel art color palettes][palettes].\n\n---\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Chickensoft.PalettePainter\" src=\"Chickensoft.PalettePainter/icon.png\" width=\"200\"\u003e\n\u003c/p\u003e\n\n## 📦 Installation\n\nThis is a .NET Framework 8 tool written in C#. Once you have .NET installed, you can install this tool globally:\n\n```sh\ndotnet tool install -g Chickensoft.PalettePainter\n\n# Run the tool\npalettepainter generate --help\n```\n\n## 🖼️ Quick Start\n\n```sh\npalettepainter generate palette.png --scale 12\n```\n\n![default palette](doc_assets/default.png)\n\n\u003e [!NOTE]\nThe `--scale` or `-x` parameter controls how large a pixel is. These images were generated with `--scale 12` so that each palette swatch is 12x12 pixels.\n\n## Winter Colors\n\n```sh\npalettepainter generate palette.png --hue 180 --saturation 1 --brightness 1 --num-ramps 8 --hue-shift 0.5 --hue-spectrum 100 --desaturate 0.3 --scale 12\n```\n\n![default palette](doc_assets/winter.png)\n\n## Wooden Colors\n\n```sh\npalettepainter generate palette.png --hue 20 --saturation 1 --brightness 1 --num-ramps 4 --hue-shift 0.1 --hue-spectrum 15 --desaturate 0.6 --scale 12\n```\n\n![default palette](doc_assets/wooden.png)\n\n## Leafy Greens\n\n```sh\npalettepainter generate palette.png --hue 110 --saturation 1  --brightness 1 --num-ramps 6 --hue-shift 0.5 --hue-spectrum 60  --desaturate 0.6 --scale 12\n```\n\n![default palette](doc_assets/leafy_greens.png)\n\n## Tiny Full Spectrum\n\n```sh\npalettepainter generate palette.png --hue 110 --saturation 1  --brightness 1 --num-ramps 4 --num-colors-per-ramp 12 -z 8 --hue-shift 0.5 --hue-spectrum 360  --desaturate 0.3 --scale 12\n```\n\n![default palette](doc_assets/tiny_full_spectrum.png)\n\n...etc!\n\n## 🖥️ Usage Details\n\nPalettePainter is a command-line tool that exposes a number of variables to help you generate the type of general-purpose palette you're looking for. Each of these parameters is described in the help text `palettepainter generate --help`:\n\n```plaintext\nPalette Painter 1.0.0\n  Create a palette of colors with the specified number of ramps. You may\ncustomize hue shifts and saturation levels to create a unique palette.\n\nUSAGE\n  palettepainter generate \u003coutput\u003e [options]\n\nDESCRIPTION\n  Generate a palette of colors.\n\nPARAMETERS\n* output            Palette output image file path\n\nOPTIONS\n  -n|--num-ramps    Number of color ramps to generate Default: \"16\".\n  -c|--num-colors-per-ramp  Number of colors per ramp Default: \"9\".\n  -z|--num-colors-to-trim-for-desaturated-ramp  Number of colors to remove from the ends of the ramp when constructing the desaturated color ramp variant. Default: \"2\".\n  -d|--desaturate   Percentage of saturation to keep when creating a desaturated variant of a color. Default: \"0.30000001192092896\".\n  -x|--scale        Scale factor for the output image (how big a single pixel should be). Default: \"1\".\n  -h|--hue          Starting hue of the middle color in the first ramp. Default: \"0\".\n  -s|--saturation   Percentage of saturation to keep when creating a color. Colors follow the built-in artistic saturation function. This value determines how much of the saturation function to use. Values greater than 1.0 will over-apply the result and can potentially result in color data loss. Default: \"1\".\n  -b|--brightness   Percentage of brightness to keep when creating a color. Colors follow the built-in artistic brightness function. This value determines how much of the brightness function to use. Values greater than 1.0 will over-apply the result and can potentially result in color data loss. Default: \"1\".\n  -m|--hue-shift    How much of the hue spectrum (as a fraction between 0 and 1) should  be covered by a single color ramp. Default: \"0.5\".\n  -u|--hue-spectrum  The amount of the hue spectrum to cover in the palette (0-360). Default: \"360\".\n  -h|--help         Shows help text.\n```\n\n---\n\n🐣 Package generated from a 🐤 Chickensoft Template — \u003chttps://chickensoft.games\u003e\n\n[chickensoft-badge]: https://chickensoft.games/img/badges/chickensoft_badge.svg\n[chickensoft-website]: https://chickensoft.games\n[discord-badge]: https://chickensoft.games/img/badges/discord_badge.svg\n[discord]: https://discord.gg/gSjaPgMmYW\n\n[slynyrd]: https://www.slynyrd.com/pixelblog-catalogue\n[palettes]: https://www.slynyrd.com/blog/2018/1/10/pixelblog-1-color-palettes\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchickensoft-games%2Fpalettepainter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchickensoft-games%2Fpalettepainter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchickensoft-games%2Fpalettepainter/lists"}